grok-imagine-image AI Image API
xAI grok-imagine-image for image generation; Flatkey routes this model through /v1/images/generations. $0.016 per image
Output
Preview
Request summary
- Endpoint
- POST /v1/images/generations
- Model ID
- grok-imagine-image
- Aspect ratio
- 16:9
- Resolution
- 1k
- Quality
- medium
- Output format
- url
- Outputs
- 1
Preview only. Sign in to submit this request to Flatkey.
{
"model": "grok-imagine-image",
"prompt": "Scene: A sunset beach-volleyball broadcast frame captures a player spiking over the net as sand sprays from the jump. Show the opposing court, hazy beach crowd, warm sky, and a simple teal-and-white lower-third made from abstract blocks. Keep the net, player position, ball path, and camera angle coherent; no real athletes, teams, logos, or watermark.\n\nComposition and rendering: Deliver one 16:9 broadcast still at the decisive instant. Use coherent perspective for the playing surface and equipment, readable separation between competitors, and a softer crowd behind the action. Keep the principal subject sharp, with directional blur limited to fast extremities and spray. Preserve the specified broadcast angle and reserve overlay areas clear of the action.\n\nAvoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.",
"n": 1,
"resolution": "1k",
"quality": "medium",
"aspect_ratio": "16:9",
"response_format": "url"
}grok-imagine-image API performance
grok-imagine-image API reliability and uptime
Live Flatkey request telemetry for grok-imagine-image appears here when enough production traffic is available.
grok-imagine-image API activity
grok-imagine-image API usage and request activity
Track request volume and successful inference activity for grok-imagine-image over the latest reporting window.
grok-imagine-image pricing
grok-imagine-image API pricing and billing
Prices below are calculated from Flatkey pricing data for this model and the visible groups currently returned by our pricing API.
Add credits
Use the same Flatkey balance and API key across image, video, audio, and text models.
- Model Type
- Text to Image
- API
- /v1/images/generations
- Billing basis
- image
- Outputs
- 1–10
grok-imagine-image image generation: core capabilities
xAI's grok-imagine-image route supports text · image. Catalog categories: Marketing.
grok-imagine-image visual creation
Turn a written brief into product, editorial, or campaign imagery through /v1/images/generations.
grok-imagine-image reference-led editing
Use an existing image as creative direction for revisions and consistent visual variants when the route accepts references.
grok-imagine-image channel-ready variants
Adapt one concept into the image compositions your storefront, campaign, or content pipeline needs.
grok-imagine-image creative production workflow
Move an approved visual from prompt exploration into a repeatable Flatkey generation workflow.
Compare
grok-imagine-image API comparison: capabilities and access
Compare the catalog facts for grok-imagine-image with the previous-generation baseline before changing your integration.
| Capability | Previous generation | grok-imagine-image |
|---|---|---|
| Provider | Not verified in this catalog snapshot | xAI |
| Modalities | Not verified in this catalog snapshot | text · image |
| Context | Not verified in this catalog snapshot | Context window not listed in the catalog |
| Endpoint | Not verified in this catalog snapshot | /v1/images/generations |
| Billing | Not verified in this catalog snapshot | $0.016 per image |
Choose the right request before you integrate
Review the supported workflows, live cost for the current setup, and the exact parameter contract used by Flatkey.
Calculated from the current Playground settings and the live catalog rate when a fixed unit price is available.
- Current setup
- medium · 1×
- Live rate
- $0.016 / image
- Estimated request
- $0.016
The final charge follows the submitted request and your account group. Token-priced or tiered requests cannot be reduced to one fixed estimate.
Workflows and Model ID
Use only the workflows marked available. Flatkey keeps one public model ID while the request body selects the input workflow.
Text to Image
Generate a new image from a text prompt and output controls.
- Model ID
grok-imagine-image- Endpoint
/v1/images/generations
Reference-guided Image
Use reference images for edits, variations, or identity and composition guidance.
- Model ID
grok-imagine-image- Endpoint
/v1/images/generations
Parameter compatibility
These values come from the same model configuration used by the Playground and request preview.
nImages1–10
Default: 1resolutionResolution1k · 2k
Default: 1kqualityQualitylow · medium
Default: mediumaspect_ratioAspect ratioauto · 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 2:1 · 1:2 · 19.5:9 · 9:19.5 · 20:9 · 9:20
Default: autoresponse_formatOutput formaturl · b64_json
Default: urlimageReference limit3 files
Endpoint: /v1/images/generationsFrom first test to production
Use the same request contract in the Playground and API, then handle validation, balance, task state, and output retrieval explicitly.
Request lifecycle
- 1
Validate the model, prompt, references, and output settings.
- 2
POST the image request with the documented fields.
- 3
Read the generated output or asynchronous task result returned by the route.
- 4
Store the generated file and request metadata in your own workflow.
Production checks
Reject unsupported sizes, durations, ratios, formats, or reference counts before submitting.
Handle invalid keys, insufficient balance, rate limits, and account-group pricing separately.
Surface the rejected prompt or asset clearly so the user can replace only the failing input.
Keep the task ID, use bounded retries, and never treat a timeout as a successful generation.
Prompt library
grok-imagine-image image generation prompt examples
Start with a grok-imagine-image prompt for product and ecommerce images, then adjust the request fields shown in the playground.
Generated with Image 2
Scene: A 16:9 cyberpunk game equipment screen shows a masked figure crouched on a neon rooftop above a dense night city. A black-and-lime HUD frames the character, with weapon and tool slots on the right including a glowing pickaxe. Hold the crouch, rooftop line, neon rim light, and selected slot fixed for an equipment-switch frame. No readable words, logos, invented stats, or watermark. Composition and rendering: Deliver one 16:9 game-interface keyframe. Separate the character, held equipment and HUD into clear depth layers; keep slot spacing and icon scale consistent, with the selected item visually dominant. Preserve the scene-specific game art style. Let material edges catch the existing light without letting interface glow obscure the silhouette. Keep all equipment fully inside the frame. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Scene: A sunset beach-volleyball broadcast frame captures a player spiking over the net as sand sprays from the jump. Show the opposing court, hazy beach crowd, warm sky, and a simple teal-and-white lower-third made from abstract blocks. Keep the net, player position, ball path, and camera angle coherent; no real athletes, teams, logos, or watermark. Composition and rendering: Deliver one 16:9 broadcast still at the decisive instant. Use coherent perspective for the playing surface and equipment, readable separation between competitors, and a softer crowd behind the action. Keep the principal subject sharp, with directional blur limited to fast extremities and spray. Preserve the specified broadcast angle and reserve overlay areas clear of the action. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Generated with Image 2
Scene: A vintage black camera with a large textured lens rests on a black pedestal against a deep green-black background. Warm highlights describe the metal dials, leather grip, lens rings, and small empty space to the left. Preserve the camera body, lens perspective, pedestal edge, and controlled studio lighting. No readable branding, extra products, hands, or watermark. Composition and rendering: Deliver one 16:9 commercial product still. Keep the complete product silhouette inside generous crop-safe margins. Resolve edges, seams and material transitions precisely; shape highlights to describe volume without clipping bright surfaces or crushing dark details. Align reflections with the object and light source. Retain the stated camera angle and existing negative space; add no decorative props. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Scene: In a warmly lit theater dressing room, a curly-haired actor in a cream shirt and dark vest looks into a large aged mirror beside costumes and glowing round bulbs. The reflected face and three-quarter profile form a character continuity frame. Keep the mirror geometry, wardrobe, eye line, and amber lighting consistent. No readable signage, logos, or watermark. Composition and rendering: Deliver one 16:9 storyboard keyframe, not a collage or an action sequence. Separate foreground, character plane and background through the existing light and atmospheric depth. Keep the stated pose and eyelines readable, and retain environmental landmarks for continuity. Match the described photographic, illustrated or puppet medium; give fabric and surfaces texture appropriate to that medium. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Generated with Image 2
Scene: On a beach at sunset, a man in a light shirt pulls a yellow-striped picnic cloth as a sandwich and two white plates lift into the air above a wooden table. Freeze the harmless physical gag with visible cloth tension, believable object paths, warm sea light, and clear spacing. No injury, readable words, logos, or watermark. Composition and rendering: Deliver one 16:9 physical-comedy still at the described instant. Make the cause of the gag readable through body balance, grip and object spacing. Separate the reaction from the airborne props; retain believable gravity and contact points. Keep the face and important props sharp, with only restrained directional blur on fast edges. Preserve the stated lighting and room or stage layout. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Generated with Image 2
Scene: A warm faded archival photograph shows a family having a picnic in a grassy field: one adult pours from a thermos, another spreads food, and a child sits beside a bicycle. Preserve the period clothing, enamel cups, bicycle, hills, film grain, and soft light-leak edge. No modern branding, readable text, logos, or watermark. Composition and restoration: Deliver one 16:9 archival-style still. Preserve the original framing, period-specific construction and restrained tonal range; retain monochrome, sepia or faded color as described. Recover modest detail in faces, clothing and architecture without synthetic sharpening. Keep fine grain and authentic aging consistent across the frame; repair damage without replacing historical features. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Why grok-imagine-image API
Why use grok-imagine-image through Flatkey?
Use one gateway for grok-imagine-image, account controls and the rest of your model catalog.
grok-imagine-image in one API
Keep the grok-imagine-image model id and endpoint explicit while using the same Flatkey key as other workloads.
Live catalog pricing
See the current grok-imagine-image billing dimensions before a request is sent, then confirm the final estimate in your account.
A practical model handoff
Test a grok-imagine-image prompt in the public playground and carry the same settings into an authenticated integration.
Usage and routing controls
Centralize keys, quotas and routing for grok-imagine-image without changing your application’s provider-facing workflow.
grok-imagine-image API
grok-imagine-image API integration guide
Use the model id above with /v1/images/generations; keep the request fields and billing unit documented for your route.
curl https://router.flatkey.ai/v1/images/generations \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-***" \ -d '{"model":"grok-imagine-image","prompt":"Create a high-quality product image with grok-imagine-image: clean composition, precise lighting, strong subject focus, and realistic detail.","n":1,"resolution":"1k","quality":"medium","aspect_ratio":"auto","response_format":"url"}'
FAQ
grok-imagine-image API
pricing, features, and usage FAQs
Answers about grok-imagine-image pricing, capabilities, endpoint access and catalog limits.




