Model IDgrok-video

Use this in the request body model field.

Endpoint/api/v1/videos/generations

The currently implemented BFF route.

Outputvideo

Input types: text, image

AuthBearer API key

Keys are managed by the shared dashboard.

WebhookSupported

Use callback_url on supported async tasks.

Live capabilities

These capabilities come from the current model config and backend route. Unreleased APIs are not listed.

No X/Twitter Premium subscription needed

Both text

Both text-to-video and image-to-video

Direct API access to xAI's Grok

Same backend as Grok Imagine for consistent quality

Request format

Clients call same-origin API routes; the server BFF forwards to the matching Worker.

MethodEndpointCreditsPurpose

POST/api/v1/videos/generations24 credits

xAI's Grok Video — AI video generation powered by Grok Imagine. Supports text-to-video and image-to-video.

Parameters

promptstring

Text prompt for video generation (required for text-to-video, max 5000 chars)

Optional

modelstring

Sub-model: "grok-imagine/text-to-video" or "grok-imagine/image-to-video"

Optional · Default grok-imagine/text-to-video

image_urlsarray

Image URLs for image-to-video mode

Optional

Example request

curl -X POST https://apiin.one/api/v1/videos/generations \
  -H "Authorization: Bearer aio_your_api_key" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "model": "grok-imagine/text-to-video",
  "prompt": "A cat walking across a piano keyboard, cinematic lighting"
}'

Models on the same endpoint

These live models use the same implemented BFF endpoint and can be switched by changing the model field.

🎞️ltx-2video · 24 credits/api/v1/videos/generations

seedance-1-5-provideo · 28 credits/api/v1/videos/generations

hailuo-2-3video · 30 credits/api/v1/videos/generations

wan-2-6video · 80 credits/api/v1/videos/generations

pixverse-5-6video · 90 credits/api/v1/videos/generations

kling-3video · 300 credits/api/v1/videos/generations

Integration flow

These steps use the current live route and shared account system; login, payment, orders, credits, and profile remain shared.

01

Create a shared API key

Create a key in the existing dashboard. Top-up, orders, credit balance, and profile stay in the shared console.

02

Call the real endpoint

Send a request with the endpoint, model id, and parameters shown on this page. /api/v1/videos/generations

03

Poll task status

Async media and tool jobs use /api/v1/tasks/{task_id}; chat models return a direct response.

Task status route

After creating image, video, audio, or tool tasks, poll the real task endpoint for results.

GET/api/v1/tasks/{task_id}Check generation task status and result.

Pricing

~$0.24 per video (24 credits)

Base cost$0.24

Credits24

BillingSuccessful requests

Use cases

These workflows are supported by the current model and backend node.

01

Generate short videos from text descriptions

02

Animate images into video clips

03

Create social media video content

04

Build AI video features into apps

FAQ

How much does Grok Video cost?

Each video costs 24 credits (~$0.24) for both text-to-video and image-to-video.

Does Grok Video support image-to-video?

Yes. Provide image URLs via the "image_urls" parameter to animate images into video.

Do I need a Twitter/X Premium subscription?

No. API in One provides direct API access without any X/Twitter subscription.

grok-video API