文档 / API 参考

Chat Completions

主接口，字段与 OpenAI 同构，未列出的字段原样透传给上游。

POST /v1/chat/completions

参数

说明

model

统一 slug，例如 deepseek-v4、claude-sonnet-4.5。

messages

system / user / assistant / tool 四种角色，与官方一致。

stream

布尔值，true 时按 SSE 推送增量。

tools

工具定义数组，支持并行工具调用。

response_format

设为 json_object 或 json_schema 强制结构化输出。

max_tokens

单次最大输出，默认按模型上限。

响应结构

JSON

{
  "id": "chatcmpl-9f2a",
  "model": "deepseek-v4",
  "choices": [{ "index": 0, "message": { "role": "assistant", "content": "..." }, "finish_reason": "stop" }],
  "usage": { "prompt_tokens": 8000, "completion_tokens": 1200, "total_tokens": 9200 }
}

响应头里的 X-Oneapi-Request-Id 与消费日志中的 request id 一致，排查时把它一起发给我们。