Grok Imagine Image Quality Text to Image

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-quality/text-to-image",
  "input": {
    "prompt": "A quiet forest under soft morning light, with natural detail.",
    "n": 1,
    "aspect_ratio": "1:1",
    "resolution": "1K"
  }
}
'

{
  "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>"
}

Create image variations in 1K or 2K with Grok Imagine Image Quality, with framing options for portraits, landscapes, and square designs.

​

Models

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

​

Features

• Generate images from text prompts.
• Choose from 1K, 2K output resolutions.
• Control the number of output images with n.

​

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.

​

Image Count

• n: Optional. Number of images to generate. Integer, at least 1. Default: 1. No maximum is specified; fractional numbers, strings, and booleans are rejected.

​

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. Minimum length: 1 character.
• The value must be a string and must not be blank. No maximum prompt length is specified.

​

Billing Factors

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