Skip to main content
POST
/
v1
/
videos
/
{video_id}
/
extend
curl --request POST \
  --url https://toapis.com/v1/videos/video_abc123def456/extend \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-video-3",
    "prompt": "Continue the scene, make the dog run towards the horizon"
  }'
{
  "id": "video_extend_abc123",
  "object": "generation.task",
  "model": "grok-video-3",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}
  • Grok Video extend feature
  • Extend the duration of existing videos
  • Async task management, query results via task ID

Path Parameters

video_id
string
required
Original video task IDThis is the task ID returned from a previous video generation request

Authorizations

Authorization
string
required
All API requests require Bearer Token authenticationGet API Key: Visit the API Key Management Page to obtain your API KeyAdd to request headers:
Authorization: Bearer YOUR_API_KEY

Body

model
string
default:"grok-video-3"
required
Video extend model nameExample: "grok-video-3"
prompt
string
required
Text description for video extension
size
string
Video size

Response

id
string
Unique task identifier for querying task status
object
string
Object type, always generation.task
model
string
Model name used
status
string
Task status
  • queued - Waiting to be processed
  • in_progress - Processing
  • completed - Successfully completed
  • failed - Failed
progress
integer
Task progress percentage (0-100)
created_at
integer
Task creation timestamp (Unix timestamp)
metadata
object
Task metadata
curl --request POST \
  --url https://toapis.com/v1/videos/video_abc123def456/extend \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-video-3",
    "prompt": "Continue the scene, make the dog run towards the horizon"
  }'
{
  "id": "video_extend_abc123",
  "object": "generation.task",
  "model": "grok-video-3",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}