Skip to main content
POST
/
api
/
v1
/
task
/
submit
curl --request POST \
  --url https://api.maxapi.io/api/v1/task/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "grok-imagine/text-to-video",
  "callBackUrl": "https://example.com/webhook",
  "input": {
    "prompt": "A dog surfing a giant wave at golden hour, cinematic",
    "duration": 10,
    "ratio": "16:9",
    "resolution": "720p",
    "mode": "normal"
  }
}'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.maxapi.io/llms.txt

Use this file to discover all available pages before exploring further.

Create short videos from a text prompt using xAI’s Grok Imagine Video.

​
Available Model

grok-imagine/text-to-video — $0.007 per second of generated video.

​
Supported Options

  • duration: 6, 10, 12, 16, 20 seconds
  • ratio: 1:1, 16:9, 9:16
  • resolution: 480p, 720p
  • mode: fun, normal, spicy, custom
​
model
string
required
Must be grok-imagine/text-to-video.
​
callBackUrl
string
Webhook callback URL.
​
input
object
required
curl --request POST \
  --url https://api.maxapi.io/api/v1/task/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "grok-imagine/text-to-video",
  "callBackUrl": "https://example.com/webhook",
  "input": {
    "prompt": "A dog surfing a giant wave at golden hour, cinematic",
    "duration": 10,
    "ratio": "16:9",
    "resolution": "720p",
    "mode": "normal"
  }
}'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}
Typical generation time: under 5 minutes. The result is delivered via Webhook or the Query Task endpoint as an MP4 URL hosted on Max API’s CDN.