创建对话补全

端点

POST /v1/chat/completions

OpenAI Chat Completions 兼容端点，适用于全部文本模型系列：GPT、Gemini、DeepSeek、Qwen、豆包、GLM、MiniMax、Kimi、Grok（gpt-6.1-sol 推荐使用 Responses），各协议的支持范围见 协议支持的模型。不建议通过本端点调用 Claude：会丢失 prompt cache、thinking 等能力，请改用 创建消息。

请求

请求头

最小请求体：

{
  "model": "gpt-5.6-sol",
  "messages": [
    {"role": "user", "content": "Hello"}
  ]
}

参数

其余字段按 OpenAI Chat Completions API 格式透传，用法以 OpenAI 官方文档为准。

响应

非流式返回 chat.completion 对象：

{
  "object": "chat.completion",
  "model": "gpt-5.6-sol",
  "choices": [
    {"index": 0, "message": {"role": "assistant", "content": "Hello!"}, "finish_reason": "stop"}
  ],
  "usage": {"prompt_tokens": 214, "completion_tokens": 3, "total_tokens": 217}
}

stream 为 true 时返回 data: {...} 分片（object 为 chat.completion.chunk），[DONE] 之前的最后一个分片带 usage（个别线路把 usage 挂在带 finish_reason 的那个分片上，choices 不为空；请在任一分片出现 usage 时读取），详见 流式输出。

示例

本页示例为海外模型（gpt-5.6-sol），地址用国外通道 https://acapi.top；第二个示例为国内模型（deepseek-v4-flash），用国内通道 https://api.acapi.top。两个地址均可用，见 调用地址。

基础请求

curl https://acapi.top/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxx" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

国内模型请求（国内通道）

curl https://api.acapi.top/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxx" \
  -H "content-type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

流式请求

curl https://acapi.top/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxx" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "stream": true,
    "messages": [{"role": "user", "content": "写一句话"}]
  }'

Python SDK

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxx",
    base_url="https://acapi.top/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

错误

关于 max_tokens 与 max_completion_tokens

同一个模型名在不同线路背后可能要求不同的参数名。部分线路上，GPT-5.4 起的部分模型只接受 max_completion_tokens，传 max_tokens 会返回 400；而其它线路两者都接受。

客户端应当这样处理：优先传 max_completion_tokens；若仍报错则回退到 max_tokens。网关本身也会在撞上 400 时自动换参数名重试一次。

body = {"model": model, "messages": msgs, "max_completion_tokens": 4096}
r = post("/v1/chat/completions", body)
# 少数线路只认 max_tokens，撞上就换名重试一次
if r.status == 400 and "max_completion_tokens" in r.text:
    body.pop("max_completion_tokens")
    body["max_tokens"] = 4096
    r = post("/v1/chat/completions", body)

gpt-6 系推理模型的 max_tokens

gpt-6 系（如 gpt-6-sol、gpt-6.1-sol）是推理模型，推理 token 也占输出预算。max_tokens（或 max_completion_tokens）给得太小时，部分线路不会返回截断结果，而是直接 400「output limit reached」。网关遇到这种 400 会自动把输出上限放大（取原值 2 倍与 4096 的较大者，不超过模型上限）重试一次；仍失败才把错误返回给你（中文提示「输出已达到 max_tokens 或模型输出上限…请调大 max_tokens 后重试」）。建议 `max_tokens` ≥ 4096。

GPT-6 系推理模型带 tools

gpt-6-sol、gpt-6.1-sol、gpt-6-luna、gpt-6-astra 与 gpt-5.6 系（gpt-5.6-sol / gpt-5.6-terra / gpt-5.6-luna）自带推理，部分线路在 Chat Completions 上不能同时接受 tools 与推理设置。用本端点带 tools 调用它们时由网关自动处理：网关会自动改走 `/v1/responses`（同一条线路，响应仍按 Chat Completions 格式返回给你），不能改道时 gpt-6-sol 会自动带上 reasoning_effort: "none" 兜底，客户端无需改协议或改模型。`/v1/messages`、`/v1beta` 入口同样生效：在这两个入口带工具调用上述模型，也由网关自动处理。需要完整的推理与工具字段时，建议这些模型直接用 [创建 Responses 响应](/docs/responses)。

参数自动适配

部分推理模型或线路不接受某些参数或取值。遇到下面四种情况，网关会在同一条线路上自动修正后重发一次（同类可连续补救多轮），客户端无需改代码；/v1/chat/completions、/v1/responses、/v1/messages、/v1beta 入口都适用。发生修正时响应头会带 X-CA-Compat，说明改了什么：

• ·补救那一次失败不计费：被上游拒绝的那一次不扣费，修正后的重发也不额外计费，只按最终结果计费。
• ·没有发生修正时不会出现 X-CA-Compat 响应头。
• ·仍建议对推理模型不写采样参数（temperature、top_p 等）：自动适配是兜底，会多一次往返，直接不写更快。

非流式请求超过 30 秒

流式请求如果上游返回 200 却没有任何有效内容（空流），网关在你还没收到任何字节时会自动换一条线路重试一次；仍为空返回 502 empty_response，见 错误码。

客户端读超时（流式也要）

• ·Claude Code：环境变量 API_TIMEOUT_MS=600000（单位毫秒，即 600 秒）。
• ·Codex：~/.codex/config.toml 里本站对应的 [model_providers.<id>] 下写 stream_idle_timeout_ms = 600000。
• ·其它客户端 / SDK：若客户端有超时设置项，调到 ≥300 秒（Claude 系列）；其它模型 ≥150 秒。注意部分客户端该项单位是毫秒（300 秒 = 300000）。