OpenAI Chat Completions API

平台直接兼容 OpenAI 的 Chat Completions API —— POST /v1/chat/completions，官方 SDK 只是把它包了一层。用 SDK 就看OpenAI SDK，自己发 HTTP 请求就看这页。

对话补全

POST /v1/chat/completions —— 补全一段对话。

鉴权是 Authorization: Bearer {API_KEY}。

curl https://api.lk888.ai/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tt-4o",
    "messages": [{ "role": "user", "content": "你好" }],
    "stream": false
  }'

请求参数

• model —— 模型名（必填）
• messages —— 消息数组，每条带 role（system / user / assistant）和 content（必填）
• stream —— 是否流式输出，true 走 SSE，false 返回一次性结果（默认 false）
• temperature —— 0–2（可选）
• max_tokens —— 最大输出 token 数（可选）

响应

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "model": "tt-4o",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": { "role": "assistant", "content": "你好！有什么可以帮助你的？" }
    }
  ],
  "usage": { "prompt_tokens": 8, "completion_tokens": 12, "total_tokens": 20 }
}

• choices[0].message.content —— 回复正文
• usage.prompt_tokens / usage.completion_tokens —— token 用量
• choices[0].finish_reason —— 结束原因

流式

stream: true 返回标准 SSE：每条 data: {json}，结束时发 data: [DONE]。

特别注意

• 错了返回 {"error": {"message": "错误描述", "type": "错误类型"}}；常见状态码：401 密钥无效、402 余额不足、429 请求过多
• 非流式是同步等上游跑完的。推理模型配上大 max_completion_tokens 可能跑过 10 分钟 —— 客户端读超时给到 1800 秒，或者用流式（推荐）。客户端中途断开不影响服务端结算，失败的任务全额退款，但断开后拿不回落了的正文，要正文就用流式边收边存
• 推理模型的 reasoning token 和正文共用同一份预算。max_tokens 给小了会 HTTP 200 但 content 为空、正文全在 reasoning_content 里、finish_reason 是 length —— 这不是报错，是预算被思考吃完了。至少给 2000。usage.completion_tokens 已经含推理 token
• 分组路由由密钥的调度策略决定，请求体里的 channel_group 和请求头 X-Channel-Group 都不改路由
• 这次调用花了多少：响应头 X-Task-Id 是本平台的任务号（流式非流式都带，响应体里的 id 是上游生成的、不能用来查），拿它调 GET /v1/skills/task-status?task_id={X-Task-Id}，is_final = true 时的 cost 就是结算金额