Gemini 3 Pro Image 怎么用？材质光影控制与 images API 调用

gemini-3-pro-image 走 /v1/images/generations，按次计费。

模型 ID: gemini-3-pro-image
端点: POST /v1/images/generations
尺寸: 1024x1024，另有 2K/4K 变体
适配: OpenAI SDK / curl
计费: 按次

参数	值
模型 ID	`gemini-3-pro-image`
类型	生图
调用端点	`POST /v1/images/generations`
兼容协议	OpenAI Images API
推荐客户端	OpenAI Python SDK、curl
计费方式	按次，实时价格见定价页

Gemini 3 Pro Image 适合做什么，不适合做什么？

适合长描述生图、工业设计渲染和复杂材质光影。

gemini-3-pro-image 结合了 Google 的多模态理解能力，能准确理解很长的自然语言描述，对复杂光影和反射材质的还原度高。

适合的场景：

产品、工业设计的质感渲染
包含多个元素和空间关系的复杂场景
玻璃、金属等反射材质的表现

不太适合：图中需要大段清晰文字的海报，可选 gpt-image-2。

gemini-3-pro-image 的 Base URL 和 API Key 怎么获取？

Base URL 填 deepclub.net/v1，Key 在控制台创建。

登录深云 DeepClub，进入控制台的 API 令牌 页面。
点击 添加令牌，复制生成的 sk- 开头密钥。
在客户端或代码中填写以下三项：

Base URL: https://deepclub.net/v1
API Key:  sk-你的DeepClub密钥
Model:    gemini-3-pro-image

怎么用 Python 调用 gemini-3-pro-image 生成图片？

用 client.images.generate，model 填模型 ID。

import base64
from openai import OpenAI

client = OpenAI(api_key="sk-你的DeepClub密钥", base_url="https://deepclub.net/v1")

result = client.images.generate(
    model="gemini-3-pro-image",
    prompt="一只磨砂铝合金机身的无线耳机，置于黑色大理石台面，柔和侧光",
    size="1024x1024",
)

image = result.data[0]
if image.b64_json:
    with open("output.png", "wb") as f:
        f.write(base64.b64decode(image.b64_json))
else:
    print(image.url)

返回结果可能是 base64 数据（b64_json）或图片链接（url），上面的代码两种都处理了。

用 curl 怎么调用 gemini-3-pro-image？

POST 到 /v1/images/generations，传三个字段。

curl https://deepclub.net/v1/images/generations \
  -H "Authorization: Bearer $DEEPCLUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gemini-3-pro-image", "prompt": "一只磨砂铝合金机身的无线耳机，置于黑色大理石台面，柔和侧光", "size": "1024x1024"}'

gemini-3-pro-image 支持哪些图片尺寸？

默认 1024x1024，另有 2K 和 4K 变体可选。

2K、4K 变体按独立的模型条目计费，具体模型名和价格见定价页。尺寸越大单次价格越高，建议先用 1024x1024 确认构图。

Gemini 3 Pro Image 的长提示词怎么写？

按主体、材质、构图、光线、风格分句描述。

例如：主体是一台复古胶片相机；机身为黄铜与黑色皮革；三分之二侧面视角，浅景深；左上方暖色主光，右侧冷色补光；商业产品摄影风格。

每句只描述一个维度，模型更容易逐项满足。

gemini-3-pro-image API 怎么计费？

按次计费，每成功生成一次计一次。

实时价格见定价页。

计费单位：按次，价格可能调整，以定价页实时显示为准。
用量明细：在控制台 使用日志 中按请求查看消耗。
充值方式：支持 PayPal、Visa/Mastercard、支付宝。

调用 gemini-3-pro-image 报 401 怎么办？

401 表示密钥无效或缺失，先检查 Key 是否完整。

确认 API Key 前后没有空格或换行，且令牌未被禁用、未过期。
请求头格式为 Authorization: Bearer sk-...。
如果返回 404，检查 Base URL 是否为 https://deepclub.net/v1，模型名是否为 gemini-3-pro-image。

用 gemini-3-pro-image 时请求内容会被存储或用于训练吗？

不会，深云 DeepClub 实行零留存（ZDR）政策。

深云 DeepClub 实行 Zero Data Retention (ZDR) 零留存政策：请求的输入和输出内容不做持久化存储，也不会用于模型训练，详见隐私政策。

使用 Gemini 3 Pro Image 还有哪些常见问题？

以下问答汇总了调用时最常见的问题。

调用 gemini-3-pro-image 返回 401 Unauthorized 怎么办？

401 表示密钥无效或缺失，先检查 API Key 是否复制完整、前后没有空格。请求头格式为 Authorization: Bearer sk-...。

gemini-3-pro-image 用哪个接口生成图片？

用 POST /v1/images/generations，兼容 OpenAI Images API，可直接调用 OpenAI SDK 的 client.images.generate。

gemini-3-pro-image API 怎么计费？

按次计费，每成功生成一次计一次。实时价格见 https://deepclub.net/pricing/gemini-3-pro-image。

Gemini 3 Pro Image 的长提示词怎么写？

按主体、材质、构图、光线、风格分句描述。

常见问题

调用 gemini-3-pro-image 返回 401 Unauthorized 怎么办？: 401 表示密钥无效或缺失，先检查 API Key 是否复制完整、前后没有空格。请求头格式为 Authorization: Bearer sk-...。
gemini-3-pro-image 用哪个接口生成图片？: 用 POST /v1/images/generations，兼容 OpenAI Images API，可直接调用 OpenAI SDK 的 client.images.generate。
gemini-3-pro-image API 怎么计费？: 按次计费，每成功生成一次计一次。实时价格见 https://deepclub.net/pricing/gemini-3-pro-image。
Gemini 3 Pro Image 的长提示词怎么写？: 按主体、材质、构图、光线、风格分句描述。

更新于 2026-10-31