POST
/
v1beta
/
models
/
{model}
:generateContent
curl -X POST "https://api.applerouter.ai/v1beta/models/gemini-3-pro-image-preview:generateContent/" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{"text": "draw a cat"}]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "4K"
      }
    }
  }'

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Here's a beautiful cat illustration:"
          },
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "base64_encoded_image_data..."
            }
          }
        ]
      },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 10,
    "candidatesTokenCount": 500,
    "totalTokenCount": 510
  }
}

​
Overview

Generate images using Google’s Gemini models via the native API format. Supports text-to-image with configurable aspect ratio and quality settings.
​
model
string
required
Model Name (e.g. gemini-3-pro-image-preview)
​
contents
array
required
Array of content objects containing role and parts
​
generationConfig
object
required
Configuration object including: - responseModalities: Output types (TEXT, IMAGE) - imageConfig: Image settings containing aspectRatio and imageSize - thinkingConfig: Optional Thinking Config
curl -X POST "https://api.applerouter.ai/v1beta/models/gemini-3-pro-image-preview:generateContent/" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{"text": "draw a cat"}]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "4K"
      }
    }
  }'

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Here's a beautiful cat illustration:"
          },
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "base64_encoded_image_data..."
            }
          }
        ]
      },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 10,
    "candidatesTokenCount": 500,
    "totalTokenCount": 510
  }
}

​
With Thinking Output

Enable thinking output to see the model’s reasoning process: 
{
  "contents": [
    {
      "role": "user",
      "parts": [{ "text": "draw a cat" }]
    }
  ],
  "generationConfig": {
    "thinkingConfig": {
      "includeThoughts": true
    },
    "responseModalities": ["TEXT", "IMAGE"],
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "4K"
    }
  }
}

Authorizations

​
Authorization
string
header
required

使用 Bearer Token 认证。格式: Authorization: Bearer sk-xxxxxx

Path Parameters

​
model
string
required

模型名称

Body

application/json
​
contents
object[]
required
​
generationConfig
object
required

Response

200 - application/json

成功

​
candidates
object[]
​
usageMetadata
object