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

# 视频Remix

> 使用 `POST /v1/videos/{video_id}/remix` 基于已有 Grok 视频任务提交 remix。

# 视频Remix

OpenAI 格式入口。统一视频请使用 [视频Remix（统一视频）](./unified-remix)（`POST /v1/video/remix`，Body 传 `task_id`）。

在已有 Grok 视频任务基础上，通过 `POST /v1/videos/{video_id}/remix` 提交 remix 任务，用新的提示词与画幅参数生成变体。

* 路径参数 `video_id` 为原始视频任务 ID。
* 请求体为 JSON，需同时提供 `model`、`prompt`、`size`、`aspect_ratio`。
* 提交成功后返回新任务 `id` 与 `status`，请用 [Grok 任务查询](./query) 或统一视频的 [查询任务](./unified-query) 轮询（取决于原任务所属链路）。

## 方法与路径

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

## 请求示例

<CodeGroup>
  ```bash theme={null}
  curl -X POST https://octopusx.ai/v1/videos/grok:48a67431-0708-46d1-9ab9-83cb84700153/remix \
    -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",
      "size": "1080P",
      "parent_post_id": "5afc6f67-23fe-4a74-a073-727ff662f870"
    }'
  ```

  ```python theme={null}
  import requests

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

  resp = requests.post(
      f"https://octopusx.ai/v1/videos/{video_id}/remix",
      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",
          "size": "1080P",
          "parent_post_id": "5afc6f67-23fe-4a74-a073-727ff662f870",
      },
      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)}/remix`,
    {
      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",
        size: "1080P",
        parent_post_id: "5afc6f67-23fe-4a74-a073-727ff662f870",
      }),
    }
  );

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

## 响应示例

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

## 认证

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

## Path Parameters

<ParamField path="video_id" type="string" required>
  源视频任务 ID，与 [Grok 视频生成](./generation) 或查询接口返回的 `id` 一致。
</ParamField>

## Body

<ParamField body="model" type="string" required>
  模型名称，例如 `grok-video-3`。
</ParamField>

<ParamField body="prompt" type="string" required>
  Remix 提示词，描述希望如何改写或延续原视频内容。
</ParamField>

<ParamField body="size" type="string" required>
  分辨率规格，传 `720P` 或 `1080P`。
</ParamField>

<ParamField body="aspect_ratio" type="string" required>
  视频比例，可选 `2:3`、`3:2`、`1:1`。
</ParamField>

<ParamField body="parent_post_id" type="string">
  父任务 ID。
</ParamField>

## Response

<ResponseField name="id" type="string">
  新 remix 任务 ID。
</ResponseField>

<ResponseField name="status" type="string">
  任务状态，常见值包括 `processing`、`completed`、`failed`。
</ResponseField>

<ResponseField name="status_update_time" type="integer">
  状态最近更新时间（Unix 时间戳）。
</ResponseField>

## 相关接口

* [Grok 视频概览](./overview)
* [Grok 视频生成](./generation)
* [视频Extend](./extend)
* [视频Extensions](./extensions)
* [Grok 任务查询](./query)
* [视频Remix（统一视频）](./unified-remix)