Unified Video

Video Extensions

Use `POST /v1/videos/extensions` to perform segment extension for Grok tasks under the unified video pipeline.

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

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.

  • 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.

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, which must include the url field.

urlstring必填

Original video task ID, the same as the id returned by unified Create Video.

start_timeinteger必填

Segment start time (seconds).

durationinteger

Target extension duration (seconds). Defaults to 10, supports 6, 10, and 15.

Request Examples

Response Examples

Response Fields

idstring

New extensions task ID.

statusstring

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

status_update_timeinteger

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