自定义 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":"你好"}]}'
不确定怎么选时

优先把客户端名称、设置页截图和报错截图发给客服,让客服帮你判断应该选哪一种协议。