Video Extend
Use `POST /v1/videos/{video_id}/extend` to extend a segment based on an existing Grok video task.
https://zx1.deepwl.net/v1/videos/{video_id}/extendcurl -X POST https://zx1.deepwl.net/v1/videos/grok:48a67431-0708-46d1-9ab9-83cb84700153/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",
"aspect_ratio": "3:2",
"start_time": 4,
"size": "1080P",
"upscale": true
}'{
"id": "grok:48a67431-0708-46d1-9ab9-83cb84700153",
"status": "processing",
"status_update_time": 1762685256
}OpenAI format entry point. For unified videos, please use Video Extend (Unified Video) (POST /v1/video/extend, pass task_id in the Body).
Based on an existing Grok video task, extend the video content from a specified point in time via POST /v1/videos/{video_id}/extend.
- The path parameter
video_idis the original task ID. - The request body is JSON, with required
modelandprompt. - You can specify the second in the original video to start extending from via
start_time, and supplement reference images throughimages.
Request Headers
Authorizationstring必填Authentication header. Uses a Bearer token, e.g. Bearer YOUR_API_KEY.
Content-Typestring必填Request content type, must be application/json.
Path Parameters
video_idstring必填Original video task ID.
Request Body
modelstring必填Model name, for example grok-video-3.
promptstring必填Prompt for the extended segment.
imagesarray<string>List of reference image URLs, used to add visual constraints as needed.
sizestringResolution specification, pass 720P or 1080P. The Apifox example also uses 1080p; it is recommended to standardize on uppercase 1080P.
aspect_ratiostringVideo ratio, with values such as 3:2 used in the Apifox example.
start_timeintegerThe second in the original video from which to start extending.
upscalebooleanWhether to apply HD enhancement to the output.
Request Examples
Response Examples
Response Fields
idstringNew extend task ID.
statusstringTask status. Common values include processing, completed, and failed.
status_update_timeintegerMost recent status update time (Unix timestamp).