xAI: Grok Imagine Video 1.5 Lite (Text to Video) API Reference

About

Generate videos from text prompts using xAI's Grok Imagine Video 1.5 Lite model.

1. Calling the API

Setup your API Key

To begin using Infron, you first need to create an account and generate your API Key.

Once you have your API key, set it as an environment variable in your runtime environment. This allows your applications to securely access Infron’s API.

export INFRON_KEY="YOUR_API_KEY"

Submit a request

For long-running requests, you can poll for results.

curl https://media.onerouter.pro/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
    "model": "x-ai/grok-imagine-video-1.5-lite/text-to-video",
    "prompt": "Anime schoolgirl bursting out of house door, cherry blossoms blowing, morning light, speed lines indicating rush, chibi-ready expressions, classic shojo aesthetic, vibrant colors.",
    "duration": 15,
    "resolution": "720p",
    "generate_audio": true,
    "n": 1
}
EOF

Response with queue task id

The response will look like this:

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "20261012073855825303455Qh1vZjmK",
    "object": "video",
    "model": "x-ai/grok-imagine-video-1.5-lite/text-to-video",
    "status": "created",
    "urls": {
      "query": "https://media.onerouter.pro/v1/videos/tasks/20261012073855825303455Qh1vZjmK"
    },
    "created_at": "2026-10-12 07:38:55.85"
  }
}

Fetch request status

You can fetch the status of a request to check if it is completed or still in progress.

curl https://media.onerouter.pro/v1/videos/tasks/{task_id} \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" 

# For example
curl https://media.onerouter.pro/v1/videos/tasks/20261012073855825303455Qh1vZjmK \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response with queue task status query

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "20261012073855825303455Qh1vZjmK",
    "object": "video",
    "model": "x-ai/grok-imagine-video-1.5-lite/text-to-video",
    "status": "in_progress",
    "fail_reason": "",
    "submit_time": 1791790736,
    "start_time": 1791790736,
    "finish_time": 0,
    "outputs": [],
    "created_at": "2026-10-12 07:38:56"
  }
}

Possible statuses:

  • created
  • in_progress
  • processing
  • completed
  • failed

created -> in_progress → processing → completed | failed

Poll every 1-2 seconds until status is "completed" or "failed"

Get the result (when status is "completed")

Once the request is completed, you can fetch the result. See the Output Schema for the expected result format.

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "20261012073855825303455Qh1vZjmK",
    "object": "video",
    "model": "x-ai/grok-imagine-video-1.5-lite/text-to-video",
    "status": "completed",
    "fail_reason": "",
    "submit_time": 1791790736,
    "start_time": 1791790736,
    "finish_time": 1791790786,
    "outputs": [
      "https://infron.ai/cdn/media/video/video_v2/output/output_707374ad-e758-4346-960e-e6836889a656.mp4"
    ],
    "usage": {
      "completion_tokens": 0,
      "duration": 15,
      "generate_audio": true,
      "output_count": 1,
      "prompt_tokens": 1,
      "request_num": 1,
      "resolution": "720p",
      "tokens": 1,
      "total_tokens": 1,
      "video_duration": 15
    },
    "cost": {
      "total_cost": 0.45,
      "cost_details": {
        "prompt_cost": 0,
        "completion_cost": 0,
        "image_cost": 0,
        "video_cost": 0.45,
        "audio_cost": 0,
        "native_web_search_cost": 0,
        "plugin_web_search_cost": 0,
        "tools_cost": 0,
        "prompt_cache_read_cost": 0,
        "prompt_cache_write_cost": 0,
        "prompt_cache_write_5_min": 0,
        "prompt_cache_write_1_h": 0,
        "reasoning_cost": 0,
        "discount_rate": 1,
        "is_byok": false,
        "byok_cost": 0
      }
    },
    "created_at": "2026-10-12 07:38:56"
  }
}

2. Schema

Input

