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

> The Seedance 2.5 Flash API generates a 4–30 second video with synchronized audio from text, first and last frames, or image, video, and audio references at 480p or 720p.

> [!TIP]
>
> 1. After submission, a `task_id` will be returned. If you provided a `callback_url`, when the task status becomes `finished` or `failed`, a POST request will be sent to the `callback_url`.
> 2. Regardless of whether `callback_url` is provided, you can retrieve the response result through the unified [Query Task Status](https://docs.poyo.ai/api-manual/task-management/status.md) endpoint.

Seedance 2.5 Flash is the Flash tier of ByteDance [Seedance 2.5](https://docs.poyo.ai/api-manual/video-series/seedance-2.5.md), with `480p` and `720p` output. It creates 4–30 second videos with synchronized audio from a text prompt, animates a first frame with an optional last frame, or follows image, video, and audio references. The supplied media selects the mode automatically.

## Models

* **seedance-2.5-flash** — Text-to-video, first/last-frame image-to-video, and multimodal reference-to-video at `480p` or `720p`

## Features

* **4–30 second videos**: Set `duration` to any whole number of seconds from 4 to 30.
* **Synchronized audio**: Audio is generated in the same pass as the video. Set `generate_audio` to `false` for video only.
* **First and last frames**: Start from one image, or supply a first and a last frame to define how the shot ends.
* **Multimodal references**: Guide the video with up to 10 reference images, 5 reference videos, and 5 reference audio clips.
* **Aspect ratios**: `auto`, `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, or `9:16`.

## Input modes

| Mode | Selected when |
| - | - |
| Reference-to-video | `reference_image_urls`, `reference_video_urls`, or `reference_audio_urls` is non-empty |
| Image-to-video | `image_urls` is non-empty |
| Text-to-video | No media is provided |

Use `image_urls` and the reference fields in separate requests. In image-to-video, set `aspect_ratio` to `auto` or omit it.

## Required parameters

* `prompt` (string): Video instructions. Refer to reference media by upload order as `@Image1`, `@Video1`, and `@Audio1`.
* `duration` (integer): Output duration from 4 to 30 seconds.

## Optional parameters

* `resolution` (string): `480p` or `720p`. Default: `720p`.
* `aspect_ratio` (string): `auto`, `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, or `9:16`. Default: `auto`, which lets the model choose. With `image_urls`, `auto` follows the aspect ratio of the first frame.
* `generate_audio` (boolean): Generates synchronized audio with the video. Default: `true`.
* `image_urls` (array of strings): A first frame, or a first frame followed by a last frame. JPEG, PNG, or WebP, up to 30 MB each.
* `reference_image_urls` (array of strings): Up to 10 reference images. JPEG, PNG, or WebP, up to 30 MB each.
* `reference_video_urls` (array of strings): Up to 5 reference videos. MP4 or MOV, 2–30 seconds and up to 200 MB each.
* `reference_audio_urls` (array of strings): Up to 5 reference audio clips, used together with `reference_image_urls` or `reference_video_urls`. MP3 or WAV, 2–30 seconds and up to 15 MB each.

## Examples

### Text to Video

```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
  }
}
```

### First and Last Frame

```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"
  }
}
```

### Reference to Video

```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"
  }
}
```

## Notes

* Reference videos together can last up to 30 seconds, and reference audio clips together can last up to 30 seconds. Both totals are checked when the task is submitted.
* Reference indexes start at 1 and follow the order of the corresponding input array.
* For `1080p` output, use [Seedance 2.5](https://docs.poyo.ai/api-manual/video-series/seedance-2.5.md).
* All media URLs must be publicly accessible over HTTP or HTTPS and directly downloadable.


## OpenAPI

````yaml 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: >-
    The Seedance 2.5 Flash API generates a 4–30 second video from text, first
    and last frames, or image, video, and audio references at 480p or 720p, with
    synchronized audio.
  version: 1.0.0
servers:
  - url: https://api.poyo.ai
    description: Production server
security:
  - BearerAuth: []
paths:
  /api/generate/submit:
    post:
      tags:
        - Seedance 2.5 Flash
      summary: Submit Seedance 2.5 Flash Task
      description: >-
        Generate a 4–30 second video with synchronized audio from text, a first
        frame and optional last frame, or image, video, and audio references
      operationId: submitSeedance25FlashTask
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubmitRequest'
            examples:
              text-to-video:
                summary: Text to video
                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: First and last frame
                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: Reference to video
                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: Task submitted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubmitResponse'
        '400':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized - Invalid 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 model identifier
          enum:
            - seedance-2.5-flash
        callback_url:
          type: string
          format: uri
          description: Webhook callback URL for result notifications
          example: https://your-domain.com/callback
        input:
          type: object
          additionalProperties: false
          required:
            - prompt
            - duration
          properties:
            prompt:
              type: string
              minLength: 1
              description: >-
                Text prompt describing the video. Refer to reference media in
                upload order as @Image1, @Video1, and @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: Output duration in seconds, from 4 to 30.
              example: 5
            resolution:
              type: string
              enum:
                - 480p
                - 720p
              default: 720p
              description: Output resolution. Default is 720p.
              example: 720p
            aspect_ratio:
              type: string
              enum:
                - auto
                - '21:9'
                - '16:9'
                - '4:3'
                - '1:1'
                - '3:4'
                - '9:16'
              default: auto
              description: >-
                Output aspect ratio. Default is auto, which lets the model
                choose. Use auto when image_urls is provided; the output then
                follows the aspect ratio of the first frame.
              example: '16:9'
            generate_audio:
              type: boolean
              default: true
              description: Generates synchronized audio with the video. Default is true.
              example: true
            image_urls:
              type: array
              minItems: 1
              maxItems: 2
              items:
                type: string
                format: uri
              description: >-
                First frame and optional last frame, in order. Publicly
                accessible HTTP or HTTPS JPEG, PNG, or WebP image URLs, each up
                to 30 MB. Use without reference_image_urls,
                reference_video_urls, and 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: >-
                Up to 10 reference images. Publicly accessible HTTP or HTTPS
                JPEG, PNG, or WebP image URLs, each up to 30 MB.
              example:
                - https://example.com/reference.jpg
            reference_video_urls:
              type: array
              minItems: 1
              maxItems: 5
              items:
                type: string
                format: uri
              description: >-
                Up to 5 reference videos. Publicly accessible HTTP or HTTPS MP4
                or MOV URLs, each 2–30 seconds and up to 200 MB, with a combined
                duration of at most 30 seconds. The server checks the combined
                duration at submission.
              example:
                - https://example.com/reference.mp4
            reference_audio_urls:
              type: array
              minItems: 1
              maxItems: 5
              items:
                type: string
                format: uri
              description: >-
                Up to 5 reference audio clips, used together with
                reference_image_urls or reference_video_urls. Publicly
                accessible HTTP or HTTPS MP3 or WAV URLs, each 2–30 seconds and
                up to 15 MB, with a combined duration of at most 30 seconds. The
                server checks the combined duration at submission.
              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: >-
            Business status code. `200` means success; any other value means the
            request failed. Always check this field: some validation errors
            return HTTP 200 with `code: 400` in the body.


            - `200`: Success

            - `400`: Invalid request parameters

            - `401`: Missing or invalid API key

            - `402`: Insufficient credits

            - `403`: Permission denied

            - `404`: Resource not found

            - `408`: Request timeout

            - `429`: Rate limit exceeded

            - `500`: Internal server error

            - `502`: Upstream service error

            - `503`: Service unavailable


            See [Error Codes](/api-manual/error-codes) for details.
        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: >-
                Task status. Always `not_started` right after submission. Use
                [Query Task Status](/api-manual/task-management/status) or
                `callback_url` to get later states.


                - `not_started`: Queued, waiting to be processed

                - `running`: Being generated

                - `finished`: Completed; results are in `files` or `output`

                - `failed`: Failed; details are in `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: >-
            Business status code. `200` means success; any other value means the
            request failed. Always check this field: some validation errors
            return HTTP 200 with `code: 400` in the body.


            - `200`: Success

            - `400`: Invalid request parameters

            - `401`: Missing or invalid API key

            - `402`: Insufficient credits

            - `403`: Permission denied

            - `404`: Resource not found

            - `408`: Request timeout

            - `429`: Rate limit exceeded

            - `500`: Internal server error

            - `502`: Upstream service error

            - `503`: Service unavailable


            See [Error Codes](/api-manual/error-codes) for details.
        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: >-
        All API endpoints require Bearer Token authentication.


        Create an API key: sign in to PoYo, open **Dashboard → API Key** at
        [poyo.ai/dashboard/api-key](https://poyo.ai/dashboard/api-key), and
        click to create a key.


        Add it to the request header:


        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````

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