curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "xai/grok-imagine-image-v2.0/edit",
  "input": {
    "image_urls": [
      "https://example.com/image.png"
    ],
    "prompt": "A quiet forest under soft morning light, with natural detail.",
    "n": 1,
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "quality": "medium"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "running",
    "created_time": "2026-09-10T08:00:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

"Request timeout"

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

​

Grok Imagine Image 2.0 Edit

Refine images with Grok Imagine Image 2.0, combining reference images and precise instructions to preserve subjects while changing visual details.

​

Available Models

• xai/grok-imagine-image-v2.0/edit - Edit images using a prompt and image references.

​

Output Options

​

Aspect Ratio

• aspect_ratio: Optional. Accepted values: 1:1, 2:3, 3:2, 9:16, 16:9. Default: 1:1.

​

Resolution

• resolution: Optional. Accepted values: 1K, 2K. Default: 1K.

​

Quality

• quality: Optional. Accepted values: low, medium. Default: medium.

​

Image Count

• n: Optional. Number of images to generate. Integer from 1 to 4. Default: 1.

​

Key Features

• Edit images using a prompt and image references.
• Accepts 1-3 images in image_urls.
• Choose from 1K, 2K output resolutions.
• Control the number of output images with n.

​

Advanced Parameters

Set model and optional callback_url at the request root. Place all workflow parameters, including output options, inside input. Send only the input fields supported by this workflow. Unsupported input fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials.

​

Prompt

• prompt: Required. Describe the requested changes. Length: 1-8,000 characters.
• The value must not be blank when supplied.

​

Image URLs

• image_urls: Required. Provide publicly accessible image URLs. Supply 1-3 items. Each item must be an HTTP(S) URL.

​

Billing Factors

Billing depends on output quality (quality), output resolution (resolution), and output image count (n). Input image count (image_urls) adds a separate charge once per request; this charge is not multiplied by n. Credits are deducted on submission and refunded if the task fails.