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

# Seedance 2.5 API Documentation

> Seedance 2.5 API enables 30-second native video with high-capacity multi-asset referencing for stable character and motion consistency. It features flexible regional editing and enhanced prompt accuracy for precise narrative control and realistic physics. Integrate Seedance 2.5 API now.

Check out Seedance 2.5 API pricing [here](https://api.pollo.ai/pricing?modelName=seedance-2-5\&modelType=video), cheaper than Fal AI.


## OpenAPI

````yaml POST /generation/bytedance/seedance-2-5
openapi: 3.0.3
info:
  title: Pollo | AI Video Collection
  description: >-
    ✨RESTful API Document. Model discovery: GET /api/v1/model-specs (public,
    keyless).
  version: 1.0.0
servers:
  - url: https://pollo.ai/api/platform
security: []
externalDocs:
  url: https://pollo.ai/api/platform/api/openapi.json
paths:
  /generation/bytedance/seedance-2-5:
    post:
      tags:
        - generation
        - video generation
      summary: create video by text or image or reference image
      operationId: generation-seedance-2-52video
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                input:
                  anyOf:
                    - allOf:
                        - {}
                        - type: object
                          properties:
                            image:
                              type: string
                              maxLength: 1000
                              format: uri
                              pattern: ^(?:http|https):\/\/
                              description: >-
                                Only image URLs are accepted (HTTPS preferred);
                                base64 is not allowed.
                                            Supported formats include JPG, PNG, and JPEG.
                                            Image aspect ratio must be less than 1:4 or 4:1.
                            imageTail:
                              type: string
                              maxLength: 1000
                              format: uri
                              pattern: ^(?:http|https):\/\/
                              description: |-
                                URL of the tail image for video generation.
                                            Only image URLs are accepted (HTTPS preferred); base64 is not allowed.
                                            Supported formats include JPG, PNG, and JPEG.
                                            Image aspect ratio must be less than 1:4 or 4:1.
                            prompt:
                              type: string
                              minLength: 1
                              maxLength: 10000
                              description: The prompt of the generation
                            resolution:
                              type: string
                              enum:
                                - 480p
                                - 720p
                              default: 720p
                              description: The resolution of the generation
                            length:
                              type: number
                              enum:
                                - 4
                                - 5
                                - 6
                                - 7
                                - 8
                                - 9
                                - 10
                                - 11
                                - 12
                                - 13
                                - 14
                                - 15
                                - 16
                                - 17
                                - 18
                                - 19
                                - 20
                                - 21
                                - 22
                                - 23
                                - 24
                                - 25
                                - 26
                                - 27
                                - 28
                                - 29
                                - 30
                              default: 5
                              description: The length of the generation
                            aspectRatio:
                              type: string
                              enum:
                                - adaptive
                                - '21:9'
                                - '16:9'
                                - '9:16'
                                - '1:1'
                                - '3:4'
                                - '4:3'
                              default: adaptive
                            seed:
                              type: number
                              maximum: 2147483647
                              description: The seed of the generation
                            generateAudio:
                              type: boolean
                              default: false
                              description: >-
                                Generate natural-sounding, fitting audio for the
                                output video.
                            webSearch:
                              type: boolean
                              default: false
                          required:
                            - image
                            - prompt
                          additionalProperties: false
                    - allOf:
                        - {}
                        - type: object
                          properties:
                            prompt:
                              type: string
                              minLength: 1
                              maxLength: 10000
                              description: The prompt of the generation
                            resolution:
                              type: string
                              enum:
                                - 480p
                                - 720p
                              default: 720p
                              description: The resolution of the generation
                            length:
                              type: number
                              enum:
                                - 4
                                - 5
                                - 6
                                - 7
                                - 8
                                - 9
                                - 10
                                - 11
                                - 12
                                - 13
                                - 14
                                - 15
                                - 16
                                - 17
                                - 18
                                - 19
                                - 20
                                - 21
                                - 22
                                - 23
                                - 24
                                - 25
                                - 26
                                - 27
                                - 28
                                - 29
                                - 30
                              default: 5
                              description: The length of the generation
                            aspectRatio:
                              type: string
                              enum:
                                - adaptive
                                - '21:9'
                                - '16:9'
                                - '9:16'
                                - '1:1'
                                - '3:4'
                                - '4:3'
                              default: adaptive
                            seed:
                              type: number
                              maximum: 2147483647
                              description: The seed of the generation
                            generateAudio:
                              type: boolean
                              default: false
                              description: >-
                                Generate natural-sounding, fitting audio for the
                                output video.
                            webSearch:
                              type: boolean
                              default: false
                          required:
                            - prompt
                          additionalProperties: false
                webhookUrl:
                  type: string
                clientSource:
                  type: string
                  minLength: 1
                  maxLength: 100
              required:
                - input
              additionalProperties: false
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  taskId:
                    type: string
                  status:
                    type: string
                    enum:
                      - waiting
                      - succeed
                      - failed
                      - processing
                required:
                  - taskId
                  - status
                additionalProperties: false
        default:
          $ref: '#/components/responses/error'
      security:
        - ApiKeyAuth: []
components:
  responses:
    error:
      description: Error response
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
              code:
                type: string
              issues:
                type: array
                items:
                  type: object
                  properties:
                    message:
                      type: string
                  required:
                    - message
                  additionalProperties: false
            required:
              - message
              - code
            additionalProperties: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key to authorize requests

````