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/text-to-image",
  "input": {
    "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 Text to Image

Create detailed images with accurate text, structured layouts, and close prompt following, at resolutions up to 2K.

​

Available Models

• xai/grok-imagine-image-v2.0/text-to-image - Generate images from text prompts.

​

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

• Generate images from text prompts.
• 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.

​

Prompt

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

​

Billing Factors

Billing depends on output quality (quality), output resolution (resolution), and output image count (n). Credits are deducted on submission and refunded if the task fails.