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

> ByteDance's fast video model for editing, extending, or creating a new clip from reference video, with native sound. It accepts up to five videos with optional image and audio references and produces 480p or 720p output.



## OpenAPI

````yaml /media-model-api/bytedance/bytedance-v2v.json post /bytedance/seedance-2.5-flash-v2v
openapi: 3.1.0
info:
  description: >-
    ByteDance video-to-video models API (JMAAS flat parameters; aligned with
    prediction model_metadata seedance20SeriesV2VParamRules /
    seedance25SeriesV2VParamRules).
  version: 1.0.0
  contact:
    name: Modellix Support
    email: support@modellix.ai
  title: ByteDance Video-to-Video Models API
servers:
  - url: https://api.modellix.ai/api/v1
    description: >-
      ByteDance models via JMAAS (use video-to-video route prefix in client URL
      path).
security:
  - bearerAuth: []
paths:
  /bytedance/seedance-2.5-flash-v2v:
    post:
      summary: Seedance 2.5 Flash V2V
      description: >-
        ByteDance's fast video model for editing, extending, or creating a new
        clip from reference video, with native sound. It accepts up to five
        videos with optional image and audio references and produces 480p or
        720p output.
      operationId: seedance25FlashV2vAsync
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Seedance25FlashV2vRequest'
            examples:
              edit:
                summary: Video editing
                value:
                  prompt: >-
                    Edit @Video1: replace the lamp with the lamp shown in
                    @Image1. Preserve the original camera, motion, and audio.
                  video_urls:
                    - https://example.com/edit_input.mov
                  reference_images:
                    - https://example.com/replacement_lamp.jpg
                  ratio: adaptive
                  duration: -1
                  generate_audio: true
                  output_format: mov
                  omni_reference_task_type: edit
              extension:
                summary: Video extension
                value:
                  prompt: >-
                    Extend @Video1 with a scene that continues its motion and
                    visual style.
                  video_urls:
                    - https://example.com/source_curator_case.mp4
                  reference_images:
                    - https://example.com/curator_identity.jpg
                    - https://example.com/display_case.jpg
                  ratio: adaptive
                  duration: 12
                  resolution: 720p
                  generate_audio: true
                  omni_reference_task_type: extend
              reference:
                summary: Reference-to-video
                value:
                  prompt: >-
                    Create a new scene using the motion in @Video1 and the
                    visual style in @Image1.
                  video_urls:
                    - https://example.com/clip.mp4
                  reference_images:
                    - https://example.com/style.jpg
                  ratio: '16:9'
                  duration: 10
                  output_format: mp4
                  omni_reference_task_type: reference
      responses:
        '200':
          description: Task submitted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AsyncTaskResponse'
components:
  schemas:
    Seedance25FlashV2vRequest:
      type: object
      required:
        - video_urls
      description: >-
        Generate, edit, or extend a video using video references, with optional
        image and audio references. At most 20 reference assets in total.
      properties:
        prompt:
          type: string
          description: >-
            Editing, extension, or generation instruction. Refer to inputs with
            @Image1, @Video1, or @Audio1.
          minLength: 1
          maxLength: 10000
          example: >-
            Replace the lamp in @Video1 with the lamp from @Image1 while
            preserving the camera movement and original audio.
        video_urls:
          type: array
          description: >-
            Reference videos, each 2-30 seconds; editing sources must be 4-30
            seconds. At most 30 seconds of video in total. Use publicly
            accessible HTTPS URLs or asset:// IDs.
          minItems: 1
          maxItems: 5
          items:
            type: string
            format: uri
            description: HTTPS URL or `asset://<asset_id>`.
          example:
            - https://example.com/edit_input.mov
        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/style.jpg
        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/bgm.mp3
        ratio:
          type: string
          description: >-
            Only an explicit omni_reference_task_type=reference uses your chosen
            aspect ratio. For auto, edit, extend, or an omitted task type, the
            platform replaces any supplied ratio with adaptive and bills using
            adaptive.
          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. For editing, omit this field or set -1
            to preserve the source duration. For reference generation and
            extension, set 4-30 or use -1 for automatic duration.
          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
            - -1
          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 generates a new video from references; edit modifies the
            source video; extend continues it. auto infers the task from the
            prompt and inputs.
          enum:
            - auto
            - reference
            - edit
            - extend
          default: auto
          example: edit
    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.