API 接入指南

兼容 OpenAI 的 API 基础地址是 https://dukoai.com/v1。客户端通常会自动追加接口路径，所以不要将 /chat/completions 或 /responses 填进 Base URL。

1. 获取可用模型

以下示例使用环境变量 DUKOAI_API_KEY。先在本机设置该变量，不要将真实密钥提交到代码仓库。

curl https://dukoai.com/v1/models \
  -H "Authorization: Bearer $DUKOAI_API_KEY"

将下面请求里的 MODEL_ID 替换成此密钥返回的模型 ID。模型 ID 需要完整匹配，页面分组名称不能作为模型 ID。

2. Chat Completions 示例

curl https://dukoai.com/v1/chat/completions \
  -H "Authorization: Bearer $DUKOAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"MODEL_ID","messages":[{"role":"user","content":"你好，请简短回复。"}],"max_tokens":64,"stream":false}'

3. Responses 示例

对支持 Responses 的模型可使用以下接口。Codex 使用 Responses，模型权限与能力需要由供货接口支持。

curl https://dukoai.com/v1/responses \
  -H "Authorization: Bearer $DUKOAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"MODEL_ID","input":"Reply only OK.","stream":true}'

4. Anthropic Messages 示例

选择具有 Claude 模型权限的密钥，将模型 ID 换成模型目录中的 Claude 模型。Anthropic 客户端的基础地址通常填写 https://dukoai.com，由客户端追加 /v1/messages。

curl https://dukoai.com/v1/messages \
  -H "x-api-key: $DUKOAI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"CLAUDE_MODEL_ID","max_tokens":64,"messages":[{"role":"user","content":"请简短回复你好。"}]}'

错误排查

• 401：检查密钥是否完整、有效，客户端是否仍使用旧凭据。
• 403：核对模型权限、密钥分组和账户状态。
• 404：检查 API 基础地址、接口路径及模型 ID。
• 429：降低并发并采用有限的退避重试，同时检查请求频率、余额和上游限制；并发上限不等于所有限流都已解除。
• 超时或 5xx：保留请求时间和错误 ID，先测试短请求，避免无上限重试。

查看当前模型目录 · 查看计费说明