创建 Coding Plan OpenAI 对话补全

只进入 Coding Plan 套餐代理链。

POST/v1/coding/chat/completions

鉴权与权益

active-coding-plan

入口语境

coding-plan

跳到可执行示例

POST /v1/coding/chat/completions 接口

• 方法：POST

• 路径：/v1/coding/chat/completions

• 入口家族：coding-plan

• 计费语境：coding-plan

• 调用前置：active-coding-plan

鉴权

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"}]}
413	请求超过输入字节上限或供应商同状态响应	{"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_package
• package_expired
• model_not_in_package
• package_5h_quota_exhausted
• package_weekly_quota_exhausted
• package_concurrency_limited
• package_input_too_large
• package_output_limit_exceeded
• invalid_request_error
• upstream_error
• upstream_timeout
• internal_error

生产接入

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

限制

• 受全局请求体上限约束
• Coding Plan 权益、并发与模型限制按当前套餐事实执行

兼容性

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

可执行示例

cURL

curl --request POST "${TOKENFACTORY_API_BASE_URL}/v1/coding/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\":\"你好\"}]}"