Image Generation (Native)

Authorization: Bearer <TOKEN>
Content-Type: application/json

{
  "contents": [
    {
      "parts": [
        { "text": "Text prompt" },
        {
          "inline_data": {
            "mime_type": "image/jpeg",
            "data": "<BASE64_IMAGE_DATA>"
          }
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["image", "text"],
    "imageConfig": {
      "aspectRatio": "1:1",
      "imageSize": "2K"
    }
  }
}

1:1  2:3  3:2  3:4  4:3  4:5  5:4  9:16  16:9  21:9

{
  "contents": [
    {
      "parts": [
        {"text": "Use the composition of the first image and the color tone of the second"},
        {"inline_data": {"mime_type": "image/jpeg", "data": "<BASE64_BASE_IMAGE>"}},
        {"inline_data": {"mime_type": "image/jpeg", "data": "<BASE64_STYLE_IMAGE>"}}
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["image", "text"],
    "imageConfig": {"aspectRatio": "1:1", "imageSize": "2K"}
  }
}

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "<BASE64_IMAGE_DATA>"
            }
          },
          {
            "text": "Optional generated description text"
          }
        ]
      }
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 50,
    "candidatesTokenCount": 100,
    "totalTokenCount": 150
  }
}

{
  "error": {
    "code": 500,
    "message": "no image generated (request id: 20260608235925709515189aBDufjPK)",
    "status": "one_hub_error"
  },
  "usageMetadata": {
    "promptTokenCount": 353,
    "candidatesTokenCount": 0,
    "totalTokenCount": 353,
    "promptTokensDetails": [
      { "modality": "TEXT", "tokenCount": 95 },
      { "modality": "IMAGE", "tokenCount": 258 }
    ]
  }
}