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

> ## Agent Instructions
> Public hosts only: console https://omnimux.ai/dashboard · API https://api.omnimux.ai · docs https://docs.omnimux.ai.
> Gateway auth is Authorization: Bearer sk-… on https://api.omnimux.ai/v1 (OpenAI-compatible Chat Completions and related paths).
> Discover pages from /llms.txt; full site dump /llms-full.txt; product skill /skill.md; docs search MCP /mcp. Prefer .md page URLs for Markdown.
> Default docs locale is en; zh mirrors the same relative paths. Do not invent model ids not present on live pricing or the complete API pages.

# Seedance 2.5 视频生成

> Seedance 2.5 视频生成 · model `seedance-2-5`

* 创建：`POST /v1/video/generations`，`model` 可选 `seedance-2-5`（标准通道）或 `seedance-2-5-task`（按次任务固定计费通道）
* 异步任务：用返回的 `task_id` 查询 [查询视频任务](/zh/api-reference/tasks/video-task)
* 产物 URL 请及时落盘（上游链接可能有时效）

## 身份

| 字段    | 值                                   |
| ----- | ----------------------------------- |
| 系列    | 视频系列                                |
| 品牌    | Seedance                            |
| model | `seedance-2-5`, `seedance-2-5-task` |

## 接口

| 方法     | 路径                                |
| ------ | --------------------------------- |
| `POST` | `/v1/video/generations`           |
| `GET`  | `/v1/video/generations/{task_id}` |

Base URL：`https://api.omnimux.ai`

## 鉴权

| 名称              | 位置     | 类型     | 必填 | 说明                       |
| --------------- | ------ | ------ | -- | ------------------------ |
| `Authorization` | header | string | 是  | `Bearer sk-...`（API Key） |

## 请求体

| 字段                     | 类型           | 必填 | 说明                 |
| ---------------------- | ------------ | -- | ------------------ |
| `model`                | string       | 是  | 固定为 `seedance-2-5` |
| `prompt`               | string       | 条件 | 文生视频时必填            |
| `seconds` / `duration` | number       | 否  | 时长（秒，受模型与网关上限约束）   |
| `size` / `resolution`  | string       | 否  | 分辨率（模型相关）          |
| `image` / `images`     | string/array | 否  | 图生视频参考图（模型相关）      |

## 响应

### 200（创建）

| 字段        | 类型     | 说明                                       |
| --------- | ------ | ---------------------------------------- |
| `task_id` | string | 任务 id，用于轮询                               |
| `status`  | string | 如 `pending` / `processing` / `completed` |

轮询字段见 [查询视频任务](/zh/api-reference/tasks/video-task)。错误见右栏与 [错误码](/zh/faqs/connection-usage)。

<Panel>
  <RequestExample>
    ```bash cURL theme={null}
    curl --request POST \
      --url https://api.omnimux.ai/v1/video/generations \
      --header 'Authorization: Bearer <token>' \
      --header 'Content-Type: application/json' \
      --data '{
      "model": "seedance-2-5",
      "prompt": "slow pan across a product on a table"
    }'
    ```
  </RequestExample>

  <ResponseExample>
    ```json 200 theme={null}
    {
      "task_id": "task_01HXYZABCDEF",
      "status": "queued"
    }
    ```

    ```json 400 theme={null}
    {
      "error": { "message": "Invalid request", "type": "invalid_request_error", "code": "bad_request" }
    }
    ```

    ```json 401 theme={null}
    {
      "error": { "message": "Invalid token", "type": "authentication_error", "code": "unauthorized" }
    }
    ```

    ```json 402 theme={null}
    {
      "error": {
        "message": "Insufficient quota. Please top up your account.",
        "type": "insufficient_quota",
        "code": "insufficient_quota"
      }
    }
    ```

    ```json 403 theme={null}
    {
      "error": { "message": "Model not allowed", "type": "permission_error", "code": "forbidden" }
    }
    ```

    ```json 429 theme={null}
    {
      "error": { "message": "Rate limit exceeded", "type": "rate_limit_error", "code": "rate_limit_exceeded" }
    }
    ```

    ```json 500 theme={null}
    {
      "error": { "message": "Internal server error", "type": "server_error", "code": "internal_error" }
    }
    ```
  </ResponseExample>
</Panel>