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

# seedance-2.5

> Create Seedance 2.5 video generation tasks with text, image, video, and audio references.



## OpenAPI

````yaml api-reference/model-api/bytedance/openapi/seedance-2-5/openapi.yaml POST /v1/video/generations
openapi: 3.1.0
info:
  title: Seedance 2.5
  description: >-
    Seedance 2.5 video generation with multimodal references, editing,
    extension, and synchronized audio.
  version: 1.0.0
servers:
  - url: https://www.anyfast.ai
security:
  - bearerAuth: []
paths:
  /v1/video/generations:
    post:
      summary: Create Video Generation Task
      description: >
        Create an asynchronous Seedance 2.5 task for text-to-video, first-frame
        or first-and-last-frame generation, multimodal reference generation,
        video editing, or video extension.


        Poll `GET /v1/video/generations/{id}` until `status` is `succeeded`.
      operationId: createSeedance25
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - content
              properties:
                model:
                  type: string
                  enum:
                    - seedance-2.5
                  description: AnyFast model ID.
                  example: seedance-2.5
                content:
                  type: array
                  minItems: 1
                  maxItems: 51
                  description: >
                    Input content. Put the optional text prompt first, then
                    media items. Seedance 2.5 accepts up to 30 reference images,
                    10 reference videos, and 10 reference audio clips. Reference
                    videos and audio clips may total at most 30 seconds per
                    media type. The complete request body must not exceed 64 MB;
                    avoid Base64 for large files.
                  items:
                    type: object
                    required:
                      - type
                    properties:
                      type:
                        type: string
                        enum:
                          - text
                          - image_url
                          - video_url
                          - audio_url
                        description: Content item type.
                      text:
                        type: string
                        description: >-
                          Optional prompt text. Use `@image1`, `@video1`, and
                          `@audio1` to refer to media by type and order.
                      image_url:
                        type: object
                        description: >-
                          Image input. Supports a public URL, Base64 data URI,
                          or `asset://<ASSET_ID>`.
                        properties:
                          url:
                            type: string
                            description: >-
                              JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, or HEIF
                              image. Width/height ratio 0.4–2.5; each side
                              300–6000 px; less than 30 MB.
                      video_url:
                        type: object
                        description: >-
                          Video input. Supports a public URL or
                          `asset://<ASSET_ID>`.
                        properties:
                          url:
                            type: string
                            description: >-
                              MP4 or MOV video using H.264/H.265 video and
                              AAC/MP3 audio. 480p or 720p; 2–30 seconds; 24–60
                              FPS; width/height ratio 0.4–2.5; each side
                              300–6000 px; 409,600–8,295,044 pixels per frame;
                              up to 200 MB.
                      audio_url:
                        type: object
                        description: >-
                          Audio input. Seedance 2.5 supports audio-only
                          reference generation.
                        properties:
                          url:
                            type: string
                            description: >-
                              WAV or MP3 audio, 2–30 seconds, up to 15 MB.
                              Supports URL, Base64, or asset ID.
                      role:
                        type: string
                        enum:
                          - first_frame
                          - last_frame
                          - reference_image
                          - reference_video
                          - reference_audio
                        description: >
                          Media role. Use `first_frame` and optional
                          `last_frame` for image-to-video. Use `reference_*` for
                          reference generation, editing, and extension.
                  example:
                    - type: text
                      text: >-
                        A cinematic tracking shot of @image1 walking through a
                        rain-lit city
                    - type: image_url
                      image_url:
                        url: https://example.com/character.jpg
                      role: reference_image
                callback_url:
                  type: string
                  format: uri
                  description: >-
                    Optional callback URL that receives POST notifications when
                    the asynchronous task status changes.
                execution_expires_after:
                  type: integer
                  default: 172800
                  description: >-
                    Maximum time in seconds that a queued or running task may
                    execute before it expires.
                priority:
                  type: integer
                  default: 0
                  description: Task execution priority.
                safety_identifier:
                  type: string
                  description: Stable end-user identifier used for safety tracing.
                seed:
                  type: integer
                  default: -1
                  description: Random seed. Use `-1` for a random seed.
                service_tier:
                  type: string
                  default: default
                  description: Task service tier.
                generate_audio:
                  type: boolean
                  default: true
                  description: >-
                    Generate synchronized dialogue, sound effects, and
                    background audio.
                resolution:
                  type: string
                  enum:
                    - 480p
                    - 720p
                  default: 720p
                  description: Output video resolution.
                ratio:
                  type: string
                  enum:
                    - '21:9'
                    - '16:9'
                    - '4:3'
                    - '1:1'
                    - '3:4'
                    - '9:16'
                    - adaptive
                  default: adaptive
                  description: >
                    Output aspect ratio. For text and ordinary reference
                    generation, `adaptive` selects the best supported ratio.
                    Video editing and extension follow the selected source
                    video; frame-guided generation follows the first frame.
                    Editing, extension, and first-frame/first-and-last-frame
                    tasks require `adaptive`.
                duration:
                  type: integer
                  enum:
                    - -1
                    - 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: -1
                  description: >
                    Output duration in seconds. Use `-1` to let the model choose
                    a duration from 4–30 seconds. Video editing requires `-1`
                    and follows the source duration, possibly up to 0.4 seconds
                    shorter. Extension and frame-guided generation accept `-1`
                    or 4–30.
                output_format:
                  type: string
                  enum:
                    - mp4
                    - mov
                  default: mp4
                  description: >-
                    Output container. MOV uses high-color-fidelity H.264/yuv444p
                    video and PCM audio for editing workflows.
                tools:
                  type: array
                  description: >-
                    Optional generation tools. Web search is available for
                    text-to-video.
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                        enum:
                          - web_search
                watermark:
                  type: boolean
                  default: false
                  description: Add an AI-generated watermark to the lower-right corner.
                return_last_frame:
                  type: boolean
                  default: false
                  description: Return the generated video's final frame as an image.
      responses:
        '200':
          description: Video generation task created
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - task_id
                  - object
                  - model
                  - status
                  - progress
                  - created_at
                properties:
                  id:
                    type: string
                    description: Task ID used for polling.
                    example: asyntask_h81efT0qwtLnzyt6VENmCZ6VXSfNxE2E
                  task_id:
                    type: string
                    description: Task ID, identical to `id`.
                    example: asyntask_h81efT0qwtLnzyt6VENmCZ6VXSfNxE2E
                  object:
                    type: string
                    enum:
                      - video
                    example: video
                  model:
                    type: string
                    enum:
                      - seedance-2.5
                    example: seedance-2.5
                  status:
                    type: string
                    enum:
                      - queued
                    description: Initial asynchronous task status.
                    example: queued
                  progress:
                    type: integer
                    description: Initial task progress percentage.
                    example: 0
                  created_at:
                    type: integer
                    description: Unix timestamp.
                    example: 1786084139
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````