OpenAI Format

Video Extend

Use `POST /v1/videos/{video_id}/extend` to extend a segment based on an existing Grok video task.

POSThttps://zx1.deepwl.net/v1/videos/{video_id}/extend
Request
curl -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
}'
Response
{
  "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_id is the original task ID.
  • The request body is JSON, with required model and prompt.
  • You can specify the second in the original video to start extending from via start_time, and supplement reference images through images.

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.

sizestring

Resolution specification, pass 720P or 1080P. The Apifox example also uses 1080p; it is recommended to standardize on uppercase 1080P.

aspect_ratiostring

Video ratio, with values such as 3:2 used in the Apifox example.

start_timeinteger

The second in the original video from which to start extending.

upscaleboolean

Whether to apply HD enhancement to the output.

Request Examples

Response Examples

Response Fields

idstring

New extend task ID.

statusstring

Task status. Common values include processing, completed, and failed.

status_update_timeinteger

Most recent status update time (Unix timestamp).