POST
https://octopusx.ai
/
v1
/
video
/
extend
Video Extend
curl --request POST \
  --url https://octopusx.ai/v1/video/extend \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "task_id": "<string>",
  "images": [
    "<string>"
  ],
  "size": "<string>",
  "aspect_ratio": "<string>",
  "start_time": 123,
  "upscale": true
}
'
{
  "id": "grok:48a67431-0708-46d1-9ab9-83cb84700153",
  "status": "processing",
  "status_update_time": 1762685256
}

​
Video Extend

The Grok unified video extend endpoint is POST /v1/video/extend. Unlike OpenAI-format Video Extend, the original task ID is passed in the Body via task_id.
  • The route endpoint is POST /v1/video/extend.
  • Required: model, prompt, task_id.
  • You can specify which second of the original video to start extending from with start_time.

​
Method and Path

POST /v1/video/extend

​
Request Example

curl -X POST https://octopusx.ai/v1/video/extend \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "model": "grok-video-3",
    "prompt": "play with another white cat",
    "task_id": "grok:2d8ef725-c4a9-46e0-b133-eca6c297e830",
    "start_time": 4,
    "aspect_ratio": "3:2",
    "size": "1080P",
    "upscale": true
  }'

​
Response Example

{
  "id": "grok:48a67431-0708-46d1-9ab9-83cb84700153",
  "status": "processing",
  "status_update_time": 1762685256
}

​
Authentication

Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
required
Model name, for example grok-video-3.
​
prompt
string
required
Prompt for the extended segment.
​
task_id
string
required
Original video task ID.
​
images
array<string>
List of reference image URLs to add visual constraints as needed.
​
size
string
Resolution specification, pass 720P or 1080P.
​
aspect_ratio
string
Video aspect ratio, for example 3:2.
​
start_time
integer
Which second of the original video to start extending from.
​
upscale
boolean
Whether to apply high-definition enhancement to the output.

​
Response

​
id
string
New extend task ID.
​
status
string
Task status, common values include processing, completed, and failed.
​
status_update_time
integer
Most recent status update time (Unix timestamp).