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

# Seedance 2.5 Flash

> Seedance 2.5 Flash API 可根据文本、首尾帧，或图片、视频、音频参考，生成 4–30 秒、带同步音频的 480p 或 720p 视频。

> [!TIP]
>
> 1. 提交后会返回 `task_id`。如果提供了 `callback_url`，当任务状态变为 `finished` 或 `failed` 时，系统会向 `callback_url` 发送 POST 请求。
> 2. 无论是否提供 `callback_url`，都可以通过统一的[查询任务状态](https://docs.poyo.ai/zh/api-manual/task-management/status.md)接口获取结果。

Seedance 2.5 Flash 是字节跳动 [Seedance 2.5](https://docs.poyo.ai/zh/api-manual/video-series/seedance-2.5.md) 的 Flash 版本，输出 `480p` 和 `720p`。它可以根据文本提示词生成 4–30 秒、带同步音频的视频，也可以让首帧（可加尾帧）动起来，或按图片、视频、音频参考生成视频。模式由传入的素材自动决定。

## 模型

* **seedance-2.5-flash** — 文生视频、首尾帧图生视频、多模态参考生视频，输出 `480p` 或 `720p`

## 功能

* **4–30 秒视频**：`duration` 可设为 4 到 30 之间的任意整数秒。
* **同步音频**：音频与视频同时生成。将 `generate_audio` 设为 `false` 时只生成视频。
* **首尾帧**：可以只给一张首帧，也可以同时给首帧和尾帧来决定镜头的结尾画面。
* **多模态参考**：最多 10 张参考图、5 个参考视频、5 段参考音频，共同引导视频内容。
* **宽高比**：`auto`、`21:9`、`16:9`、`4:3`、`1:1`、`3:4` 或 `9:16`。

## 输入模式

| 模式 | 触发条件 |
| - | - |
| 参考生视频 | `reference_image_urls`、`reference_video_urls` 或 `reference_audio_urls` 非空 |
| 图生视频 | `image_urls` 非空 |
| 文生视频 | 未传任何素材 |

`image_urls` 和参考素材字段请分开在不同请求中使用。图生视频时，`aspect_ratio` 设为 `auto` 或不传。

## 必填参数

* `prompt` (string)：视频描述。参考素材按上传顺序写作 `@Image1`、`@Video1`、`@Audio1`。
* `duration` (integer)：输出时长，4 到 30 秒。

## 可选参数

* `resolution` (string)：`480p` 或 `720p`。默认 `720p`。
* `aspect_ratio` (string)：`auto`、`21:9`、`16:9`、`4:3`、`1:1`、`3:4` 或 `9:16`。默认 `auto`，由模型自动选择。传 `image_urls` 时，`auto` 会沿用首帧的宽高比。
* `generate_audio` (boolean)：与视频同时生成同步音频。默认 `true`。
* `image_urls` (array of strings)：一张首帧，或依次传首帧和尾帧。JPEG、PNG 或 WebP，每张不超过 30 MB。
* `reference_image_urls` (array of strings)：最多 10 张参考图。JPEG、PNG 或 WebP，每张不超过 30 MB。
* `reference_video_urls` (array of strings)：最多 5 个参考视频。MP4 或 MOV，每个 2–30 秒、不超过 200 MB。
* `reference_audio_urls` (array of strings)：最多 5 段参考音频，需与 `reference_image_urls` 或 `reference_video_urls` 一起使用。MP3 或 WAV，每段 2–30 秒、不超过 15 MB。

## 示例

### 文生视频

```json theme={"dark"}
{
  "model": "seedance-2.5-flash",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "prompt": "One continuous 30-second story of the same young woman in a yellow raincoat delivering a handwritten letter across a small seaside town at dawn. 0-6s: wide aerial shot of the sleepy harbor town, fishing boats rocking, soft morning light; she rides an old bicycle down a cobblestone hill. 6-12s: tracking shot beside her as she weaves past a fish market, seagulls lifting off, a vendor waves at her. 12-18s: low-angle shot as she climbs a steep stone staircase carrying the bicycle, breathing hard, the letter tucked in her pocket. 18-24s: she knocks on a blue door at the top; an elderly man opens it and she hands him the letter. 24-30s: close-up of the man reading, his eyes filling with tears; he smiles and says softly, \"She remembered.\" Camera slowly pulls back to reveal the sunrise over the sea. Natural ambient sound: waves, gulls, bicycle bell, footsteps, gentle piano music. No subtitles, no on-screen text.",
    "duration": 30,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}
```

### 首尾帧

```json theme={"dark"}
{
  "model": "seedance-2.5-flash",
  "input": {
    "prompt": "Locked-off time-lapse of the red lakeside cabin: start from the summer evening in the first frame, let snow gradually cover the shore and the wooden dock as the sky darkens, and end exactly on the snowy night with the aurora in the last frame. Soft wind and crackling ice.",
    "image_urls": [
      "https://example.com/first-frame.jpg",
      "https://example.com/last-frame.jpg"
    ],
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "auto"
  }
}
```

### 参考生视频

```json theme={"dark"}
{
  "model": "seedance-2.5-flash",
  "input": {
    "prompt": "@Image1 is the ginger cat. It wears the yellow knitted scarf from @Image2 and is inside the bookstore from @Image3. On a rainy night the cat walks along a bookshelf, jumps down beside a reading lamp, and looks at the camera. Match the slow, cozy rhythm of @Audio1. No subtitles.",
    "reference_image_urls": [
      "https://example.com/cat.png",
      "https://example.com/scarf.png",
      "https://example.com/bookstore.png"
    ],
    "reference_audio_urls": [
      "https://example.com/rhythm.mp3"
    ],
    "duration": 6,
    "resolution": "480p",
    "aspect_ratio": "16:9"
  }
}
```

## 注意事项

* 参考视频合计最长 30 秒，参考音频合计最长 30 秒，两项总时长都在提交任务时校验。
* 参考素材编号从 1 开始，按对应输入数组的顺序排列。
* 需要 `1080p` 输出时，请使用 [Seedance 2.5](https://docs.poyo.ai/zh/api-manual/video-series/seedance-2.5.md)。
* 所有素材 URL 都必须可通过 HTTP 或 HTTPS 公开访问并可直接下载。


## OpenAPI

````yaml zh/api-manual/video-series/seedance-2-5-flash.json POST /api/generate/submit
openapi: 3.0.0
info:
  title: PoYo AI - Seedance 2.5 Flash API
  description: >-
    Seedance 2.5 Flash API 可根据文本、首尾帧，或图片、视频、音频参考，生成 4–30 秒、带同步音频的 480p 或 720p
    视频。
  version: 1.0.0
servers:
  - url: https://api.poyo.ai
    description: 生产环境
security:
  - BearerAuth: []
paths:
  /api/generate/submit:
    post:
      tags:
        - Seedance 2.5 Flash
      summary: 提交 Seedance 2.5 Flash 任务
      description: 根据文本、首帧（可加尾帧），或图片、视频、音频参考，生成 4–30 秒、带同步音频的视频
      operationId: submitSeedance25FlashTask
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubmitRequest'
            examples:
              text-to-video:
                summary: 文生视频
                value:
                  model: seedance-2.5-flash
                  input:
                    prompt: >-
                      One continuous 30-second story of the same young woman in
                      a yellow raincoat delivering a handwritten letter across a
                      small seaside town at dawn. 0-6s: wide aerial shot of the
                      sleepy harbor town, fishing boats rocking, soft morning
                      light; she rides an old bicycle down a cobblestone hill.
                      6-12s: tracking shot beside her as she weaves past a fish
                      market, seagulls lifting off, a vendor waves at her.
                      12-18s: low-angle shot as she climbs a steep stone
                      staircase carrying the bicycle, breathing hard, the letter
                      tucked in her pocket. 18-24s: she knocks on a blue door at
                      the top; an elderly man opens it and she hands him the
                      letter. 24-30s: close-up of the man reading, his eyes
                      filling with tears; he smiles and says softly, "She
                      remembered." Camera slowly pulls back to reveal the
                      sunrise over the sea. Natural ambient sound: waves, gulls,
                      bicycle bell, footsteps, gentle piano music. No subtitles,
                      no on-screen text.
                    duration: 30
                    resolution: 720p
                    aspect_ratio: '16:9'
                    generate_audio: true
              first-last-frame:
                summary: 首尾帧
                value:
                  model: seedance-2.5-flash
                  input:
                    prompt: >-
                      Locked-off time-lapse of the red lakeside cabin: start
                      from the summer evening in the first frame, let snow
                      gradually cover the shore and the wooden dock as the sky
                      darkens, and end exactly on the snowy night with the
                      aurora in the last frame. Soft wind and crackling ice.
                    image_urls:
                      - https://example.com/first-frame.jpg
                      - https://example.com/last-frame.jpg
                    duration: 5
                    resolution: 720p
                    aspect_ratio: auto
              reference-to-video:
                summary: 参考生视频
                value:
                  model: seedance-2.5-flash
                  input:
                    prompt: >-
                      @Image1 is the ginger cat. It wears the yellow knitted
                      scarf from @Image2 and is inside the bookstore from
                      @Image3. On a rainy night the cat walks along a bookshelf,
                      jumps down beside a reading lamp, and looks at the camera.
                      Match the slow, cozy rhythm of @Audio1. No subtitles.
                    reference_image_urls:
                      - https://example.com/cat.png
                      - https://example.com/scarf.png
                      - https://example.com/bookstore.png
                    reference_audio_urls:
                      - https://example.com/rhythm.mp3
                    duration: 6
                    resolution: 480p
                    aspect_ratio: '16:9'
      responses:
        '200':
          description: 任务提交成功
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubmitResponse'
        '400':
          description: 请求参数无效
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: 未授权：API Key 无效
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    SubmitRequest:
      type: object
      required:
        - model
        - input
      properties:
        model:
          type: string
          description: Seedance 2.5 Flash 模型标识
          enum:
            - seedance-2.5-flash
        callback_url:
          type: string
          format: uri
          description: 接收结果通知的 Webhook 回调 URL
          example: https://your-domain.com/callback
        input:
          type: object
          additionalProperties: false
          required:
            - prompt
            - duration
          properties:
            prompt:
              type: string
              minLength: 1
              description: 描述视频内容的文本提示词。参考素材按上传顺序写作 @Image1、@Video1、@Audio1。
              example: >-
                A small orange cat walks across a sunlit wooden table, then
                looks at the camera and meows softly.
            duration:
              type: integer
              minimum: 4
              maximum: 30
              description: 输出时长（秒），4 到 30。
              example: 5
            resolution:
              type: string
              enum:
                - 480p
                - 720p
              default: 720p
              description: 输出分辨率。默认 720p。
              example: 720p
            aspect_ratio:
              type: string
              enum:
                - auto
                - '21:9'
                - '16:9'
                - '4:3'
                - '1:1'
                - '3:4'
                - '9:16'
              default: auto
              description: 输出宽高比。默认 auto，由模型自动选择。传 image_urls 时使用 auto，输出沿用首帧的宽高比。
              example: '16:9'
            generate_audio:
              type: boolean
              default: true
              description: 与视频同时生成同步音频。默认 true。
              example: true
            image_urls:
              type: array
              minItems: 1
              maxItems: 2
              items:
                type: string
                format: uri
              description: >-
                按顺序传首帧和可选的尾帧。须为可公开访问的 HTTP 或 HTTPS 图片 URL，格式 JPEG、PNG 或
                WebP，每张不超过 30 MB。与
                reference_image_urls、reference_video_urls、reference_audio_urls
                分开使用。
              example:
                - https://example.com/first.jpg
                - https://example.com/last.jpg
            reference_image_urls:
              type: array
              minItems: 1
              maxItems: 10
              items:
                type: string
                format: uri
              description: >-
                最多 10 张参考图。须为可公开访问的 HTTP 或 HTTPS 图片 URL，格式 JPEG、PNG 或 WebP，每张不超过
                30 MB。
              example:
                - https://example.com/reference.jpg
            reference_video_urls:
              type: array
              minItems: 1
              maxItems: 5
              items:
                type: string
                format: uri
              description: >-
                最多 5 个参考视频。须为可公开访问的 HTTP 或 HTTPS 视频 URL，格式 MP4 或 MOV，每个 2–30
                秒、不超过 200 MB，合计时长不超过 30 秒。服务端在提交时校验合计时长。
              example:
                - https://example.com/reference.mp4
            reference_audio_urls:
              type: array
              minItems: 1
              maxItems: 5
              items:
                type: string
                format: uri
              description: >-
                最多 5 段参考音频，需与 reference_image_urls 或 reference_video_urls
                一起使用。须为可公开访问的 HTTP 或 HTTPS 音频 URL，格式 MP3 或 WAV，每段 2–30 秒、不超过 15
                MB，合计时长不超过 30 秒。服务端在提交时校验合计时长。
              example:
                - https://example.com/reference.mp3
    SubmitResponse:
      type: object
      required:
        - code
        - data
      properties:
        code:
          type: integer
          example: 200
          enum:
            - 200
            - 400
            - 401
            - 402
            - 403
            - 404
            - 408
            - 429
            - 500
            - 502
            - 503
          description: >-
            业务状态码。`200` 表示成功，其他值都表示请求失败。请务必检查这个字段：部分参数校验错误会以 HTTP 200 返回，响应体里的
            `code` 为 `400`。


            - `200`：成功

            - `400`：请求参数无效

            - `401`：API Key 缺失或无效

            - `402`：积分不足

            - `403`：没有权限

            - `404`：资源不存在

            - `408`：请求超时

            - `429`：请求频率超限

            - `500`：服务器内部错误

            - `502`：上游服务错误

            - `503`：服务暂不可用


            详见[错误码](/zh/api-manual/error-codes)。
        message:
          type: string
          example: success
        data:
          type: object
          required:
            - task_id
            - status
            - created_time
          properties:
            task_id:
              type: string
              example: task-unified-1757165031-uyujaw3d
            status:
              type: string
              enum:
                - not_started
                - running
                - finished
                - failed
              description: >-
                任务状态。提交后立即返回时始终为
                `not_started`。后续状态请通过[查询任务状态](/zh/api-manual/task-management/status)接口或
                `callback_url` 获取。


                - `not_started`：排队中，等待处理

                - `running`：生成中

                - `finished`：已完成，结果在 `files` 或 `output` 中

                - `failed`：失败，详情见 `error_message`
            created_time:
              type: string
              format: date-time
    ErrorResponse:
      type: object
      required:
        - code
        - error
      properties:
        code:
          type: integer
          example: 400
          enum:
            - 200
            - 400
            - 401
            - 402
            - 403
            - 404
            - 408
            - 429
            - 500
            - 502
            - 503
          description: >-
            业务状态码。`200` 表示成功，其他值都表示请求失败。请务必检查这个字段：部分参数校验错误会以 HTTP 200 返回，响应体里的
            `code` 为 `400`。


            - `200`：成功

            - `400`：请求参数无效

            - `401`：API Key 缺失或无效

            - `402`：积分不足

            - `403`：没有权限

            - `404`：资源不存在

            - `408`：请求超时

            - `429`：请求频率超限

            - `500`：服务器内部错误

            - `502`：上游服务错误

            - `503`：服务暂不可用


            详见[错误码](/zh/api-manual/error-codes)。
        error:
          type: object
          required:
            - message
            - type
          properties:
            message:
              type: string
              example: Invalid request parameters
            type:
              type: string
              example: invalid_request_error
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        所有 API 接口都需要 Bearer Token 认证。


        创建 API Key：登录 PoYo，进入 **仪表盘 → API
        密钥**（[poyo.ai/zh/dashboard/api-key](https://poyo.ai/zh/dashboard/api-key)），点击创建
        Key。


        在请求头中添加：


        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.