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.

모델 유형:
가격: Input 80 크레딧/1M, Output 480 크레딧/1M
Type a message to test the model.

생성 예제

gemini-3.1-pro 생성 결과 살펴보기

이 모델로 생성
gemini-3.1-pro guide example 1

gemini-3.1-pro #1

gemini-3.1-pro guide example 2

gemini-3.1-pro #2

gemini-3.1-pro guide example 3

gemini-3.1-pro #3

투명한 가격

gemini-3.1-pro pricing

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

크레딧 충전
Input 80 크레딧/1M, Output 480 크레딧/1M

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.

자주 묻는 질문

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.

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