ToAPIsToAPIs
Gemini-3-Pro-Image-preview

Gemini-3-Pro 이미지 생성

Generate images using Google Gemini 3 Pro model, with powerful image generation capabilities

POST
/v1/images/generations

중국 본토 사용자 안내: 중국 본토 사용자는 https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.com 을 https://toapis.cn 로 바꿔 주세요.

  • Google Gemini 3 Pro powerful image generation model
  • Use model parameter to select gemini-3-pro-image-preview model
  • Supports text-to-image generation
  • Async task management, query results by task ID

Important Change: For better performance and cost control, we no longer support passing base64 image data directly in image_urls. Please use the Upload 이미지 API first to upload images and get URLs, then call this endpoint.

Authorizations

Authorizationstring헤더필수

All endpoints require Bearer Token authentication

Get your API Key from the API Key Management Page

Add to request header:

Authorization: Bearer YOUR_API_KEY

Body

modelstring본문필수기본값: gemini-3-pro-image-preview

Image generation model name

Example: "gemini-3-pro-image-preview"

promptstring본문필수

Text description for image generation

The upstream model input limit is 65,536 tokens. ToAPIs does not add a 1000-character cap.

sizestring본문

Image generation aspect ratio

Supported formats:

  • Ratios: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
ninteger본문기본값: 1

Number of images to generate

Fixed at 1

⚠️ Note: Must be a pure number (e.g. 1), do not add quotes, otherwise it will error

metadataobject본문

Metadata parameters for passing additional configuration options

Supported metadata fields
resolutionstring본문기본값: 1K

Output image resolution

Supported values:

  • 1K - 1K resolution (default)
  • 2K - 2K resolution
  • 4K - 4K resolution
orientationstring본문

Image orientation

Supported values:

  • landscape - Landscape
  • portrait - Portrait
image_urlsobject[]본문

List of reference image URLs for image-to-image or image editing

Detailed field description
urlstring본문필수

Image URL address

⚠️ URL format only (base64 no longer supported)

  • Publicly accessible image URL (http:// or https://)
  • Example: https://example.com/image.jpg
  • You can use the Upload 이미지 API to upload local images and get URLs

Limitations:

  • Single image must not exceed 10MB
  • Supported formats: .jpeg, .jpg, .png, .webp

Limit: Maximum 6 images

응답

idstring

Unique task identifier for status queries

objectstring

Object type, always generation.task

modelstring

모델 name used

statusstring

Task status

  • queued - Queued for processing
  • in_progress - Processing
  • completed - Successfully completed
  • failed - Failed
progressinteger

Task progress percentage (0-100)

created_atinteger

Task creation timestamp (Unix timestamp)

metadataobject

Task metadata

요청 예시

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "Futuristic city skyline with neon lights",
    "size": "16:9",
    "n": 1,
    "metadata": {
      "resolution": "1K",
      "orientation": "landscape"
    }
  }'
curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "Enhance the colors and details of this city photo",
    "size": "16:9",
    "n": 1,
    "metadata": {
      "resolution": "2K"
    },
    "image_urls": ["https://example.com/city.jpg"]
  }'
import requests

response = requests.post(
    "https://toapis.com/v1/images/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "gemini-3-pro-image-preview",
        "prompt": "Futuristic city skyline with neon lights",
        "size": "16:9",
        "n": 1,
        "metadata": {
            "resolution": "1K",
            "orientation": "landscape"
        }
    }
)

task = response.json()
print(f"Task ID: {task['id']}")
print(f"Status: {task['status']}")
import requests

response = requests.post(
    "https://toapis.com/v1/images/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "gemini-3-pro-image-preview",
        "prompt": "Enhance the colors and details of this city photo",
        "size": "16:9",
        "n": 1,
        "metadata": {
            "resolution": "2K"
        },
        "image_urls": ["https://example.com/city.jpg"]
    }
)

task = response.json()
print(f"Task ID: {task['id']}")
print(f"Status: {task['status']}")
const response = await fetch('https://toapis.com/v1/images/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-ToAPIs-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gemini-3-pro-image-preview',
    prompt: 'Futuristic city skyline with neon lights',
    size: '16:9',
    n: 1,
    metadata: {
      resolution: '1K',
      orientation: 'landscape'
    }
  })
});

const task = await response.json();
console.log(`Task ID: ${task.id}`);
console.log(`Status: ${task.status}`);
const response = await fetch('https://toapis.com/v1/images/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-ToAPIs-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gemini-3-pro-image-preview',
    prompt: 'Enhance the colors and details of this city photo',
    size: '16:9',
    n: 1,
    metadata: {
      resolution: '2K'
    },
    image_urls: ['https://example.com/city.jpg']
  })
});

const task = await response.json();
console.log(`Task ID: ${task.id}`);
console.log(`Status: ${task.status}`);

응답 예시

{
  "id": "task_img_abc123def456",
  "object": "generation.task",
  "model": "gemini-3-pro-image-preview",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}