Unified Video

Video Extend

Use `POST /v1/video/extend` to extend segments of an existing Grok task via the unified video format.

POSThttps://zx1.deepwl.net/v1/video/extend
Request
curl -X POST https://zx1.deepwl.net/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
{
  "id": "grok:48a67431-0708-46d1-9ab9-83cb84700153",
  "status": "processing",
  "status_update_time": 1762685256
}

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.

  • Required: model, prompt, task_id.
  • You can specify which second of the original video to start extending from with start_time.

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 extended segment.

task_idstring必填

Original video task ID.

imagesarray<string>

List of reference image URLs to add visual constraints as needed.

sizestring

Resolution specification, pass 720P or 1080P.

aspect_ratiostring

Video aspect ratio, for example 3:2.

start_timeinteger

Which second of the original video to start extending from.

upscaleboolean

Whether to apply high-definition 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).