> ## Documentation Index > Fetch the complete documentation index at: https://docs.omniall.ai/llms.txt > Use this file to discover all available pages before exploring further. # 创建视频 > Seedance（含 2.0 / 2.5）异步创建视频。 **路径：** `POST https://api.omniall.ai/v1/video/generations` 也可用 `POST /v1/videos`（部分客户端路径）。创建成功后用返回的 `id` / `task_id` 轮询查询接口。 模型 ID 以[模型广场](https://omniall.ai/pricing)与 [Seedance 状态页](https://omniall.ai/seedance-status)为准。常用：`db-sd2.0-1080p`、`db-sd2.0-720p`、`db-sd2.0-480p`、`db-sd2.0-4k`、`db-sd2.0-fast-720p`、`db-sd2.0-fast-480p`、`db-sd2.0-mini-720p`、`db-sd2.0-mini-480p`、`db-sd2.5-1080p`、`db-sd2.5-720p`、`db-sd2.5-480p`，以及 `doubao-seedance-2-0-260128-1080p`、`doubao-seedance-2-0-260128-720p`、`doubao-seedance-2-0-fast-260128-720p`、`doubao-seedance-2-0-fast-260128-480p` 等。 鉴权：`Authorization: Bearer sk-...` ## OpenAPI ````yaml zh-CN/openapi/seedance-video.yaml POST /v1/video/generations openapi: 3.1.0 info: title: Omniall AI — Seedance 视频 version: 1.0.0 description: >- Seedance（含 2.0 / 2.5）异步创建视频。 **路径：** `POST https://api.omniall.ai/v1/video/generations` 也可用 `POST /v1/videos`（部分客户端路径）。创建成功后用返回的 `id` / `task_id` 轮询查询接口。 模型 ID 以[模型广场](https://omniall.ai/pricing)与 [Seedance 状态页](https://omniall.ai/seedance-status)为准。常用：`db-sd2.0-1080p`、`db-sd2.0-720p`、`db-sd2.0-480p`、`db-sd2.0-4k`、`db-sd2.0-fast-720p`、`db-sd2.0-fast-480p`、`db-sd2.0-mini-720p`、`db-sd2.0-mini-480p`、`db-sd2.5-1080p`、`db-sd2.5-720p`、`db-sd2.5-480p`，以及 `doubao-seedance-2-0-260128-1080p`、`doubao-seedance-2-0-260128-720p`、`doubao-seedance-2-0-fast-260128-720p`、`doubao-seedance-2-0-fast-260128-480p` 等。 鉴权：`Authorization: Bearer sk-...` servers: - url: https://api.omniall.ai security: [] paths: /v1/video/generations: post: tags: - Seedance summary: 创建视频 description: >- Seedance（含 2.0 / 2.5）异步创建视频。 **路径：** `POST https://api.omniall.ai/v1/video/generations` 也可用 `POST /v1/videos`（部分客户端路径）。创建成功后用返回的 `id` / `task_id` 轮询查询接口。 模型 ID 以[模型广场](https://omniall.ai/pricing)与 [Seedance 状态页](https://omniall.ai/seedance-status)为准。常用：`db-sd2.0-1080p`、`db-sd2.0-720p`、`db-sd2.0-480p`、`db-sd2.0-4k`、`db-sd2.0-fast-720p`、`db-sd2.0-fast-480p`、`db-sd2.0-mini-720p`、`db-sd2.0-mini-480p`、`db-sd2.5-1080p`、`db-sd2.5-720p`、`db-sd2.5-480p`，以及 `doubao-seedance-2-0-260128-1080p`、`doubao-seedance-2-0-260128-720p`、`doubao-seedance-2-0-fast-260128-720p`、`doubao-seedance-2-0-fast-260128-480p` 等。 鉴权：`Authorization: Bearer sk-...` operationId: seedanceCreateVideo parameters: - name: Authorization in: header required: true schema: type: string example: Bearer sk-... description: Bearer API Key，例如 `Bearer sk-...`。 requestBody: required: true content: application/json: schema: type: object required: - model - prompt description: Seedance / 豆包视频异步创建请求（`POST /v1/video/generations`）。 properties: model: type: string description: >- 视频模型 ID。模型 ID 以[模型广场](https://omniall.ai/pricing)与 [Seedance 状态页](https://omniall.ai/seedance-status)为准。常用：`db-sd2.0-1080p`、`db-sd2.0-720p`、`db-sd2.0-480p`、`db-sd2.0-4k`、`db-sd2.0-fast-720p`、`db-sd2.0-fast-480p`、`db-sd2.0-mini-720p`、`db-sd2.0-mini-480p`、`db-sd2.5-1080p`、`db-sd2.5-720p`、`db-sd2.5-480p`，以及 `doubao-seedance-2-0-260128-1080p`、`doubao-seedance-2-0-260128-720p`、`doubao-seedance-2-0-fast-260128-720p`、`doubao-seedance-2-0-fast-260128-480p` 等。 example: db-sd2.5-1080p prompt: type: string description: >- 视频描述文本。写清主体、场景、镜头运动与风格。也可用 `content` 中 `type=text` 提供（与顶层 `prompt` 二选一）。 example: 城市夜景，镜头沿湿润街道缓慢向前，霓虹倒映在路面 duration: type: integer description: 时长（秒），常见 4–15。编辑类任务可用 `-1` 表示跟随参考视频时长。也可用字符串字段 `seconds`。 example: 5 seconds: type: string description: 时长（秒）的字符串写法，与 `duration` 等价；同时存在时以可解析的秒数为准。 example: '5' ratio: type: string description: 画幅比例。也兼容 `size`、`aspect_ratio`。 enum: - '21:9' - '16:9' - '4:3' - '1:1' - '3:4' - '9:16' example: '16:9' size: type: string description: '`ratio` 的别名（如 `16:9`）。优先使用 `ratio`。' aspect_ratio: type: string description: '`ratio` 的别名。' images: type: array items: type: string description: 参考图 URL 列表（多图参考）。有首/尾帧时不要再混用 `images`（首尾帧优先，`images` 会被忽略）。 image: type: string description: 单张参考图 URL，等同 `images` 仅一张。 first_frame: description: 首帧图。可为 URL 字符串，或 URL 数组。别名：`start_frame`、`first_frame_url`。 oneOf: - type: string - type: array items: type: string last_frame: description: 尾帧图。可为 URL 字符串，或 URL 数组。别名：`end_frame`、`last_frame_url`。 oneOf: - type: string - type: array items: type: string start_frame: description: '`first_frame` 别名。' oneOf: - type: string - type: array items: type: string end_frame: description: '`last_frame` 别名。' oneOf: - type: string - type: array items: type: string reference_images: type: array items: type: string description: 参考图 URL 列表（与 `images` 同类，可并用）。 reference_videos: type: array items: type: string description: >- 参考视频 URL 列表（全能参考 / 运镜参考）。别名字段：`reference_video_urls`、`videos`。 reference_audios: type: array items: type: string description: 参考音频 URL 列表。别名：`reference_audio_urls`、`audios`、`audio_url`。 generate_audio: type: boolean description: 是否生成/输出音频轨（音画同步）。也可写在 `extra_body.generate_audio`。 example: true extra_body: type: object description: 扩展字段。常用 `generate_audio`。 additionalProperties: true omni_reference_task_type: type: string description: '全能参考任务类型（如 `edit`）。编辑跟随原视频时长时常配合 `duration: -1`。' example: edit content: type: array description: 多模态 content 数组写法（与顶层 reference_* / images 等价，可选用）。 items: type: object properties: type: type: string enum: - text - image_url - video_url - audio_url description: 部件类型。 text: type: string description: 当 `type=text` 时的提示词。 url: type: string description: 媒体 URL（简化写法）。 role: type: string description: >- 角色：`reference_image` / `reference_video` / `reference_audio` / `first_frame` / `last_frame` 等。 image_url: type: object additionalProperties: true video_url: type: object additionalProperties: true audio_url: type: object additionalProperties: true examples: 文生视频: summary: 文生视频 value: model: db-sd2.5-1080p prompt: 城市夜景，镜头沿湿润街道缓慢向前，霓虹倒映在路面，电影感浅景深 duration: 5 ratio: '16:9' generate_audio: true 多图参考: summary: 多图参考 value: model: db-sd2.0-1080p prompt: 参考这些图片的角色外观与服装，生成一段角色转身走动的镜头 duration: 5 ratio: '16:9' images: - https://example.com/character-front.jpg - https://example.com/character-side.jpg generate_audio: true 全能参考多模态: summary: 全能参考多模态 value: model: db-sd2.5-1080p prompt: 保持产品外观一致，镜头运动参考视频，节奏对齐音频 duration: 10 ratio: '16:9' reference_images: - https://example.com/product.png reference_videos: - https://example.com/motion-guide.mp4 reference_audios: - https://example.com/music-guide.mp3 generate_audio: true 首尾帧: summary: 首尾帧 value: model: db-sd2.0-720p prompt: 从清晨到黄昏，云层缓慢流动，光线自然过渡 duration: 5 ratio: '16:9' first_frame: https://example.com/morning.png last_frame: https://example.com/dusk.png 首尾帧写法2: summary: 首尾帧 · 写法2（数组） value: model: db-sd2.0-720p prompt: 从清晨到黄昏，云层缓慢流动 duration: 5 ratio: '16:9' start_frame: - https://example.com/morning.png end_frame: - https://example.com/dusk.png 首尾帧写法3: summary: 首尾帧 · 写法3（content） value: model: db-sd2.5-720p prompt: 云层流动，光线过渡 duration: 5 ratio: '16:9' content: - type: image_url url: https://example.com/morning.png role: first_frame - type: image_url url: https://example.com/dusk.png role: last_frame content多模态: summary: content 多模态写法 value: model: doubao-seedance-2-0-260128-720p content: - type: text text: 保持产品外观一致 - type: image_url url: https://example.com/product.png role: reference_image - type: video_url url: https://example.com/motion-guide.mp4 role: reference_video - type: audio_url url: https://example.com/music-guide.mp3 role: reference_audio duration: 10 aspect_ratio: '16:9' extra_body: generate_audio: true responses: '200': description: 任务已接受。使用 `id` 或 `task_id` 轮询查询接口。 content: application/json: schema: type: object properties: id: type: string description: 任务 ID（轮询用）。 task_id: type: string description: 任务 ID（与 `id` 同义）。 object: type: string status: type: string description: 任务状态。 progress: description: 进度（百分比或数值）。 created_at: type: integer example: id: task_MVPe8uCjxrxe8szgdZWJvRub0ccg8gi0 task_id: task_MVPe8uCjxrxe8szgdZWJvRub0ccg8gi0 status: submitted created_at: 1710000000 '400': description: 请求无效 '401': description: 未授权 '429': description: 限流 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.