API 参考

Chat Completions

迁移现有 Chat Completions 客户端。

Chat Completions 兼容接口

现有 OpenAI Chat Completions 客户端可以保留 messages 结构，只替换 Base URL、Key 和模型。新项目优先使用 Responses API。

POST /v1/chat/completions

最小请求

bash

curl --fail-with-body https://suoxie.codes/v1/chat/completions \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"model":"<MODEL>","messages":[{"role":"user","content":"Reply with OK"}]}'

常用字段

字段	类型	必填	说明
`model`	string	是	当前 Key 的精确模型 ID
`messages`	array	是	至少包含一条用户消息
`stream`	boolean	否	是否使用 SSE 流式输出
`temperature`	number	否	是否支持及有效范围取决于模型
`tools`	array	否	兼容能力取决于模型和上游

成功响应

json

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "model": "<MODEL>",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "OK"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 2,
    "total_tokens": 12
  }
}

兼容响应的附加字段可能因上游而异。基础文本应从 choices[].message.content 读取；流式模式则处理逐段事件，不能按上面的完整 JSON 解析。

从旧客户端迁移

保留现有消息构造代码。
把 Base URL 改为 https://suoxie.codes/v1，不要把完整 /chat/completions 填进只接受 Base URL 的字段。
把 Key 换成本站专用 Key。
用 /v1/models 返回的 ID 替换旧模型名。
先关闭 stream、tools 和非必要参数，成功后逐项恢复。

常见错误

若返回 400，先检查 messages 是否为数组、角色与内容是否合法；401 检查认证；403 检查分组；404 检查 SDK 是否又追加了 /v1；429 读取 Retry-After 并退避。

下一步

新功能逐步迁移到 Responses API。正式切换前用同一输入对比关键业务结果、错误处理和用量记录，而不是要求两个 API 的原始 JSON 完全相同。

Chat Completions 兼容接口 ​

最小请求 ​

常用字段 ​

成功响应 ​

从旧客户端迁移 ​

常见错误 ​