跳到主要内容

GPT / Gemini · POST /v1/chat/completions · Chat Completions / Gemini 生图兼容路径

POST 
/v1/chat/completions

基本信息​

  • 厂商：OpenAI
  • 模型名称：GPT
  • 默认示例模型：gpt-5.4
  • 兼容接口：/v1/chat/completions

接入说明​

  • 用于兼容旧版 SDK 或历史客户端。
  • 新接入仍优先推荐 POST /v1/responses。

枚举字段更正​

  • reasoning_effort 是枚举值，不是任意字符串。
  • Chat Completions 全局文档可见值：none、minimal、low、medium、high、xhigh。
  • 当前示例模型 gpt-5.1 官方仅支持：none、low、medium、high。
  • response_format.type 是枚举值：text、json_schema、json_object。
  • 对 gpt-5.1，temperature / top_p / logprobs 仅在 reasoning_effort = none 时可用。

鉴权提示​

在线运行面板已预填 Authorization: Bearer sk-xxx。请把环境变量 token 设置为控制台复制的完整 API Key；不要把 Bearer 写进 token 变量。若手动替换整行，请保留 Bearer 前缀。

Gemini 生图兼容路径​

同一个 POST /v1/chat/completions 也可用于 Google Gemini 图片模型的 OpenAI 兼容生图。

  • model：可填 gemini-3-pro-image-preview、gemini-3.1-flash-image-preview。
  • 文生图：messages[].content 可直接传字符串提示词。
  • 图生图：messages[].content 使用数组，包含 type=text 和 type=image_url。
  • 宽高比：extra_body.google.image_config.aspect_ratio。
  • 清晰度：extra_body.google.image_config.image_size。

注意：OpenAI 兼容路径中的 Gemini 图片扩展字段必须使用 snake_case：extra_body.google.image_config.aspect_ratio / extra_body.google.image_config.image_size。camelCase 的 imageConfig、aspectRatio、imageSize 只用于 Gemini 原生 generateContent 路径。

Request​

Responses​

Response Headers