GPT88 Agent Docs
ImageGoogle3 家上游

gemini-3-pro-image-preview

Google gemini-3-pro-image-preview · IMAGE 模型

在 gpt88.cc 获取 API Key快速开始

模型概览

  • 这是一个图像生成模型，适合把文本提示词转成静态图片或视觉素材。
  • 它属于 Google Gemini 路线，通常更适合多模态理解、图像输入或综合推理任务。
  • 名称中的 flash / mini 变体通常更偏低延迟、高吞吐或轻量任务。

适用场景

  • 需要把文案或提示词转换成图片素材时
  • 做海报、电商主图、品牌概念图或社媒配图时
  • 先用一条最小 prompt 验证输出风格，再扩展到批量生成时

接入说明

  • Google/Gemini 图片模型统一使用图片与多媒体 Base URL https://img.gpt88.cc。
  • 第一次接入时，建议先用 /v1beta/models/gemini-3-pro-image-preview:generateContent 验证 API Key、模型名 gemini-3-pro-image-preview 和当前线路是否匹配。
  • 请求体使用 Gemini 原生 contents / generationConfig 结构，返回图片通常在 inlineData.data 中。
  • 媒体类模型通常先验证上传 / 返回结构，再扩展到正式的素材或媒体管线。

使用提醒

  • flash / mini 变体更适合轻量任务；面对复杂长文档或高质量推理时，可能需要升级到更高阶模型。
  • 该 Google 图片模型使用 generationConfig.imageConfig.aspectRatio 控制画幅比例，支持 16:9 / 1:1 / 21:9 / 2:3 / 3:2 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / auto；不要传 "1024x1024" 这类像素尺寸，清晰度请使用 imageConfig.imageSize，例如 "1K"。
  • 价格、限速、SLA、上下文长度、是否开放多模态等动态值以 gpt88.cc 控制台为准。
  • 如果请求延迟偏高或连接不稳定，请先检查 API Key、模型、endpoint 和请求格式。

能力标签

该模型的能力标签以 gpt88.cc 控制台为准。本页只展示协议字段与请求示例，具体能力 / 推荐场景 / 上下文长度等信息会随上游版本变更，请在 gpt88.cc 控制台 查看实时清单。

推荐场景

该模型的推荐场景以 gpt88.cc 控制台为准。本页只展示协议字段与请求示例，具体能力 / 推荐场景 / 上下文长度等信息会随上游版本变更，请在 gpt88.cc 控制台 查看实时清单。

接口路径

POSThttps://img.gpt88.cc/v1beta/models/gemini-3-pro-image-preview:generateContent

该路径由模型分类决定：Chat / Image / Video / Audio 使用不同 endpoint，同一分类内通常只需要替换 model 字段。

请求需在 Header 中携带 Authorization: Bearer <API_KEY>。 完整字段说明见 图片生成 API 。

API 文档

Endpoint
POST /v1beta/models/gemini-3-pro-image-preview:generateContent
Model ID
gemini-3-pro-image-preview
Content-Type
application/json
接口类型
Gemini 原生图片生成接口，generateContent 返回 inlineData base64 图片
Base URL
Gemini 原生兼容接口使用图片与多媒体 Base URL https://img.gpt88.cc。

Headers / 鉴权

  • Authorizationstring必填
    使用 Bearer <GPT88_API_KEY>。API Key 在 gpt88.cc 控制台创建。
  • Content-Typestring必填
    请求体格式。音频转写上传文件时使用 multipart/form-data。
    默认值：application/json
  • Acceptstring
    非流式接口返回 JSON；Chat 流式请求会返回 SSE 数据流。
    默认值：application/json
  • x-goog-api-keystring
    如果当前中转线路不接受 Authorization: Bearer，可改用该 Header 传 API Key。

请求参数

以下字段按当前模型分类生成。价格、上下文长度、限速、可用线路等动态信息以 gpt88.cc 控制台为准。

  • contentsarray<Content>必填
    Gemini generateContent 输入。文字提示放在 contents[].parts[].text。
  • contents[].parts[].textstring必填
    图片生成提示词，例如主体、风格、比例、细节和限制。
  • contents[].parts[].fileDataobject
    图生图参考图。包含 mimeType 与 fileUri，图片 URL 需要能被服务端访问。
  • generationConfig.responseModalitiesstring[]必填
    要求模型同时返回文本与图片。生成图片时需要包含 IMAGE。
    默认值：["TEXT", "IMAGE"]
  • generationConfig.responseFormat.image.aspectRatiostring
    图片比例，例如 1:1、16:9、9:16、4:3、3:4。
    默认值：1:1
  • generationConfig.responseFormat.image.imageSizestring
    输出清晰度，使用大写，例如 1K、2K、4K。
    默认值：1K
  • modelpath parameter必填
    当前模型 ID 写在路径里：/v1beta/models/gemini-3-pro-image-preview:generateContent。

响应字段

响应结构保持 OpenAI 兼容风格；媒体类模型可能返回异步任务 ID 或资源 URL。

  • candidatesarray<Candidate>必填
    Gemini 返回候选结果数组。
  • candidates[].content.partsarray<Part>必填
    包含文本 part 和图片 part。图片通常在 inlineData.data 中。
  • inlineData.datastring
    base64 编码图片数据，提取后可写入 PNG 文件。
  • usageMetadataobject
    Gemini 风格用量信息；是否返回以实际响应为准。

状态码

  • 200OK必填
    请求成功，响应体结构见上方响应字段。
  • 400Bad Request
    请求字段不合法，例如缺少必填字段、图片尺寸格式错误或文件格式不支持。
  • 401Unauthorized
    API Key 缺失、无效或格式错误。
  • 404Not Found
    Endpoint 或模型不存在。请确认路径为 /v1beta/models/gemini-3-pro-image-preview:generateContent，模型 ID 为 gemini-3-pro-image-preview。
  • 429Rate Limited
    触发限速、并发限制或余额不足。控制台会展示当前账号可用额度。
  • 5xxUpstream Error
    上游或请求异常。保持统一 Base URL 重试，并保留请求 ID 便于排查。

错误与排查

  • 401：检查 Authorization 是否为 Bearer <API_KEY>，以及 Key 是否仍有效。
  • 404：检查 endpoint 是否为 /v1beta/models/gemini-3-pro-image-preview:generateContent，以及模型名 gemini-3-pro-image-preview 是否在控制台可见。
  • 429：触发限速或余额不足时，降低并发、缩短请求，或到控制台查看额度。
  • 5xx：保持统一 Base URL 重试，并记录请求 ID 方便排障。

请求示例

export API_KEY="YOUR_GPT88_API_KEY"
export BASE_URL="https://img.gpt88.cc"
export MODEL="gemini-3-pro-image-preview"

curl -s -X POST \
  "$BASE_URL/v1/models/$MODEL:generateContent" \
  -H "x-goog-api-key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [{
        "text": "Create a cinematic 16:9 cyberpunk city at night with neon lights and rain."
      }]
    }],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "responseFormat": {
        "image": {
          "aspectRatio": "16:9",
          "imageSize": "2K"
        }
      }
    }
  }' > response.json

jq -r '.. | objects | .inlineData?.data? | select(.)' response.json | head -n 1 | base64 -d > output.png

期望响应（精简示例）：

200 OKjson
{
  "candidates": [
    {
      "content": {
        "parts": [
          { "text": "已生成图片。" },
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "iVBORw0KGgoAAA..."
            }
          }
        ]
      }
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 24,
    "totalTokenCount": 88
  }
}