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

# Seedance 2.5 Flash R2V

> ByteDance's fast reference-image video model for character-led scenes, product shots, and visual storytelling, with optional reference audio and native sound. It combines up to 10 reference images in a 4 to 30 second clip at 480p or 720p.



## OpenAPI

````yaml /media-model-api/bytedance/bytedance-i2v.json post /bytedance/seedance-2.5-flash-r2v
openapi: 3.1.0
info:
  description: The image-to-video models API from ByteDance.
  version: 1.0.0
  contact:
    name: Modellix Support
    email: support@modellix.ai
  title: ByteDance Image-to-Video Models API
servers:
  - url: https://api.modellix.ai/api/v1
    description: The image-to-video models API from ByteDance.
security:
  - bearerAuth: []
paths:
  /bytedance/seedance-2.5-flash-r2v:
    post:
      summary: Seedance 2.5 Flash R2V
      description: >-
        ByteDance's fast reference-image video model for character-led scenes,
        product shots, and visual storytelling, with optional reference audio
        and native sound. It combines up to 10 reference images in a 4 to 30
        second clip at 480p or 720p.
      operationId: seedance25FlashR2vAsync
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Seedance25FlashR2vRequest'
            examples:
              reference_images:
                summary: Reference-image generation
                value:
                  prompt: >-
                    Combine @Image1 and @Image2 into one cinematic shot. Follow
                    the rhythm of @Audio1.
                  reference_images:
                    - https://example.com/person.jpg
                    - https://example.com/scene.jpg
                  audio_urls:
                    - https://example.com/voice.mp3
                  ratio: '16:9'
                  duration: 10
                  output_format: mov
      responses:
        '200':
          description: Task submitted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AsyncTaskResponse'
components:
  schemas:
    Seedance25FlashR2vRequest:
      type: object
      description: Generate a video from reference images, with optional reference audio.
      required:
        - reference_images
      properties:
        reference_images:
          type: array
          description: >-
            Reference images. Use publicly accessible HTTPS URLs or asset://
            IDs.
          minItems: 1
          maxItems: 10
          items:
            type: string
            format: uri
          example:
            - https://example.com/a.jpg
            - https://example.com/b.jpg
        prompt:
          type: string
          description: >-
            Text prompt describing the desired video. Refer to inputs with
            @Image1 or @Audio1.
          minLength: 1
          maxLength: 10000
          example: Animate the scene gently with natural motion
        audio_urls:
          type: array
          description: >-
            Reference audio in WAV or MP3 format, each 2-30 seconds and at most
            30 seconds in total.
          minItems: 1
          maxItems: 5
          items:
            type: string
            format: uri
          example:
            - https://example.com/voice.mp3
        ratio:
          type: string
          description: Aspect ratio of the generated video.
          enum:
            - '16:9'
            - '4:3'
            - '1:1'
            - '3:4'
            - '9:16'
            - '21:9'
            - adaptive
          default: adaptive
          example: adaptive
        resolution:
          type: string
          description: Output resolution.
          enum:
            - 480p
            - 720p
          default: 720p
          example: 720p
        duration:
          type: integer
          description: Output duration in seconds.
          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
          example: 5
        generate_audio:
          type: boolean
          description: Whether to generate an audio track with the video
          default: true
          example: true
        output_format:
          type: string
          description: Output video container format.
          enum:
            - mp4
            - mov
          default: mp4
          example: mp4
        execution_expires_after:
          type: integer
          description: Maximum time in seconds before the task expires.
          minimum: 3600
          maximum: 259200
          default: 172800
          example: 172800
        return_last_frame:
          type: boolean
          description: Whether to return the last frame of the generated video
          default: false
          example: false
        omni_reference_task_type:
          type: string
          description: >-
            Reference generation mode. auto infers the task from the prompt and
            inputs.
          enum:
            - auto
            - reference
          example: auto
    AsyncTaskResponse:
      type: object
      required:
        - code
        - message
        - data
      properties:
        code:
          type: integer
          description: Response code, 0 indicates success
          example: 0
        message:
          type: string
          description: Response message
          example: success
        data:
          type: object
          required:
            - status
            - task_id
            - model_id
          properties:
            status:
              type: string
              enum:
                - pending
                - processing
              description: Task status
              example: pending
            task_id:
              type: string
              description: Unique task identifier
              example: task-abc123
            model_id:
              type: string
              description: Model ID
              example: model-123
            get_result:
              type: object
              description: API information to query the task result
              properties:
                method:
                  type: string
                  description: HTTP method
                  example: GET
                url:
                  type: string
                  description: Full URL to query the task result
                  example: https://api.modellix.ai/api/v1/tasks/task-abc123
          description: Detailed data about the submitted asynchronous task.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API Key authentication. Format: `Bearer YOUR_API_KEY`.'

````

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