Gemini 3.0 Pro Image Preview API 文档

概述

Gemini 3.0 Pro Image Preview 是一款支持：

• 文生图（Text-to-Image）
• 图生图（Image-to-Image）
• 图片编辑（Image Editing）
• 图片理解（Vision）
• 多图融合（Multi-Image Composition）

的多模态模型。

接口兼容 OpenAI Chat Completions API。

Base URL

https://api.yisu.com

认证方式

所有请求均需携带 API Key。

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Chat Completions

Endpoint

POST /v1/chat/completions

请求参数

文生图

请求示例

curl https://api.yisu.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "model":"google/gemini-3-pro-image-preview",
  "messages":[
    {
      "role":"user",
      "content":"生成一只戴着宇航员头盔的橘猫"
    }
  ]
}'

响应示例

{
  "id": "chatcmpl_3ca318e6a156443595445b0fcd45acaa",
  "object": "chat.completion",
  "created": 1779778659,
  "model": "gemini-3-pro-image-preview",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "",
        "refusal": null,
        "annotations": null,
        "images": [
          {
            "type": "image_url",
            "index": 0,
            "image_url": {
              "url": "data:image/jpeg;base64,/9j/4AAQSk..."
            }
          }
        ],
        "reasoning_content": "",
        "function_call": null,
        "tool_calls": null,
        "reasoning_details": []
      },
      "finish_reason": "stop",
      "native_finish_reason": "STOP",
      "logprobs": null
    }
  ],
  "usage": {
    "prompt_tokens": 14,
    "completion_tokens": 1404,
    "total_tokens": 1418,
    "completion_tokens_details": {
      "accepted_prediction_tokens": 0,
      "audio_tokens": 0,
      "image_tokens": 1404,
      "reasoning_tokens": 0,
      "rejected_prediction_tokens": 0
    },
    "prompt_tokens_details": null,
    "cache_creation_input_tokens": null,
    "cache_creation": null,
    "gemini_cache_tokens_details": null
  },
  "system_fingerprint": null,
  "service_tier": null,
  "logprobs": null
}

图片编辑

支持 Base64 图片输入。

请求示例

{
  "model":"google/gemini-3-pro-image-preview",
  "messages":[
    {
      "role":"user",
      "content":[
        {
          "type":"text",
          "text":"给人物添加墨镜"
        },
        {
          "type":"image",
          "image":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
        }
      ]
    }
  ]
}

多图融合

请求示例

{
  "model":"google/gemini-3-pro-image-preview",
  "messages":[
    {
      "role":"user",
      "content":[
        {
          "type":"text",
          "text":"将两张图片中的人物放到同一个场景"
        },
        {
          "type":"image",
          "image":"data:image/png;base64,IMAGE_1"
        },
        {
          "type":"image",
          "image":"data:image/png;base64,IMAGE_2"
        }
      ]
    }
  ]
}

图片理解

请求示例

{
  "model":"google/gemini-3-pro-image-preview",
  "messages":[
    {
      "role":"user",
      "content":[
        {
          "type":"text",
          "text":"分析图片内容"
        },
        {
          "type":"image",
          "image":"data:image/jpeg;base64,/9j/4AAQSk..."
        }
      ]
    }
  ]
}

响应示例

{
  "id":"chatcmpl_vision001",
  "object":"chat.completion",
  "created":1779778659,
  "model":"google/gemini-3-pro-image-preview",
  "choices":[
    {
      "index":0,
      "message":{
        "role":"assistant",
        "content":"图片中是一位站在海边的人，背景是夕阳。",
        "refusal":null,
        "annotations":null,
        "images":[],
        "reasoning_content":"",
        "function_call":null,
        "tool_calls":null,
        "reasoning_details":[]
      },
      "finish_reason":"stop"
    }
  ]
}

图片返回格式

生成图片不会返回公网 URL。

图片数据位于：

choices[0].message.images[]

示例：

{
  "images": [
    {
      "type": "image_url",
      "index": 0,
      "image_url": {
        "url": "data:image/jpeg;base64,/9j/4AAQSk..."
      }
    }
  ]
}

Base64 图片解析

PHP示例

$imageData = $response['choices'][0]['message']['images'][0]['image_url']['url'];
$imageData = preg_replace(
    '#^data:image/\w+;base64,#i',
    '',
    $imageData
);
file_put_contents(
    'output.jpg',
    base64_decode($imageData)
);

Python示例

import base64
image_data = response["choices"][0]["message"]["images"][0]["image_url"]["url"]
image_data = image_data.split(",", 1)[1]
with open("output.jpg", "wb") as f:
    f.write(base64.b64decode(image_data))

流式输出

请求示例

{
  "model":"gemini-3-pro-image-preview",
  "stream":true,
  "messages":[
    {
      "role":"user",
      "content":"生成未来城市夜景"
    }
  ]
}

SSE响应示例

data: {
  "choices":[
    {
      "delta":{
        "content":"正在生成图片..."
      }
    }
  ]
}
data: {
  "choices":[
    {
      "delta":{
        "images":[
          {
            "type":"image_url",
            "image_url":{
              "url":"data:image/jpeg;base64,/9j/4AAQSk..."
            }
          }
        ]
      }
    }
  ]
}
data: [DONE]

Usage

返回示例

{
  "usage": {
    "prompt_tokens": 14,
    "completion_tokens": 1404,
    "total_tokens": 1418,
    "completion_tokens_details": {
      "accepted_prediction_tokens": 0,
      "audio_tokens": 0,
      "image_tokens": 1404,
      "reasoning_tokens": 0,
      "rejected_prediction_tokens": 0
    }
  }
}

字段说明

获取模型列表

Endpoint

GET /v1/models

响应示例

{
  "object":"list",
  "data":[
    {
      "id":"gemini-3-pro-image-preview",
      "object":"model",
      "created":1779778659,
      "owned_by":"google"
    }
  ]
}

错误响应

API Key无效

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

图片格式错误

{
  "error": {
    "message": "Invalid image format.",
    "type": "invalid_request_error",
    "code": "invalid_image"
  }
}

请求频率超限

{
  "error": {
    "message": "Rate limit exceeded.",
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded"
  }
}

支持格式

输入图片

PNG
JPEG
WEBP
GIF

返回图片

data:image/jpeg;base64,...