Imagen 4 Fast
Imagen 4 Fast is a latency optimized text to image model in the Imagen 4 family. It targets interactive apps and high volume pipelines. It keeps strong Imagen 4 visual quality while cutting generation time, so teams can iterate faster and reduce serving costs in production.
API Options
Platform-level options for task execution and delivery.
-
taskType
string required value: imageInference -
Identifier for the type of task being performed
-
taskUUID
string required UUID v4 -
UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.
-
outputType
string default: URL -
Image output type.
Allowed values 3 values
-
outputFormat
string default: JPG -
Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities.
- `JPG`: Best for photorealistic images with smaller file sizes (no transparency).
- `PNG`: Lossless compression, supports high quality and transparency (alpha channel).
- `WEBP`: Modern format providing superior compression and transparency support.
**Transparency**: If you are using features like background removal or LayerDiffuse that require transparency, you must select a format that supports an alpha channel (e.g., `PNG`, `WEBP`, `TIFF`). `JPG` does not support transparency.Allowed values 3 values
-
outputQuality
integer min: 20 max: 99 default: 95 -
Compression quality of the output. Higher values preserve quality but increase file size.
-
webhookURL
string URI -
Specifies a webhook URL where JSON responses will be sent via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.
Learn more 1 resource
- Webhooks PLATFORM
- Webhooks
-
deliveryMethod
string default: sync -
Determines how the API delivers task results.
Allowed values 2 values
- Returns complete results directly in the API response.
- Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.
Learn more 1 resource
- Task Polling PLATFORM
-
uploadEndpoint
string URI -
Specifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials.
Common use cases:
- Cloud storage: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs.
- CDN integration: Upload to content delivery networks for immediate distribution.
// S3 presigned URL for secure upload https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600 // Google Cloud Storage presigned URL https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789 // Custom storage endpoint https://storage.example.com/uploads/generated-image.jpgThe content data will be sent as the request body to the specified URL when generation is complete.
-
safety
object -
Content safety checking configuration for image generation.
Properties 2 properties
-
safety»checkContentcheckContent
boolean default: false -
Enable or disable content safety checking. When enabled, defaults to
fastmode.
-
safety»modemode
string default: none -
Safety checking mode for image generation.
Allowed values 2 values
- Disables checking.
- Performs a single check.
-
-
ttl
integer min: 60 -
Time-to-live (TTL) in seconds for generated content. Only applies when
outputTypeisURL.
-
includeCost
boolean default: false -
Include task cost in the response.
-
numberResults
integer min: 1 max: 20 default: 1 -
Number of results to generate. Each result uses a different seed, producing variations of the same parameters.
Generation Parameters
Core parameters for controlling the generated content.
-
model
string required value: google:2@3 -
Identifier of the model to use for generation.
Learn more 3 resources
-
positivePrompt
string required min: 2 max: 3000 -
Text prompt describing elements to include in the generated output.
Learn more 2 resources
-
Width of the generated media in pixels.
Learn more 2 resources
-
Height of the generated media in pixels.
Learn more 2 resources
Flooded Cathedral Transit Hall
{
"taskType": "imageInference",
"taskUUID": "7c28b0f9-2464-4e88-b21e-b29e455a5fe6",
"model": "google:2@3",
"positivePrompt": "A vast abandoned railway terminal redesigned inside a soaring gothic cathedral nave, ankle-deep clear floodwater across polished stone floors, commuters wading between brass luggage carts and floating paper lanterns, colossal ribbed vaults overhead, stained glass casting fractured amber, teal, and crimson reflections across the water, a suspended arrival board with partially missing letters, distant platform arches disappearing into mist, swallows circling near the ceiling, bundles of wild reeds growing through cracked tiles, one sleek silver train standing still like a relic, cinematic wide shot, intricate environmental storytelling, ultra-detailed textures, atmospheric depth, realistic lighting, sharp focus, majestic scale, vivid but natural color grading",
"width": 1408,
"height": 768
}{
"taskType": "imageInference",
"taskUUID": "7c28b0f9-2464-4e88-b21e-b29e455a5fe6",
"imageUUID": "8978d335-5674-4a7d-b15a-e439d9265a2d",
"imageURL": "https://im.runware.ai/image/os/a12d13/ws/2/ii/8978d335-5674-4a7d-b15a-e439d9265a2d.jpg",
"seed": 1348345038,
"cost": 0.02
}Wind-Carved Desert Caravanserai
{
"taskType": "imageInference",
"taskUUID": "9d983fa3-1624-4d66-9501-6a5a5b2c7cfb",
"model": "google:2@3",
"positivePrompt": "A vast desert caravanserai built inside the ribbed remains of an ancient fossilized sea creature, half-buried in sweeping amber dunes; weathered sandstone arches, woven shade canopies, suspended brass lanterns, tethered pack animals, traders in layered textiles, ceramic jars, rolled carpets, and carved wooden chests scattered through a bustling courtyard. In the distance, tall wind-shaped rock spires and a pale turquoise dry basin shimmer under a bright late-afternoon sky with streaky clouds. Fine airborne dust catches warm sunlight, creating soft volumetric haze and long elegant shadows. Ultra-detailed materials, intricate textures, believable human scale, dynamic composition, wide cinematic framing, realistic lighting, sharp focus, richly colored yet natural palette, immersive worldbuilding, premium travel photography aesthetic.",
"width": 1408,
"height": 768
}{
"taskType": "imageInference",
"taskUUID": "9d983fa3-1624-4d66-9501-6a5a5b2c7cfb",
"imageUUID": "51c84c45-1760-42f8-a723-19ba3a00a9f9",
"imageURL": "https://im.runware.ai/image/os/a07d11/ws/2/ii/51c84c45-1760-42f8-a723-19ba3a00a9f9.jpg",
"seed": 1943620252,
"cost": 0.02
}Subterranean Glass Orchard Concourse
{
"taskType": "imageInference",
"taskUUID": "29a8aa01-b80c-4643-abea-db27589c7c38",
"model": "google:2@3",
"positivePrompt": "A vast underground transit concourse transformed into a thriving glass-roofed orchard, terraced citrus trees and hanging vines growing between elegant stone platforms and sleek commuter walkways, travelers carrying lacquered suitcases and baskets of fruit, polished brass railings, patterned tile floors, shafts of warm daylight filtering through cracked crystal panels in the ceiling, drifting dust, distant arrival boards, shallow reflective water channels, subtle steam from vents, highly detailed environmental storytelling, cinematic wide shot, intricate textures, believable scale, crisp focus, natural color harmony, premium commercial photography look",
"width": 1408,
"height": 768
}{
"taskType": "imageInference",
"taskUUID": "29a8aa01-b80c-4643-abea-db27589c7c38",
"imageUUID": "2df0ca74-e3eb-444f-aafa-44b01fd6f433",
"imageURL": "https://im.runware.ai/image/os/a20d05/ws/2/ii/2df0ca74-e3eb-444f-aafa-44b01fd6f433.jpg",
"seed": 1855629850,
"cost": 0.02
}Rainy Tram Depot Reverie
{
"taskType": "imageInference",
"taskUUID": "b20a1b78-235b-40f7-aa12-29fadd35d91c",
"model": "google:2@3",
"positivePrompt": "A vast early-morning tram depot inside a century-old iron-and-glass transit hall during a spring downpour, polished rails and puddled stone flooring reflecting warm amber station lamps, several vintage trams in faded saffron, moss green, and oxblood red lined up beneath hanging route placards, mechanics in waterproof coats checking cables and wheels, a florist's abandoned handcart spilling peonies and ferns near a bench, flocks of swallows circling under the arched roof, steam rising from vents, distant city towers softened by rain through towering windows, cinematic depth, intricate architectural detail, realistic materials, expressive weather, balanced composition, crisp focus, natural color harmony, premium photography look",
"width": 1408,
"height": 768
}{
"taskType": "imageInference",
"taskUUID": "b20a1b78-235b-40f7-aa12-29fadd35d91c",
"imageUUID": "4172489a-291d-410b-8754-1a3aea5ff60e",
"imageURL": "https://im.runware.ai/image/os/a11d13/ws/2/ii/4172489a-291d-410b-8754-1a3aea5ff60e.jpg",
"seed": 1320781308,
"cost": 0.02
}