Chat Completions
OpenAI-compatible Chat Completions 接口。
OpenAI-compatible 入口
Chat Completions 适合存量 OpenAI-compatible 客户端。它使用 Bearer 用户 API Key，并按 OpenAI usage 字段结算。
路径
| 用途 | 方法与路径 |
|---|---|
| 模型调用 | POST /v1/chat/completions |
| 兼容路径 | POST /chat/completions |
| 模型列表 | GET /v1/models、GET /v1/models/、GET /models、GET /models/ |
请求示例
curl https://dingjiai.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_USER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "从 OpenAI Chat 模型列表复制的模型名",
"messages": [
{ "role": "user", "content": "用一句话介绍你自己" }
]
}'流式请求
curl -N https://dingjiai.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_USER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "从 OpenAI Chat 模型列表复制的模型名",
"stream": true,
"messages": [
{ "role": "user", "content": "分三点说明接入流程" }
]
}'网关优先从流式响应里读取上游有效 usage。最终 usage 缺失或无效时，按 token 计费的流式响应只有在网关可提取到模型输出时才会采用保守下界估算；心跳、空事件和原始 chunk 不构成依据。断流、客户端取消或交付失败仍可能按网关已观察到的可信 partial usage 或输出结算，不以客户端成功收到 chunk 为前提。真正空白或畸形的非流式响应会按 usage_missing / usage_invalid 对客失败、释放预留且零扣费。
流式响应在上游返回 2xx 后会先提交响应头。若结束时没有可信 usage 或可提取输出，网关会释放预留、零扣费，并记录失败。客户端仍可能收到 body 为空或只含 SSE keepalive 的 2xx，网关不能再改写成错误体；这与非流式空白或畸形响应的对客结果不同。
请求字段
Prop
Type
usage 与计费
结算读取响应体里的 usage.prompt_tokens、usage.completion_tokens，以及可选的 usage.prompt_tokens_details.cached_tokens。
真实 usage 优先
服务端不会采用客户端自行上报或估算的 token 数。按 token 计费的合法非流式成功 JSON 对象在 usage 缺失或无效时，可按输出估算；没有可提取输出（包括 {}）也最少计 1 个 output token。流式估算必须有网关可提取的模型输出，心跳、空事件和原始 chunk 不构成依据。断流、客户端取消或交付失败仍可能按网关已观察到的可信 partial usage 或输出结算，不以客户端成功收到 chunk 为前提。完整规则见 Usage 与计费。
最后更新于