Chat Completions 接口

本页只说明 OpenAI Chat Completions。模型是否支持该接口、Responses、Anthropic Messages 或图片接口，请先查看接口与模型能力矩阵。

字段参考与可用性以不同来源判断模型是否当前上架、当前 Key 是否可用、以及应使用哪种协议，应以能力矩阵和控制台模型广场为准。

Chat Completions

请求地址：

POST https://nexusapi.link/v1/chat/completions

请求示例：

curl 'https://nexusapi.link/v1/chat/completions' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      {
        "role": "user",
        "content": "你好"
      }
    ]
  }'

请求头

请求头	必填	说明
`Content-Type`	是	固定为 `application/json`
`Authorization`	是	格式为 `Bearer YOUR_API_KEY`

最小字段与流式输出

字段	是否需要	用途
`model`	是	使用当前 Key 可见，且 `supported_endpoint_types` 包含 `openai` 的准确模型 ID
`messages`	是	按 Chat Completions 格式传递会话消息
`stream`	否	`true` 时按流式事件消费；只在所选模型和客户端均支持时使用

普通响应通常从 choices[0].message.content 读取文本；流式响应则逐段读取 choices[0].delta.content。先用本页的非流式最小请求验证模型和 Key，再开启 stream 或添加可选参数。 temperature、工具调用、视觉输入、结构化输出等可选字段并不因“OpenAI 兼容”而对所有模型自动可用；模型的当前支持能力仍以接口与模型能力矩阵及模型广场为准。

常见错误

错误	可能原因
401	API Key 错误、未传 Key 或 Key 已失效
429	请求过快、触发限流或服务暂时繁忙
500/502/503	请求处理暂时失败或服务不可用
524	请求等待时间过长

遇到 status_code=500, not implemented 时，这通常表示模型与请求协议不匹配。先核对该模型的 supported_endpoint_types 是否包含 openai；不包含时，请改用该模型支持的接口说明。遇到其他错误时请保存 Request ID，并参考问题自查。在原因未确认前，请避免短时间内连续高频重试。

开始接入

模型与账单

客户端工具

故障排查

开发者接入

Chat Completions 接口