创建 OpenAI 兼容对话补全

原始请求与上游响应保持透传语义。

POST/v1/chat/completions

鉴权与权益

positive-balance

入口语境

general-balance

跳到可执行示例

POST /v1/chat/completions 接口

• 方法：POST

• 路径：/v1/chat/completions

• 入口家族：general-balance

• 计费语境：balance

• 调用前置：positive-balance

鉴权

BearerAuth

请求

请求体：application/json

{"$ref":"#/components/schemas/OpenAiChatRequest"}

响应

状态	说明	Schema
200	成功	{"$ref":"#/components/schemas/OpenAiUpstreamResponse"}; {"description":"真实 text/event-stream 字节流；事件集合依上游协议。","type":"string"}
400	本地请求错误或供应商同状态响应	{"oneOf":[{"$ref":"#/components/schemas/OpenAiError"},{"$ref":"#/components/schemas/OpenAiUpstreamResponse"}]}
401	API Key 无效或供应商同状态响应	{"oneOf":[{"$ref":"#/components/schemas/OpenAiError"},{"$ref":"#/components/schemas/OpenAiUpstreamResponse"}]}
402	余额或套餐权益不足或供应商同状态响应	{"oneOf":[{"$ref":"#/components/schemas/OpenAiError"},{"$ref":"#/components/schemas/OpenAiUpstreamResponse"}]}
404	模型不可用或供应商同状态响应	{"oneOf":[{"$ref":"#/components/schemas/OpenAiError"},{"$ref":"#/components/schemas/OpenAiUpstreamResponse"}]}
429	日限额、套餐额度、并发限制或供应商同状态响应	{"oneOf":[{"$ref":"#/components/schemas/OpenAiError"},{"$ref":"#/components/schemas/OpenAiUpstreamResponse"}]}
500	平台内部错误或供应商同状态响应	{"oneOf":[{"$ref":"#/components/schemas/OpenAiError"},{"$ref":"#/components/schemas/OpenAiUpstreamResponse"}]}
502	上游连接异常或供应商同状态响应	{"oneOf":[{"$ref":"#/components/schemas/OpenAiError"},{"$ref":"#/components/schemas/OpenAiUpstreamResponse"}]}
504	上游超时或供应商同状态响应	{"oneOf":[{"$ref":"#/components/schemas/OpenAiError"},{"$ref":"#/components/schemas/OpenAiUpstreamResponse"}]}
default	供应商非 2xx 响应按原协议开放透传	{"$ref":"#/components/schemas/OpenAiUpstreamResponse"}

流式行为

optional-text-event-stream

错误

• invalid_api_key
• model_not_found
• insufficient_balance
• balance_daily_limit_exceeded
• invalid_request_error
• upstream_error
• upstream_timeout
• internal_error

生产接入

生产接入失败处置：模型不可用、权益不足、超时和部分流中断分别需要不同的用户动作；部分流不得无条件重放。

限制

• 受全局请求体上限约束
• 模型上下文与输出限制依当前模型和上游事实而定

兼容性

• inventory:contract-openai-chat-completions
• protocol:openai-compatible

可执行示例

cURL

curl --request POST "${TOKENFACTORY_API_BASE_URL}/v1/chat/completions" --silent --show-error --fail-with-body --max-time 60 --header "Authorization: Bearer ${TOKENFACTORY_API_KEY}" --header "Content-Type: application/json" --data "{\"model\":\"${TOKENFACTORY_MODEL_ID}\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}"