Gemini 图片生成 · OpenAI聊天格式

除 Gemini 原生格式（generateContent 端点）外，也可通过标准的 /v1/chat/completions 端点调用 Gemini 图像生成模型，请求体沿用 OpenAI Chat 格式，通过 extra_body.google.image_config 传递图像专属参数。

接口地址

POST /v1/chat/completions

请求参数

参数	类型	必填	说明
model	string	是	Gemini 图像模型标识
messages[].role	string	是	消息角色，如 user
messages[].content	string	是	图像描述提示词
stream	boolean	否	是否流式返回
extra_body.google.image_config.aspect_ratio	string	是	宽高比，如 1:1、16:9
extra_body.google.image_config.image_size	string	是	图像尺寸档位，如 1K、2K

请求示例

curl https://ai.youqi.tech/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-flash-image",
    "messages": [
      { "role": "user", "content": "一只在星空下奔跑的白色狐狸，写实风格" }
    ],
    "extra_body": {
      "google": {
        "image_config": { "aspect_ratio": "1:1", "image_size": "1K" }
      }
    }
  }'

响应示例

响应结构与标准 聊天（Chat） 接口一致，图像数据包含在 choices[].message.content 中：

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "gemini-2.5-flash-image",
  "created": 1715367049,
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "..." },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 15, "completion_tokens": 0, "total_tokens": 15 }
}

提示

如果客户端已基于标准 Chat 格式集成，可优先使用本接口；若需要更细粒度的图像控制字段，参考 Gemini 原生格式。