Quick Answer

  • Supports prompt-based image generation with multiple aspect ratios.
  • Supports reference_images for stronger style consistency.
  • Official variants expose richer generation controls for production tuning.

Key Parameters

  • model | string | required | gemini-3-pro-image-preview-vip | - | Exact image model identifier from ToAPIs.
  • prompt | string | required | - | - | Primary image instruction prompt.
  • size | string | optional | 1:1 | 1:1 | 16:9 | 9:16 | 4:3 | 3:4 | 21:9 | Output aspect ratio.
  • resolution | string | optional | 1K | 1K | 2K | 4K(按模型能力) | Output resolution, varies by model variant.
  • reference_images | file[] | optional | - | max 14 | Reference image array for style/composition control.

Common Errors

  • 400 invalid_request_error: trigger=Missing or invalid request payload fields.; fix=Validate model/prompt/size/resolution fields.; retry=Retry only after fixing payload.
  • 401 authentication_error: trigger=Missing or invalid API key.; fix=Verify Authorization header and API key scope.; retry=Retry after auth fix.
  • 429 rate_limit_exceeded: trigger=Request rate, concurrency, or current quota hits upstream rate limiting.; fix=Apply exponential backoff first, then review request rate, concurrency, and quota usage.; retry=Use 1s/2s/4s backoff with jitter; if it persists, reduce submission pressure.

gemini-3-pro-image-preview-vip

gemini-3-pro-image-preview-vip is a Google Gemini image generation model supporting text-to-image and reference-guided image creation, aligned to ToAPIs docs.

モデルタイプ:
料金: 12 クレジット /request
1

画像を説明

参照画像

生成したい画像を説明してください。153 / 1200

詳細オプション

サンプルパラメータ
2

生成結果

画像結果がここに表示されます

ログインすると生成タスクを送信できます。

生成には時間がかかります。しばらくお待ちください。このページを離れても、[ タスクログ ] で生成した内容を直接確認できます。

リクエストをプレビュー

{
  "model": "gemini-3-pro-image-preview-vip",
  "prompt": "Create a premium product advertising image with gemini-3-pro-image-preview-vip: clear subject, natural lighting, polished social-media-ready composition.",
  "size": "1:1",
  "n": 1,
  "metadata": {
    "resolution": "1K",
    "orientation": "square"
  }
}

透明な料金体系

gemini-3-pro-image-preview-vip の料金

Image usage is billed according to the current request and resolution rules. Final billing follows the current account quote.

クレジットを追加
12 クレジット /request

ToAPIs を選ぶ理由

Why call gemini-3-pro-image-preview-vip through ToAPIs?

Keep image generation, API keys, billing, and usage management in one workflow.

High-quality image generation

Generate high-fidelity images via a unified API.

Reference-guided consistency

Use reference_images to stabilize style and composition.

Production tuning controls

Tune resolution, aspect ratio, and sampling for quality/cost balance.

Connect in three steps

Create a key, send an image request, and review the generated result.

  1. 1

    Step 1

    Set Authorization: Bearer <YOUR_API_KEY>.

  2. 2

    Step 2

    Call image generation endpoint with model, prompt, and size.

  3. 3

    Step 3

    Optionally pass reference_images for stronger consistency.

When to use gemini-3-pro-image-preview-vip

Use case 1

When generating marketing/e-commerce/creative image assets at scale.

Use case 2

When using references to stabilize style and iterate prompts quickly.

よくある質問

gemini-3-pro-image-preview-vip FAQ

How should I choose Gemini image variants?

Choose by resolution needs, official vs preview variant, and control parameters; prefer official for production.

Why are reference images not taking effect?

Check reference count/format/size limits and ensure prompt explicitly uses references.

Image or video model error: invalid apitype: -1

This usually means the request was sent to the wrong endpoint. Image and video models typically do not use the chat endpoint. Instead, submit the documented HTTP task request and poll the task status endpoint for results. Check the actual request code, URL, and payload first.

An image or video task failed, but the user was still charged

Ask the user for the task log or screenshot first and check whether input or output token usage appears. If token accounting shows up, the request was likely sent through a chat endpoint instead of the proper media workflow. Image and video models usually run as async HTTP task APIs: submit the task first, then poll by task id according to the relevant docs.

gemini-3-pro-image-preview-vip API

Start building with gemini-3-pro-image-preview-vip

Test an image request here, then continue in the dashboard or API documentation.

Try gemini-3-pro-image-preview-vip with one ToAPIs key.

Use one account and API surface for image generation workflows.

Sign up to get free credits