自定义 API 客户端通用思路
其他客户端
很多客户端的界面不一样,但接入逻辑几乎一样:找到自定义服务商,选择合适的兼容格式,然后填 Base URL、API Key 和模型名。
通用步骤
确认客户端支持自定义 API
常见入口叫自定义模型、自定义 Provider、API 服务商、OpenAI Compatible 或 Anthropic Compatible。
选择协议格式
Claude 类工具优先选 Anthropic / Claude-compatible;普通聊天工具如果只支持 OpenAI-compatible,再按它的要求配置。
填写三项核心信息
Claude 类 Base URL 填 https://issueacard.top;OpenAI / Codex 类 Base URL 填 https://issueacard.top/v1。API Key 填 sk-你的密钥,模型名先填 gpt-5.5。
保存后做一次小测试
先问一句简单问题,确认能回复后,再开始正式任务。这样更容易判断问题出在配置还是任务本身。
协议怎么选
| 客户端类型 | 优先选择 | 说明 |
|---|---|---|
| Claude Code、OpenClaw、Claude 类工具 | Anthropic Messages / Claude-compatible | 这类工具通常会请求 /v1/messages,Base URL 填根地址即可。 |
| Codex、OpenAI 兼容工具 | OpenAI Responses / OpenAI-compatible | 这类工具通常以 /v1 作为 API 根路径,Codex 详细步骤请看 Codex 客户端教程。 |
| 通用聊天客户端 | 按客户端支持项选择 | 如果只有 OpenAI-compatible,就需要客户端按 OpenAI 格式发请求。 |
| 脚本或 SDK | 看你使用的 SDK | Anthropic SDK 用 Anthropic 格式;OpenAI SDK 用 OpenAI 格式,不要混着填。 |
不要只看模型名
模型名填对只是第一步。客户端发出的接口格式也要匹配,否则可能出现 401、403、404 或请求体格式错误。
Anthropic 兼容测试示例
如果客户端或脚本走 Anthropic Messages 格式,可以参考下面的请求结构。
curl https://issueacard.top/v1/messages \
-H "x-api-key: sk-你的密钥" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"gpt-5.5","max_tokens":256,"messages":[{"role":"user","content":"你好"}]}'
不确定怎么选时
优先把客户端名称、设置页截图和报错截图发给客服,让客服帮你判断应该选哪一种协议。