Video Extend

Extend a segment from an existing Grok video task.

POST /v1/videos/video_abc123/extend

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 parameters

Name	Type	Required	Description
	string	Yes	Source video task ID.

Request body

Name	Type	Required	Description
	string	Yes	Model name. See Available models above.
	string	Yes	Prompt for the extended segment.
	array<string>	No	List of reference image URLs to add visual constraints as needed.
	string	No	Resolution tier: or . Apifox examples also use ; prefer uppercase .
	string	No	Aspect ratio; Apifox examples use values such as .
	integer	No	Second in the source video to start extending from.
	boolean	No	Whether to apply HD upscale to the output.

Request example

curl -X POST https://octopusx.ai/v1/videos/grok:48a67431-0708-46d1-9ab9-83cb84700153/extend \
  -H "Authorization: Bearer <token>" \
  -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 example

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

Response fields

Name	Type	Description
	string	New extend 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