Google · Image API

Imagen 4.0

imagen-4.0

High-fidelity text-to-image generation for polished marketing and creative visuals.

POST/v1/images/generations

Output count1–1

Reference imagesNot supported

Resolution tiersRoute native

Generation

Generate with Imagen 4.0

Use ImgRouter's unified request contract and this model ID. The example uses recommended defaults from the route's current parameter guide.

cURL

curl https://api.imgrouter.com/v1/images/generations \
  -H "Authorization: Bearer $IMGROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: imagen-4.0-generate-001" \
  -d '{
  "model": "imagen-4.0",
  "prompt": "Editorial product photograph, precise materials, soft studio light",
  "size": "16:9",
  "n": 1
}'

Request body

modelstring · requiredUse imagen-4.0.

promptstring · requiredGeneration or editing instruction between 1 and 5,000 characters.

sizestringSupported values: 1:1, 4:3, 3:4, 16:9, 9:16.

ninteger · 1–1Number of output images. Defaults to 1 and cannot exceed 1.

Controls

Supported options

Aspect ratio or size

1:14:33:416:99:16

Output format

url

Route notes

Text-to-image only; reference images and edit requests are not supported.

One image is returned per request.

Use one of the five documented aspect ratios for predictable framing.

Response

Read the completed output

Successful requests return completed image URLs and a request ID. Store the assets you need permanently; routed output URLs may expire.

200 · application/json

{
  "id": "req_01K4…",
  "object": "image.generation",
  "created": 1787424152,
  "data": [
    { "url": "https://static.imgrouter.com/images/req_01K4.webp" }
  ],
  "usage": { "images": 1 }
}

Use GET /v1/requests/{request_id} for reconciliation and GET /v1/balance for the authenticated key's current Credit position.