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-video-v1.5/image-to-video",
  "input": {
    "duration": 1,
    "image_urls": [
      "https://example.com/image.png"
    ],
    "prompt": "A quiet forest under soft morning light, with natural detail.",
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }
}
'

{
  "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 Video 1.5 Image to Video

Turn a reference image into a video with Grok Imagine Video 1.5, with output up to 1080p and clips from one to fifteen seconds long.

​

Available Models

• xai/grok-imagine-video-v1.5/image-to-video - Generate video from image input.

​

Duration Options

• 1-15 seconds - Set duration as an integer. Required.

​

Key Features

• Generate video from image input.
• Accepts exactly 1 image in image_urls.
• Choose from 480p, 720p, 1080p output resolutions.

​

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.

• Use the required image_urls field for this workflow.

​

Prompt

• prompt: Required. Describe the scene and desired motion. Length: 1-4,096 characters.
• The value must not be blank when supplied.

​

Image URLs

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

​

Resolution

• resolution: Optional. Accepted values: 480p, 720p, 1080p. Default: 720p.

​

Aspect Ratio

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

​

Pricing

Pricing depends on the selected model and applicable output settings. Check the Vidgo dashboard for the current rate. Credits are deducted on submission and refunded if the task fails.