Flexible parameters
Configure 5 documented parameters, including enable_safety_checker, mask_indices, prompt, source_image_url, source_task_id.
xAI
Grok Imagine edit image
ImagePrompt-guided style transfer and composition editing from one or more source images
Model health
Insufficient data
curl -X POST https://runapi.ai/api/v1/grok_imagine/edit_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-edit-image",
"source_image_url": "https://cdn.runapi.ai/public/samples/image.jpg",
"prompt": "Generate a short video of a robot hand placing a chess piece on a board, dramatic lighting, slow motion."
}'import { GrokImagineClient } from "@runapi.ai/grok-imagine";
const client = new GrokImagineClient();
const result = await client.editImage.run({
model: "grok-imagine-edit-image",
source_image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "Generate a short video of a robot hand placing a chess piece on a board, dramatic lighting, slow motion.",
});import os
import requests
response = requests.post(
"https://runapi.ai/api/v1/grok_imagine/edit_image",
headers={"Authorization": f"Bearer {os.environ['RUNAPI_API_KEY']}"},
json={"model":"grok-imagine-edit-image","source_image_url":"https://cdn.runapi.ai/public/samples/image.jpg","prompt":"Generate a short video of a robot hand placing a chess piece on a board, dramatic lighting, slow motion."}
)
response.raise_for_status()<?php
$client = curl_init("https://runapi.ai/api/v1/grok_imagine/edit_image");
curl_setopt_array($client, [
CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("RUNAPI_API_KEY"), "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode([
'model' => 'grok-imagine-edit-image',
'source_image_url' => 'https://cdn.runapi.ai/public/samples/image.jpg',
'prompt' => 'Generate a short video of a robot hand placing a chess piece on a board, dramatic lighting, slow motion.',
])
]);
$response = curl_exec($client);RunApi client = new RunApi(System.getenv("RUNAPI_API_KEY"));
Task task = client.editImage().run({"model":"grok-imagine-edit-image","source_image_url":"https://cdn.runapi.ai/public/samples/image.jpg","prompt":"Generate a short video of a robot hand placing a chess piece on a board, dramatic lighting, slow motion."});
task.waitForResult();require "runapi/grok_imagine"
client = RunApi::GrokImagine::Client.new
result = client.edit_image.run(
model: "grok-imagine-edit-image",
source_image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "Generate a short video of a robot hand placing a chess piece on a board, dramatic lighting, slow motion."
)client := runapi.NewClient(os.Getenv("RUNAPI_API_KEY"))
task, err := client.editImage.Run({"model":"grok-imagine-edit-image","source_image_url":"https://cdn.runapi.ai/public/samples/image.jpg","prompt":"Generate a short video of a robot hand placing a chess piece on a board, dramatic lighting, slow motion."})
if err != nil { log.Fatal(err) }
task.Wait()$ runapi generate \
--model grok-imagine-edit-image \
--endpoint edit_image \
--wait7 versions available
Playground
Try Grok Imagine edit image
Pick any model and generate in seconds.
Specifications
Technical details
| Provider | xAI |
| Model ID | grok-imagine-edit-image |
| Modality | Image |
| Task types | Asynchronous |
| API endpoint | /api/v1/grok_imagine/edit_image |
| Billing unit | call |
| Input parameters | callback_url, enable_safety_checker, mask_indices, model, prompt, source_image_url, source_task_id |
| Catalog status | Operational |
HOW IT WORKS
Use This Model in 3 Steps
-
Get Your Key
Sign up for free and create an API key for grok-imagine-edit-image from the dashboard.
-
Send a Request
POST to /api/v1/grok_imagine/edit_image with the grok-imagine-edit-image model slug and your parameters.
-
Get Results
Poll the task or follow the callback to retrieve the completed grok-imagine-edit-image result.
What this model offers
Endpoint coverage
Exposes 1 public endpoint(s): edit_image.
Webhook delivery
Asynchronous tasks accept a callback URL for completion notifications.
Usage-based billing
Metered by call with no subscription requirement.
Grok Imagine edit image Pricing
Endpoint
Resolution
Duration
Price
edit_image
Not available
call
$0.04 / image
API REFERENCE
Endpoint Specification
- Endpoint
- POST /api/v1/grok_imagine/edit_image
- Model ID
- grok-imagine-edit-image
- Task Types
- edit_image
- Max Duration
- Unavailable
- Resolutions
- Unavailable
- Aspect Ratios
- Unavailable
- Output Format
- Unavailable
- Avg Generation Time
- Unavailable
Request parameters
prompt
Optional
value
Optional image editing instruction.
callback_url
Optional
value
Webhook URL for terminal Task delivery.
mask_indices
Optional
value
Not accepted by this model.
source_task_id
Optional
value
Not accepted by this model.
source_image_url
Required
value
Public source image URL.
enable_safety_checker
Optional
value
Enable content safety checks.
USE CASES
Product photography
Auto-generate lifestyle product photos for e-commerce catalogs that lack studio photography.
Game & concept art
Rapidly concept environments and characters before committing to final art.
Editorial illustration
Generate unique cover art and illustrations for blog posts and articles at scale.
RELATED
FAQ
Frequently asked questions about Grok Imagine edit image
How do I select grok-imagine-edit-image?
Pass the model ID shown in the quickstart.
What's the rate limit on this variant?
Per-key rate limits scale with your usage tier. The pricing page shows current limits. If you need higher throughput, contact support to discuss tier upgrades.
Can I switch variants later?
Yes. Variant is a parameter in the request. Switch by changing the model ID — no code changes, no re-authentication, no separate billing setup. All variants share the same API key and request shape.
Does it stream?
Where streaming is available, RunAPI streams end-to-end. LLM models support token-level streaming. Media models use async task polling or webhook callbacks for result delivery.
Where do I report quality issues?
Open an issue on the public GitHub repo or email support at [email protected]. Include the task ID and model ID so the team can investigate the specific generation.
Do I need a separate provider account?
No. Your RunAPI API key is enough to access this variant and every other model in the catalog. You do not need accounts with the underlying provider.
Building with a team?
We're here to help with enterprise setup, integrations, and technical questions.
Contact Us