APIMODELSAPIMODELS
Docs/Gemini Image API

Gemini Image API

Google Gemini 图片生成系列模型,支持文生图和图片编辑,可灵活控制分辨率和宽高比。

认证

Authorization: Bearer YOUR_API_KEY

模型与价格

模型model价格说明
Gemini 2.5 Flash Imagegemini-2.5-flash-image$0.0200/张标准版
Gemini 3 Pro Imagegemini-3-pro-image$0.08-$0.13/张1K/2K $0.08(比官方便宜40%)、4K $0.13(便宜46%),最高质量
Gemini 3.1 Flash Imagegemini-3.1-flash-image$0.04-$0.10/张GA 正式版,512 $0.04、1K/2K $0.06、4K $0.10
Nanobanana2nanobanana2/gemini-3.1-flash-image-preview$0.05 / 4K $0.081K/2K $0.05,4K $0.08
Nano Banana 2.1nano-banana-2-1$0.022-$0.06/张1K $0.022、2K $0.036、4K $0.06,最多 10 张参考图、15 种比例(参数详见专页)
Nanobanana-2-litenanobanana-2-lite/gemini-3.1-flash-image-preview$0.025文生图 + 图生图(最多 10 张参考图),统一 $0.025,仅 1K
Nanobanana-2-betananobanana-2-beta/gemini-3.1-flash-image-preview$0.05 / 4K $0.081K/2K $0.05,4K $0.08
Nanobananapro-geminigemini-3-pro-image-gemini$0.03/张Gemini 3 Pro,低价通道
Nanobanana2-geminigemini-3.1-flash-image-gemini$0.025/张Gemini 3.1 Flash,低价通道

代码示例

# Step 1: Create task (text-to-image)
curl -X POST https://api.apimodels.app/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "A futuristic cityscape at sunset with flying cars",
    "aspect_ratio": "16:9",
    "resolution": "2k"
  }'

# Image editing with reference image
curl -X POST https://api.apimodels.app/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image",
    "prompt": "Add dramatic storm clouds to the sky",
    "image_url": "https://example.com/photo.jpg",
    "aspect_ratio": "16:9"
  }'

# Step 2: Poll status
curl "https://api.apimodels.app/v1/images/generations?task_id=TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

请求参数

字段必填类型说明
model是stringgemini-2.5-flash-image / gemini-3-pro-image / gemini-3.1-flash-image / gemini-3-pro-image-gemini / gemini-3.1-flash-image-gemini / nanobanana2/gemini-3.1-flash-image-preview / nanobanana-2-lite/gemini-3.1-flash-image-preview / nanobanana-2-beta/gemini-3.1-flash-image-preview
prompt是string图片描述或编辑指令
image_url否string单张参考图片 URL,用于图片编辑
image_urls否string[]多张参考图片 URL 数组,支持多图融合编辑
aspect_ratio否string"auto"(默认)、"1:1"、"16:9"、"9:16"、"4:3"、"3:4"、"3:2"、"2:3"
resolution否string"1k"、"2k"、"4k",分辨率影响价格
callback_url否string任务完成后的回调 URL

说明

  • Pro Lite(97%)和 Pro(99%)成功率和价格不同
  • 分辨率越高价格越贵:1k < 2k < 4k
  • 支持多张参考图片输入(image_url 单张,image_urls 多张数组)
  • Nanobananapro-gemini($0.03/张)和 Nanobanana2-gemini($0.025/张)是低价通道
  • Nano Banana 2.1 有独立文档页(多出 1:4 / 4:1 / 1:8 / 8:1 等比例、参考图最多 10 张):Nano Banana 2.1 API

试一试:Playground

常见问题

有哪些 Gemini 图片模型、多少钱?

Gemini 2.5 Flash Image($0.02)、Gemini 3 Pro Image($0.08-$0.13,低于官方)、Gemini 3.1 Flash Image($0.04-$0.10),以及 $0.025/张起的 Nano Banana 低价通道 —— 一把 Key 全部可调。

Gemini 图片 API 支持多图编辑吗?

支持 —— image_url 传单张、image_urls[] 传多张做融合,并可控 aspect_ratio 和 resolution(1k/2k/4k)。