Video Extensions

Extend a selected segment of a Grok video task.

POST /v1/videos/extensions

Available models

Headers

Name	Type	Required	Description
	string	Yes	Request authentication. Use a Bearer Token, for example: .
	string	Yes	Request content type. Must be set to .

Request body

Name	Type	Required	Description
	string	Yes	Model name. See Available models above.
	string	Yes	Prompt for the extended segment.
	object	Yes	Source video reference. Currently requires a field: the source video task ID (not a playable HTTP URL), for example .
	integer	Yes	Segment start time in seconds; extension begins from this point in the source video.
	integer	No	Target duration after extension in seconds. Default ; supports ,,.

Request example

curl -X POST https://octopusx.ai/v1/videos/extensions \
  -H "Authorization: Bearer <token>" \
  -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 example

{
  "id": "grok:48a67431-0708-46d1-9ab9-83cb84700153",
  "status": "processing",
  "status_update_time": 1762685256
}

Response fields

Name	Type	Description
	string	New extensions task ID.
	string	Task status. Common values include ,,.
	integer	Last status update time (Unix timestamp).

Related endpoints

• Grok video overview
• Video APIs overview
• Error codes