CokeAPI
图像生成系列

Gemini 3 Pro Image

Google Gemini 3 Pro 图像生成模型,更强大的图像生成能力(Nano banana Pro)。

Google

Google Gemini 3 Pro 的图像生成模型(Nano banana Pro),支持文生图、图生图,最多 14 张参考图。

文件上传提示:如需使用参考图片,请先通过 文件上传接口 上传图片获取 URL,再把 URL 放进 image_urls 参数。

调用示例

curl https://cokeapi.com/v1/images/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "一只在京都樱花树下的赛博狐狸,电影质感,Portra 400 胶片",
    "size": "16:9",
    "n": 1
  }'
from openai import OpenAI

client = OpenAI(
    base_url="https://cokeapi.com/v1",
    api_key="sk-xxxxxxxx",
)

img = client.images.generate(
    model="gemini-3-pro-image-preview",
    prompt="一只在京都樱花树下的赛博狐狸,电影质感",
    size="16:9",
    n=1,
)

for d in img.data:
    print(d.url)
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://cokeapi.com/v1",
  apiKey: process.env.COKEAPI_KEY,
});

const img = await client.images.generate({
  model: "gemini-3-pro-image-preview",
  prompt: "一只在京都樱花树下的赛博狐狸,电影质感",
  size: "16:9",
  n: 1,
});

img.data.forEach((d) => console.log(d.url));

请求参数

参数类型必填默认值说明
modelstring固定为 gemini-3-pro-image-preview,别名 nano-banana-pro
promptstring英文 / 中文均可
sizestringauto画面比例:1:1 / 3:2 / 2:3 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9
nint1固定为 1
image_urlsstring[]参考图 URL 列表,最多 14 张
metadataobject元数据参数,见下方说明

metadata 参数

参数类型必填默认值说明
resolutionstring1K输出分辨率,仅支持 1K
orientationstring图像方向:landscape / portrait

响应示例

创建成功后立即返回任务状态,后续通过 异步任务 查询结果:

{
  "id": "img_01HX...",
  "object": "generation.task",
  "status": "queued",
  "progress": 0,
  "model": "gemini-3-pro-image-preview",
  "created_at": 1718000000
}

计费

图片张数 × 单价 扣费,不同分辨率档价格不同:

分辨率档单价 (美元/张)
1K$0.080
2K$0.096
4K$0.128

完整实时价目以 模型列表页 为准,本页价格为 2026-07 快照。失败请求(含上游 502)全额退款,不计费。

错误码

codetype含义HTTP
400101invalid_param参数错误 (尺寸不支持等)400
400401insufficient_balance余额不足400
401104api_key_invalidAPI Key 无效401
429101rate_limit_exceededRPM 超限429
429302daily_quota_exceeded每日调用配额耗尽429
502201upstream_unavailableGemini 服务暂不可用502
502203no_available_account暂无可用账号502

完整列表见 错误码

注意事项

  • CDN 图片 URL 24 小时后失效,需长期保存请下载到自有存储。
  • 失败请求 (含上游 502) 全额返还本次扣费,不计费

本页目录