Skip to main content
POST
/
v1
/
chat
/
completions
curl --request POST \
  --url https://code.heihuzi.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-5.5",
    "messages": [
      {
        "role": "user",
        "content": "用一句话说明黑胡子AI便利店的用途"
      }
    ]
  }'
/v1/chat/completions 是兼容接口，用于已经接入 OpenAI Chat Completions 的旧项目、旧 SDK 或只支持 messages 格式的工具。新项目和 Codex 场景优先使用 /v1/responses。 
curl --request POST \
  --url https://code.heihuzi.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-5.5",
    "messages": [
      {
        "role": "user",
        "content": "用一句话说明黑胡子AI便利店的用途"
      }
    ]
  }'

​
Body

​
model
string
required
模型 ID。可用模型以 /v1/models 返回为准。
​
messages
array
required
OpenAI Chat Completions 兼容消息列表。
​
stream
boolean
是否启用流式响应。
​
temperature
number
采样温度。具体支持情况取决于当前渠道和模型。
​
max_tokens
integer
最大输出 token 数。部分模型或渠道可能使用兼容字段映射。

​
Response

返回 OpenAI Chat Completions 兼容结构。该接口主要用于迁移和兼容，不是 Codex / OpenAI 新项目的首选入口。

​
使用边界

  • 主推荐入口是 /v1/responses。
  • 该接口不会提供 Claude Code Messages 协议语义。
  • 如果旧客户端无法切换到 Responses，可以继续使用该兼容入口。