ToAPIs

Краткий вывод

  • 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.

Ключевые параметры

  • model | string | обяз. | gemini-3-pro-image-preview-4k | - | Exact image model identifier from ToAPIs.
  • prompt | string | обяз. | - | - | Primary image instruction prompt.
  • size | string | опц. | 1:1 | 1:1 | 16:9 | 9:16 | 4:3 | 3:4 | 21:9 | Output aspect ratio.
  • resolution | string | опц. | 4K | 4K | Output resolution, varies by model variant.
  • reference_images | file[] | опц. | - | max 14 | Reference image array for style/composition control.

Частые ошибки

  • 400 invalid_request_error: триггер=Missing or invalid request payload fields.; исправление=Validate model/prompt/size/resolution fields.; повтор=Retry only after fixing payload.
  • 401 authentication_error: триггер=Missing or invalid API key.; исправление=Verify Authorization header and API key scope.; повтор=Retry after auth fix.
  • 429 rate_limit_exceeded: триггер=Request rate, concurrency, or current quota hits upstream rate limiting.; исправление=Apply exponential backoff first, then review request rate, concurrency, and quota usage.; повтор=Use 1s/2s/4s backoff with jitter; if it persists, reduce submission pressure.
Назад к рынку моделей

Разбор модели

Gemini 3 Pro Image Preview 4K

Model ID: gemini-3-pro-image-preview-4k

Вендор: Google (Gemini)Модальности: VideoЦена: Input $0.00/1M, Output $0.00/1MОбновлено: 2026-05-02

Gemini 3 Pro Image Preview 4K is a Google Gemini image generation model supporting text-to-image and reference-guided image creation, aligned to ToAPIs docs.

Открыть в PlaygroundДокументация

Обзор модели

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.

Gemini 3 Pro Image Preview 4K Возможности модели

Ключевой блок

Ключевые возможности и практическая ценность

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.

Как использовать API Gemini 3 Pro Image Preview 4K

  1. Set Authorization: Bearer <YOUR_API_KEY>.
  2. Call image generation endpoint with model, prompt, and size.
  3. Optionally pass reference_images for stronger consistency.
  4. Poll task status and download result image URLs.
Gemini 3 Pro Image Preview 4K sample image 1

Когда использовать

  • When generating marketing/e-commerce/creative image assets at scale.
  • When using references to stabilize style and iterate prompts quickly.

Особенности работы API

  • Uses a unified image generation endpoint with task-style responses.
  • Supports reference image inputs with count/size constraints.
  • Resolution and aspect-ratio support vary by Gemini image variant.
Gemini 3 Pro Image Preview 4K sample image 2

Key Parameters

ParameterTypeRequiredDefaultRangeDescription
modelstringYesgemini-3-pro-image-preview-4k-Exact image model identifier from ToAPIs.
promptstringYes--Primary image instruction prompt.
sizestringNo1:11:1 | 16:9 | 9:16 | 4:3 | 3:4 | 21:9Output aspect ratio.
resolutionstringNo4K4KOutput resolution, varies by model variant.
reference_imagesfile[]No-max 14Reference 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 4K sample image 3

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.

Ошибка у модели изображений или видео: invalid apitype: -1

Обычно это означает, что запрос отправлен не в тот endpoint. Модели изображений и видео обычно не используют chat endpoint. Вместо этого нужно отправлять HTTP-запрос на создание задачи по документации и затем опрашивать endpoint статуса задачи. Сначала проверьте фактический код запроса, URL и payload.

Задача на генерацию изображения или видео завершилась ошибкой, но списание произошло

Сначала попросите у пользователя лог задачи или скриншот и проверьте, есть ли там статистика входных или выходных токенов. Если учет токенов есть, запрос, скорее всего, был отправлен через chat endpoint, а не через правильный media workflow. Модели изображений и видео обычно работают как асинхронные HTTP task API: сначала отправляется задача, затем выполняется опрос по task id согласно документации.

Mode Notes

Text to Image with Gemini 3 Pro Image Preview 4K

Generate images directly from prompt instructions.

Mode Parameters

modelpromptsizeresolution

Best Scenarios

  • Product key visuals
  • Ad creatives
  • Concept art

Reference-guided Image with Gemini 3 Pro Image Preview 4K

Generate style-consistent images from references.

Mode Parameters

reference_imagespromptsizeresolution

Best Scenarios

  • Brand consistency
  • Character consistency
  • Series posters

Related APIs

Готовы начать?

Зарегистрируйтесь бесплатно и испытайте мощь корпоративного API-шлюза для ИИ

Начать бесплатноПосмотреть цены
ToAPIs

Корпоративный шлюз AI API. Доступ к GPT-5, Claude, Gemini и 50+ моделям через единый API.

Компания

Правовая информация

© 2026 ToAPIs. Все права защищены.

Все системы работают