ToAPIs
    homeToAPIs
    ModelsModel PricingAPI Docs
    LoginStart for Free

    Quick Answer

    • Supports prompt-based text-to-image workflows for marketing and creative assets.
    • Supports reference-guided generation for stronger style consistency.
    • Stabilize parameters in this guide first, then move into production API.

    Key Parameters

    • model | string | required | gemini-3.1-pro | - | Exact model identifier from ToAPIs.
    • prompt | string | required | - | - | Primary image instruction prompt.
    • size | string | optional | 1:1 | - | Output aspect ratio, model-dependent.
    • n | integer | optional | 1 | - | Number of generated images per request.
    • reference_images | file[] | optional | - | - | Reference images for style consistency.

    Common Errors

    • 400 invalid_request_error: trigger=Missing or invalid payload fields.; fix=Validate model/prompt/size payload fields.; retry=Retry only after payload fix.
    • 401 authentication_error: trigger=Missing or invalid API key.; fix=Verify Authorization header and key scope.; retry=Retry after authentication fix.

    gemini-3.1-pro

    gemini-3.1-pro by Google (Gemini) is optimized for image generation/editing workflows. Contracts follow ToAPIs docs for production-ready API integration.

    Model Type:
    Pricing: Input 80 credits/1M, Output 480 credits/1M
    PlaygroundSimilarREADMEAPI

    Set chat parameters

    Advanced options

    Example params

    Request preview

    {
      "model": "gemini-3.1-pro",
      "messages": [
        {
          "role": "system",
          "content": "You are a precise, direct AI assistant that is strong at engineering decomposition."
        },
        {
          "role": "user",
          "content": "Use gemini-3.1-pro to break a complex product requirement into actionable engineering tasks."
        }
      ],
      "stream": true,
      "max_tokens": 4096,
      "temperature": 0.7
    }
    View API Docs
    Type a message to test the model.

    Transparent pricing

    gemini-3.1-pro pricing

    Text usage is billed by actual token consumption. Final billing follows the current account quote.

    Top up credits
    Input 80 credits/1M, Output 480 credits/1M

    Why ToAPIs

    Why call gemini-3.1-pro through ToAPIs?

    Keep model access, API keys, billing, and usage management in one workflow.

    High-quality generation

    Generate production-ready visual assets via a unified API.

    Reference consistency

    Use references to stabilize style and composition.

    Parameter tuning

    Tune ratio/count/sampling for quality and cost balance.

    Connect in three steps

    Create a key, send a compatible chat request, and monitor usage.

    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-pro

    Use case 1

    When generating marketing, e-commerce, and social visual assets quickly.

    Use case 2

    When reference-guided consistency is required.

    FAQ

    gemini-3.1-pro FAQ

    What is gemini-3.1-pro best for?

    Best for high-frequency creative generation and reference-guided consistency workflows.

    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.1-pro API

    Start building with gemini-3.1-pro

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

    Start for freeView API Docs

    Try gemini-3.1-pro with one ToAPIs key.

    Use the same account and API surface across supported text models.

    Sign up to get free credits
    ToAPIs
    homeToAPIs

    Enterprise AI API gateway: text, image, video, and audio models behind one interface.

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

    Models

    • Sora 2 API
    • Veo 3.1 API
    • GPT Image 2 API
    • All models

    Alternatives

    • Fal.ai alternative
    • Wavespeed AI alternative
    • PiAPI alternative
    • CometAPI alternative
    • Replicate alternative
    • AIMLAPI alternative

    Resources

    • Docs
    • Service status
    • Pricing
    • Privacy
    • Terms
    • Acceptable Use
    • Data Deletion
    • Data Retention
    • Subprocessors & Regions
    • Billing & Refunds
    • Cookie Policy
    • Sitemap
    • About

    © 2026 ToAPIs. All rights reserved.