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

# Seedance 2.5 Reference to Video

> Seedance 2.5 reference to video model with native audio and precise motion control

<Tip>
  Submit the request with `VIDGO_API_KEY`. After submission, a `task_id` is returned. Retrieve the result through the unified [Query Task Status](/api-manual/task-management/status) endpoint or provide `callback_url` for a completion notification.
</Tip>

## Available Models

* **seedance-2.5/reference-to-video** - Seedance 2.5 reference to video generation

## Input modes

* This model uses reference images, videos, and optional audio for multimodal guidance.
* Provide at least one reference image or reference video. Reference audio cannot be used alone.

## Important notes

* `prompt`, `duration`, and `resolution` are required.
* `duration` accepts integer values from 4 to 30 seconds.
* `resolution` accepts `480p` or `720p`.
* `aspect_ratio` accepts `auto`, `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, or `9:16`.
* Reference input accepts up to 30 images, 10 videos, and 10 audio files, with at most 50 reference files in total. Reference audio requires at least one reference image or video.
* All media URLs must be publicly accessible and directly downloadable.
* Usage is billed by duration and resolution. Each reference-video duration, rounded down separately, is added to output duration for billing.


## OpenAPI

````yaml api-manual/video-series/seedance-2-5-reference-to-video.json POST /api/generate/submit
openapi: 3.0.0
info:
  title: Vidgo API - Seedance 2.5 Reference to Video
  description: Seedance 2.5 Reference to Video through the Vidgo unified generation API.
  version: 1.0.0
servers:
  - url: https://api.vidgo.ai
    description: Production server
security:
  - BearerAuth: []
paths:
  /api/generate/submit:
    post:
      tags:
        - Seedance 2.5 Reference to Video
      summary: Submit Seedance 2.5 Reference to Video Task
      operationId: submitSeedance25ReferenceToVideoTask
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubmitRequest'
            examples:
              default:
                summary: Seedance 2.5 Reference to Video
                value:
                  model: seedance-2.5/reference-to-video
                  callback_url: https://your-domain.com/callback
                  input:
                    prompt: >-
                      A cinematic scene with natural lighting and coherent
                      motion
                    duration: 5
                    resolution: 480p
                    reference_image_urls:
                      - https://cdn.vidgo.ai/examples/reference-1.jpg
      responses:
        '200':
          description: Task submitted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubmitResponse'
        '400':
          description: Invalid request parameters
        '401':
          description: Unauthorized
components:
  schemas:
    SubmitRequest:
      type: object
      required:
        - model
        - input
      additionalProperties: false
      properties:
        model:
          type: string
          description: Vidgo public model identifier.
          enum:
            - seedance-2.5/reference-to-video
          example: seedance-2.5/reference-to-video
        callback_url:
          type: string
          format: uri
          description: Optional webhook callback URL.
        input:
          type: object
          required:
            - prompt
            - duration
            - resolution
          additionalProperties: false
          anyOf:
            - required:
                - reference_image_urls
            - required:
                - reference_video_urls
          properties:
            prompt:
              type: string
              description: Prompt describing the target video.
              minLength: 1
              maxLength: 20000
            duration:
              type: integer
              description: Output duration in seconds.
              minimum: 4
              maximum: 30
            resolution:
              type: string
              description: Output resolution.
              enum:
                - 480p
                - 720p
            aspect_ratio:
              type: string
              description: >-
                Output aspect ratio. Image-to-video accepts only auto when
                provided.
              enum:
                - auto
                - '21:9'
                - '16:9'
                - '4:3'
                - '1:1'
                - '3:4'
                - '9:16'
            generate_audio:
              type: boolean
              description: Whether to generate an audio track.
            reference_image_urls:
              type: array
              description: Reference images.
              minItems: 1
              maxItems: 30
              items:
                type: string
                format: uri
            reference_video_urls:
              type: array
              description: >-
                Reference videos. Their whole-second durations are included in
                billing.
              minItems: 1
              maxItems: 10
              items:
                type: string
                format: uri
            reference_audio_urls:
              type: array
              description: Reference audio. Requires a reference image or video.
              maxItems: 10
              items:
                type: string
                format: uri
    SubmitResponse:
      type: object
      required:
        - code
        - data
      properties:
        code:
          type: integer
          example: 200
        data:
          type: object
          required:
            - task_id
            - status
            - created_time
          properties:
            task_id:
              type: string
            status:
              type: string
              enum:
                - not_started
                - running
                - failed
            created_time:
              type: string
              format: date-time
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: 'Use `Authorization: Bearer VIDGO_API_KEY`.'

````