curl --request POST \
--url https://api.modellix.ai/api/v1/xai/grok-imagine-image-2.0-edit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "Render this as a pencil sketch with detailed shading",
"images": [
"https://example.com/photo.png"
]
}
'{
"code": 0,
"message": "success",
"data": {
"status": "pending",
"task_id": "task-xai-i2i-003",
"model_id": "xai/grok-imagine-image-2.0-edit",
"get_result": {
"method": "GET",
"url": "https://api.modellix.ai/api/v1/tasks/task-xai-i2i-003"
}
}
}{
"code": 400,
"message": "Invalid parameters: parameter 'images' is required"
}{
"code": 401,
"message": "Authentication failed: invalid API key"
}{
"code": 429,
"message": "Rate limit exceeded: 100 requests per minute, retry after 60 seconds"
}{
"code": 500,
"message": "Internal server error"
}Grok Imagine Image 2.0 Edit
[Core Function] Grok Imagine Image 2.0 Edit edits one to three source images from a text prompt. [Strengths] It supports quality (low or medium), 1k or 2k resolution, and the same aspect ratios as Grok Imagine Image 2.0. [Best For] Highly recommended for: restyling, combining up to 3 references, and iterative refinement. [Limitations] Requires at least one source image; at most 3 images per request. This model does not generate from text alone. [Routing] For text-to-image generation, use Grok Imagine Image 2.0.
curl --request POST \
--url https://api.modellix.ai/api/v1/xai/grok-imagine-image-2.0-edit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "Render this as a pencil sketch with detailed shading",
"images": [
"https://example.com/photo.png"
]
}
'{
"code": 0,
"message": "success",
"data": {
"status": "pending",
"task_id": "task-xai-i2i-003",
"model_id": "xai/grok-imagine-image-2.0-edit",
"get_result": {
"method": "GET",
"url": "https://api.modellix.ai/api/v1/tasks/task-xai-i2i-003"
}
}
}{
"code": 400,
"message": "Invalid parameters: parameter 'images' is required"
}{
"code": 401,
"message": "Authentication failed: invalid API key"
}{
"code": 429,
"message": "Rate limit exceeded: 100 requests per minute, retry after 60 seconds"
}{
"code": 500,
"message": "Internal server error"
}Authorizations
API Key authentication. Format: Bearer YOUR_API_KEY.
Body
Edit one to three source images from a text prompt. Pass a single image as a one-element images array.
Text description of the edit to apply.
1"Render this as a pencil sketch with detailed shading"
Source image URLs to edit (1-3). Each item must be a publicly accessible HTTP(S) URL.
1 - 3 elements1["https://example.com/photo.png"]
Number of edited images to generate.
1 <= x <= 101
Aspect ratio of the output image. If omitted, the output follows the first input image.
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, 21:9, 5:2, auto "16:9"
Output resolution.
1k, 2k "1k"
Generation quality.
low, medium "medium"
How images are returned: a temporary URL, or base64 in the task result.
url, b64_json "url"