> ## Documentation Index
> Fetch the complete documentation index at: https://doc.octopusx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Video Extend

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

# Video Extend

OpenAI format entry point. For unified videos, please use [Video Extend (Unified Video)](./unified-extend) (`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`.

## Method and Path

```http theme={null}
POST /v1/videos/{video_id}/extend
```

## Request Example

<CodeGroup>
  ```bash theme={null}
  curl -X POST https://octopusx.ai/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
    }'
  ```

  ```python theme={null}
  import requests

  video_id = "grok:48a67431-0708-46d1-9ab9-83cb84700153"

  resp = requests.post(
      f"https://octopusx.ai/v1/videos/{video_id}/extend",
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
          "Accept": "application/json",
      },
      json={
          "model": "grok-video-3",
          "prompt": "play with another white cat",
          "aspect_ratio": "3:2",
          "start_time": 4,
          "size": "1080P",
          "upscale": True,
      },
      timeout=60,
  )
  print(resp.json())
  ```

  ```javascript theme={null}
  const videoId = "grok:48a67431-0708-46d1-9ab9-83cb84700153";

  const response = await fetch(
    `https://octopusx.ai/v1/videos/${encodeURIComponent(videoId)}/extend`,
    {
      method: "POST",
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
        Accept: "application/json",
      },
      body: JSON.stringify({
        model: "grok-video-3",
        prompt: "play with another white cat",
        aspect_ratio: "3:2",
        start_time: 4,
        size: "1080P",
        upscale: true,
      }),
    }
  );

  console.log(await response.json());
  ```
</CodeGroup>

## Response Example

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "grok:48a67431-0708-46d1-9ab9-83cb84700153",
    "status": "processing",
    "status_update_time": 1762685256
  }
  ```
</ResponseExample>

## Authentication

```http theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Path Parameters

<ParamField path="video_id" type="string" required>
  Original video task ID.
</ParamField>

## Body

<ParamField body="model" type="string" required>
  Model name, for example `grok-video-3`.
</ParamField>

<ParamField body="prompt" type="string" required>
  Prompt for the extended segment.
</ParamField>

<ParamField body="images" type="array<string>">
  List of reference image URLs, used to add visual constraints as needed.
</ParamField>

<ParamField body="size" type="string">
  Resolution specification, pass `720P` or `1080P`. The Apifox example also uses `1080p`; it is recommended to standardize on uppercase `1080P`.
</ParamField>

<ParamField body="aspect_ratio" type="string">
  Video ratio, with values such as `3:2` used in the Apifox example.
</ParamField>

<ParamField body="start_time" type="integer">
  The second in the original video from which to start extending.
</ParamField>

<ParamField body="upscale" type="boolean">
  Whether to apply HD enhancement to the output.
</ParamField>

## Response

<ResponseField name="id" type="string">
  New extend task ID.
</ResponseField>

<ResponseField name="status" type="string">
  Task status. Common values include `processing`, `completed`, and `failed`.
</ResponseField>

<ResponseField name="status_update_time" type="integer">
  Most recent status update time (Unix timestamp).
</ResponseField>

## Related APIs

* [Grok Video Overview](./overview)
* [Grok Video Generation](./generation)
* [Video Remix](./remix)
* [Video Extensions](./extensions)
* [Grok Task Query](./query)
* [Video Extend (Unified Video)](./unified-extend)