Image models
Imagen 4
On this page
Imagen 4 — fast, high-fidelity AI image generation & editing.
| modelId | google-imagen4-fast, google-imagen4-ultra, google-imagen4 |
| Modality | image |
| Pricing | See this model on the Pricing page for the current per-call price (with your markup). |
Operations
| Operation | modelId | Endpoint | Required input |
|---|---|---|---|
| Imagen4 Fast | google-imagen4-fast | POST /api/v1/generate | prompt |
| Imagen4 Ultra | google-imagen4-ultra | POST /api/v1/generate | prompt |
| Imagen4 | google-imagen4 | POST /api/v1/generate | prompt |
| Poll task | — | GET /api/v1/task/{id}?model=google-imagen4-fast | — |
Imagen4 Fast — google-imagen4-fast
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | The text prompt describing what you want to see Max 5000 characters. (default: A single paper origami crane resting on a rain-speckled windowsill at blue hour, soft city-light bokeh glowing beyond the wet glass.) |
| negative_prompt | string | No | A description of what to discourage in the generated images Max 5000 characters. |
| aspect_ratio | string | No | The aspect ratio of the generated image (options: 1:1 | 16:9 | 9:16 | 3:4 | 4:3 | auto) (default: 16:9) |
| seed | number | No | Random seed for reproducible generation |
| nsfw_checker | boolean | No | A configurable parameter. Defaults to true in the Playground. (true/false) (default: true) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"google-imagen4-fast","input":{"prompt":"A photorealistic portrait of a red fox in a snowy forest, soft morning light, shallow depth of field, 85mm.","negative_prompt":"blurry, low quality, distorted, watermark, text","aspect_ratio":"16:9","seed":1,"nsfw_checker":true}}'Imagen4 Ultra — google-imagen4-ultra
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | The text prompt describing what you want to see Max 5000 characters. (default: A master calligrapher poised over a sheet of rice paper, loaded brush touching down in one bold black stroke, ink glistening under warm lamplight, intimate overhead composition with deep shadows and shallow focus.) |
| negative_prompt | string | No | A description of what to discourage in the generated images Max 5000 characters. |
| aspect_ratio | string | No | The aspect ratio of the generated image (options: 1:1 | 16:9 | 9:16 | 3:4 | 4:3 | auto) (default: 1:1) |
| seed | string | No | Random seed for reproducible generation Max 500 characters. |
| nsfw_checker | boolean | No | A configurable parameter. Defaults to true in the Playground. (true/false) (default: true) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"google-imagen4-ultra","input":{"prompt":"A photorealistic portrait of a red fox in a snowy forest, soft morning light, shallow depth of field, 85mm.","negative_prompt":"blurry, low quality, distorted, watermark, text","aspect_ratio":"1:1","seed":"example","nsfw_checker":true}}'Imagen4 — google-imagen4
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | The text prompt describing what you want to see Max 5000 characters. (default: A hand-drawn botanical poster of Thai herbs with neatly labeled sketches, warm paper background.) |
| negative_prompt | string | No | A description of what to discourage in the generated images Max 5000 characters. |
| aspect_ratio | string | No | The aspect ratio of the generated image (options: 1:1 | 16:9 | 9:16 | 3:4 | 4:3 | auto) (default: 1:1) |
| seed | string | No | Random seed for reproducible generation Max 500 characters. |
| nsfw_checker | boolean | No | A configurable parameter. Defaults to true in the Playground. (true/false) (default: true) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"google-imagen4","input":{"prompt":"A photorealistic portrait of a red fox in a snowy forest, soft morning light, shallow depth of field, 85mm.","negative_prompt":"blurry, low quality, distorted, watermark, text","aspect_ratio":"1:1","seed":"example","nsfw_checker":true}}'