Video Extensions
Use `POST /v1/videos/extensions` to extend a segment of a specified Grok video task.
https://zx1.deepwl.net/v1/videos/extensionscurl -X POST https://zx1.deepwl.net/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"
}
}'{
"id": "grok:48a67431-0708-46d1-9ab9-83cb84700153",
"status": "processing",
"status_update_time": 1762685256
}The OpenAI format shares the POST /v1/videos/extensions path with Unified Video. For an explanation of the Unified Video flow, see Video Extensions (Unified Video).
Use POST /v1/videos/extensions to extend a specified segment of an existing video task; pass the original task ID in video.url in the Body.
- The route entry is
POST /v1/videos/extensions. - Required fields:
model,prompt,video,start_time. - Set
video.urlto the original video task ID, for examplegrok:f673ba58-b053-4d8d-8938-c0b429de4d7f.
Request Headers
Authorizationstring必填Authentication header. Uses a Bearer token, e.g. Bearer YOUR_API_KEY.
Content-Typestring必填Request content type, must be application/json.
Request Body
modelstring必填Model name, for example grok-video-3.
promptstring必填Prompt for the extension segment.
videoobject必填Reference to the original video. Currently requires the url field.
urlstring必填Original video task ID (not a playable HTTP link), for example grok:f673ba58-b053-4d8d-8938-c0b429de4d7f.
start_timeinteger必填Segment start time (seconds); extend from this timestamp in the original video.
durationintegerTarget duration after extension (seconds). Default is 10; supports 6, 10, and 15.
Request Examples
Response Examples
Response Fields
idstringNew extensions task ID.
statusstringTask status; common values include processing, completed, and failed.
status_update_timeintegerMost recent status update time (Unix timestamp).
Difference Between Extend and Extensions
| Item | Video Extend | Video Extensions |
|---|---|---|
| Path | POST /v1/videos/{video_id}/extend | POST /v1/videos/extensions |
| Original task ID | Path parameter video_id | Body video.url |
| Typical scenario | Extend based on the path-bound original task | Independent entry point, suitable for batch or orchestration calls |