Chat Completions

POST /v1/chat/completions 接受 OpenAI Chat Completions 格式的请求，当前 默认转发到 DeepSeek OpenAI 兼容上游。

当前 DeepSeek V4 的 messages[].content 必须是文本字符串。图片 image_url、文档、音频和视频输入目前不受支持。网页对话发送结构化图片内容时 会在计费和请求上游前返回 400 / model_input_not_supported。

普通请求

curl https://yijue.ai/v1/chat/completions \
  -H "Authorization: Bearer ${YIJUE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "system", "content": "你是一个简洁的助手。"},
      {"role": "user", "content": "你好"}
    ],
    "max_tokens": 512
  }'

流式请求

用户 API Key 的流式请求必须设置：

{
  "stream": true,
  "stream_options": {
    "include_usage": true
  }
}

完整示例：

curl -N https://yijue.ai/v1/chat/completions \
  -H "Authorization: Bearer ${YIJUE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "从 1 数到 5"}],
    "stream": true,
    "stream_options": {"include_usage": true}
  }'

网关需要最终用量块完成精确结算。缺少 include_usage 时返回：

{
  "error": {
    "type": "invalid_request_error",
    "code": "stream_usage_required"
  }
}

输出上限

OpenAI 格式请求的当前可计费输出上限为 8,192 Token。未提供输出上限或传入 null 时，网关会在转发请求中显式补为 8,192；超过上限时返回 400。

预付费 Chat Completions 当前只允许 n=1。省略 n 即使用该默认值； 传入其他值时返回 400 / invalid_n，并且不会请求上游。

响应与错误

上游成功响应体和 SSE 数据按接收内容返回。网关自身生成的错误使用 OpenAI 风格的 error 对象。

完整的交互式接口结构可查看 API 参考。