ToAPIs
    homeToAPIs
    МоделиЦены моделейДокументация API
    ВойтиНачать бесплатно

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

    • 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.1-flash-image-official | - | 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 | опц. | 1K | 1K | 2K | 4K(按模型能力) | Output resolution, varies by model variant.
    • reference_images | file[] | опц. | - | max 14 | Reference image array for style/composition control.
    • temperature | number | опц. | 0.8 | 0-2 | Sampling temperature for diversity control.
    • topP | number | опц. | 0.95 | 0-1 | Nucleus sampling threshold.

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

    • 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.1-flash-image-official

    gemini-3.1-flash-image-official is a Google Gemini image generation model supporting text-to-image and reference-guided image creation, aligned to ToAPIs docs.

    Тип модели:
    Цена: Input 80 кредитов/1M, Output 480 кредитов/1M
    ПлейграундСвязанные возможностиREADMEAPI
    1

    Опишите изображение

    Референсные изображения

    Опишите изображение, которое хотите создать.154 / 1200

    Расширенные параметры

    Пример параметров
    2

    Результат генерации

    Здесь появится результат изображения

    Войдите, чтобы отправить задачу генерации.

    Открыть API-документациюПолучить API-ключ

    Генерация занимает некоторое время. Подождите.Вы можете покинуть эту страницу. В [ журнале задач ] можно сразу проверить созданный контент.

    Предпросмотр запроса

    {
      "model": "gemini-3.1-flash-image-official",
      "prompt": "Create a premium product advertising image with gemini-3.1-flash-image-official: clear subject, natural lighting, polished social-media-ready composition.",
      "size": "1:1",
      "n": 1,
      "metadata": {
        "temperature": 1,
        "topP": 0.95,
        "resolution": "1K"
      }
    }

    Прозрачные цены

    gemini-3.1-flash-image-official pricing

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

    Пополнить кредиты
    Input 80 кредитов/1M, Output 480 кредитов/1M

    Почему ToAPIs

    Why call gemini-3.1-flash-image-official 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.1-flash-image-official

    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.1-flash-image-official 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 согласно документации.

    gemini-3.1-flash-image-official API

    Start building with gemini-3.1-flash-image-official

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

    Start for freeView API Docs

    Try gemini-3.1-flash-image-official with one ToAPIs key.

    Use one account and API surface for image generation workflows.

    Sign up to get free credits
    ToAPIs
    homeToAPIs

    Корпоративный AI API-шлюз: текстовые, графические, видео и аудиомодели через один интерфейс.

    运营主体:
    鯨樞智能科技有限公司
    JINGSHU INTELLIGENT LIMITED
    注册地址:
    ROOM 5042, 5/F, YAU LEE CENTRE, NO.45, HOI YUEN ROAD, KWUN TONG, KOWLOON, HONG KONG
    联系方式:
    support@toapis.com

    Модели

    • Sora 2 API
    • Veo 3.1 API
    • GPT Image 2 API
    • Все модели

    Альтернативы

    • Альтернатива Fal.ai
    • Альтернатива Wavespeed AI
    • Альтернатива PiAPI
    • Альтернатива CometAPI
    • Альтернатива Replicate
    • Альтернатива AIMLAPI

    Ресурсы

    • Документация
    • Статус сервиса
    • Цены
    • Конфиденциальность
    • Условия
    • Политика использования
    • Удаление данных
    • Хранение данных
    • Субпроцессоры и регионы
    • Оплата и возврат
    • Политика Cookie
    • Карта сайта
    • О нас

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