OpenAI 格式

用标准 OpenAI Chat Completions 协议调用明确声明兼容的文本模型。

POST/v1/chat/completions

标准 OpenAI 请求,使用 model 和 messages。流式响应添加 "stream": true。

可选字段:max_tokens / temperature / top_p / stop。

gemini-3.5-flash 也支持本入口。网关会把 OpenAI 请求转换为 Gemini 原生请求,并将原生 JSON / SSE 响应包装回 OpenAI Chat Completions 格式。它接受 reasoning_effort 的 minimal、low、medium、high;省略时保留模型默认思考配置。该模型不支持 none,并且 reasoning_effort 不能与 extra_body.google.thinking_config.thinking_level 或 thinking_budget 同时使用。其他 Gemini 模型须以 GET /v1/models 返回的 supported_protocols 为准。

通过本入口调用 Gemini 时,user 消息可以使用 OpenAI 多模态内容数组,支持 type: "text" 和 type: "image_url"。网关会安全下载 HTTP(S) 图片 URL 并转换为 Gemini 内联数据,Base64 图片 Data URL 会直接转换为内联数据。Base64 数据必须有效,并使用 Gemini 支持的图片类型(image/jpeg、image/png、image/webp、image/heic 或 image/heif)。单次请求最多 8 张图片,单张图片及解码后的图片数据总量均不超过 20 MiB。不支持的内容 part 类型或图片输入会返回 HTTP 400,不会被静默忽略。

请求示例

curl https://u-token.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-你的KEY" \
  -H "content-type: application/json" \
  -d '{"model":"kimi-k3","max_tokens":256,
       "messages":[{"role":"user","content":"用一句话介绍你自己"}]}'

响应

{
  "choices": [
    {
      "message": { "role": "assistant", "content": "我是一个乐于助人的 AI 助手。" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 12, "completion_tokens": 18, "total_tokens": 30 }
}

响应即 OpenAI 原生结构:choices[0].message.content 是回复,usage 是用量、扣费依据。

如需使用 Responses 原生字段与 SSE 事件,请在所选模型返回 responses_endpoint 时调用 POST /v1/responses;具体字段与工具能力取决于模型及上游。

本页目录

On this page