POST
https://octopusx.ai
/
v1
/
videos
/
extensions
Video Extensions
curl --request POST \
  --url https://octopusx.ai/v1/videos/extensions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "video": {},
  "video.url": "<string>",
  "start_time": 123,
  "duration": 123
}
'
{
  "id": "grok:48a67431-0708-46d1-9ab9-83cb84700153",
  "status": "processing",
  "status_update_time": 1762685256
}

​
Video Extensions

In the Grok unified video pipeline, segment extension is still submitted through POST /v1/videos/extensions (the same path as OpenAI-format Video Extensions), with the original task ID passed in video.url in the body.
  • The route entry is POST /v1/videos/extensions.
  • model, prompt, video, and start_time are required.
  • Set video.url to the original task ID, for example grok:f673ba58-b053-4d8d-8938-c0b429de4d7f.
  • After a successful submission, use Query Task to poll for results.

​
Method and Path

POST /v1/videos/extensions

​
Request Example

curl -X POST https://octopusx.ai/v1/videos/extensions \
  -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",
    "duration": 6,
    "start_time": 4,
    "video": {
      "url": "grok:f673ba58-b053-4d8d-8938-c0b429de4d7f"
    }
  }'

​
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 extension segment.
​
video
object
required
Reference to the original video, which must include the url field.
​
video.url
string
required
Original video task ID, the same as the id returned by unified Create Video.
​
start_time
integer
required
Segment start time (seconds).
​
duration
integer
Target extension duration (seconds). Defaults to 10, supports 6, 10, and 15.

​
Response

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

​
Difference Between Extend and Extensions Under Unified Video

ItemVideo ExtendVideo Extensions
PathPOST /v1/video/extendPOST /v1/videos/extensions
Original task IDBody task_idBody video.url
QueryQuery TaskQuery Task