ParameterTypeRequiredDefaultRangeDescription
modelstringYes--Explore all modelsModel name.
promptstringYes----Text prompt for generation; Positive text prompt.
durationintegerNo8[1,15]Duration of the video in seconds, between 1 and 15.
aspect_ratiostringNo16:91:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 5:2Aspect ratio of the generated video.
resolutionstringNo480p480p, 720pResolution of the generated video.
generate_audiobooleanNoTrueTrue, FalseGenerate audio for the video.
nintegerNo1[1]Number of videos to generate.

Example request

curl https://media.onerouter.pro/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
    "model": "x-ai/grok-imagine-video-1.5-lite/text-to-video",
    "prompt": "Anime schoolgirl bursting out of house door, cherry blossoms blowing, morning light, speed lines indicating rush, chibi-ready expressions, classic shojo aesthetic, vibrant colors.",
    "duration": 15,
    "resolution": "720p",
    "generate_audio": true,
    "n": 1
}
EOF

Output

ParameterTypeRangeDescription
codeinteger--Status code of the request.
messagestring--Status message of the request.
dataobject--Data of the video task.
data.task_idstring--ID of the video task.
data.objectstring--Object type of the video task.
data.modelstring--Model name of the video task.
data.statusstringcreated, in_progress, processing, completed, failedStatus of the video task.
data.fail_reasonstring--Fail reason of the video task.
data.submit_timeinteger--Timestamp of the video task submission.
data.start_timeinteger--Timestamp of the video task start.
data.finish_timeinteger--Timestamp of the video task finish.
data.outputsarray--Outputs of the video task.
data.created_atstring--Timestamp of the video task creation.

Example output

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "20261012073855825303455Qh1vZjmK",
    "object": "video",
    "model": "x-ai/grok-imagine-video-1.5-lite/text-to-video",
    "status": "completed",
    "fail_reason": "",
    "submit_time": 1791790736,
    "start_time": 1791790736,
    "finish_time": 1791790786,
    "outputs": [
      "https://infron.ai/cdn/media/video/video_v2/output/output_707374ad-e758-4346-960e-e6836889a656.mp4"
    ],
    "usage": {
      "completion_tokens": 0,
      "duration": 15,
      "generate_audio": true,
      "output_count": 1,
      "prompt_tokens": 1,
      "request_num": 1,
      "resolution": "720p",
      "tokens": 1,
      "total_tokens": 1,
      "video_duration": 15
    },
    "cost": {
      "total_cost": 0.45,
      "cost_details": {
        "prompt_cost": 0,
        "completion_cost": 0,
        "image_cost": 0,
        "video_cost": 0.45,
        "audio_cost": 0,
        "native_web_search_cost": 0,
        "plugin_web_search_cost": 0,
        "tools_cost": 0,
        "prompt_cache_read_cost": 0,
        "prompt_cache_write_cost": 0,
        "prompt_cache_write_5_min": 0,
        "prompt_cache_write_1_h": 0,
        "reasoning_cost": 0,
        "discount_rate": 1,
        "is_byok": false,
        "byok_cost": 0
      }
    },
    "created_at": "2026-10-12 07:38:56"
  }
}

3. Detailed Pricing

Currency: USD ($). Rates match the xAI model pricing, checked on 2026-10-10.

Pricing TypeUnitPrice
Video output, 480pper second$0.02
Video output, 720pper second$0.03
Video output, 1080pper second$0.14
Input imageper image$0.01
Input textno separate charge$0.00

Billing formula: Actual output duration in seconds × the resolution rate + $0.01 for the first input image.

Estimated total for one 6-second video with one input image:

ResolutionEstimated Price
480p$0.13
720p$0.19
1080p$0.85

The configured default is 6 seconds at 480p. generate_audio does not change the rate. The final settled amount is returned in data.cost.total_cost; data.cost.cost_details.video_cost includes the complete video-task charge, including the input-image fee.