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

# Seedance 2.0 Fast Reference to Video

> Faster, lower-cost tier of Seedance 2.0 reference-to-video. Drive generation with reference images, videos and audio — reference them inside the prompt as `@image1`, `@video1`, `@audio1`.

**Pricing:** billed per second by resolution.

Returns an `img_uuid`; poll GET /api/v1/jobs/detail (or use `custom_callback_url`) to get the generated video.



## OpenAPI

````yaml api-reference/video-generations/openapi-seedance-2-0-fast-refs.json POST /api/v1/videos/generations
openapi: 3.1.0
info:
  title: GoEnhance API - Seedance 2.0
  description: Seedance 2.0 text-to-video and first/last-frame image-to-video generation.
  version: 1.0.0
servers:
  - url: https://api.goenhance.ai
security: []
paths:
  /api/v1/videos/generations:
    post:
      tags:
        - VideoGenerations
      summary: Seedance 2.0 Fast Reference to Video
      description: >-
        Faster, lower-cost tier of Seedance 2.0 reference-to-video. Drive
        generation with reference images, videos and audio — reference them
        inside the prompt as `@image1`, `@video1`, `@audio1`.


        **Pricing:** billed per second by resolution.


        Returns an `img_uuid`; poll GET /api/v1/jobs/detail (or use
        `custom_callback_url`) to get the generated video.
      parameters:
        - name: Authorization
          in: header
          required: true
          example: Bearer YOUR_API_KEY
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                model:
                  type: string
                  enum:
                    - seedance-2-0-fast-refs
                  description: Model name. Must be `seedance-2-0-fast-refs`.
                prompt:
                  type: string
                  description: >-
                    Text prompt. Chinese: recommended up to 500 characters;
                    English: recommended up to 1000 words.
                ref_imgs:
                  type: array
                  items:
                    type: string
                    format: uri
                  maxItems: 9
                  description: >-
                    Reference images (up to 9). jpeg/png/webp, ≤30MB each,
                    300–6000px, aspect ratio 0.4–2.5. Referenced in the prompt
                    as @image1, @image2…
                ref_videos:
                  type: array
                  items:
                    type: string
                    format: uri
                  maxItems: 3
                  description: >-
                    Reference videos for camera/motion reference or editing
                    source (up to 3). mp4/mov, 2–15s each and ≤15s total, ≤50MB
                    each. Referenced in the prompt as @video1…
                ref_audios:
                  type: array
                  items:
                    type: string
                    format: uri
                  maxItems: 3
                  description: >-
                    Reference audio for background music, effects or voice (up
                    to 3). wav/mp3, 2–15s each and ≤15s total, ≤15MB each.
                    Requires at least one ref_imgs or ref_videos item.
                    Referenced in the prompt as @audio1…
                duration:
                  type: integer
                  minimum: 4
                  maximum: 15
                  default: 5
                  description: Any integer from 4 to 15 seconds.
                quality:
                  type: string
                  enum:
                    - 480p
                    - 720p
                  default: 720p
                  description: >-
                    Output resolution. `resolution` is accepted as a compatible
                    alias.
                aspect_ratio:
                  type: string
                  enum:
                    - '16:9'
                    - '9:16'
                    - '1:1'
                    - '4:3'
                    - '3:4'
                    - '21:9'
                    - adaptive
                  default: '16:9'
                  description: >-
                    Output aspect ratio. Image-to-video defaults to `adaptive`.
                    `ratio` is accepted as a compatible alias.
                generate_audio:
                  type: boolean
                  default: true
                  description: Generate synchronized audio at no additional charge.
                callback_url:
                  type: string
                  format: uri
                  description: >-
                    Optional public HTTPS callback URL. `custom_callback_url` is
                    accepted as a compatible alias.
              required:
                - model
                - prompt
            examples:
              textToVideo:
                summary: Text-to-video
                value:
                  model: seedance-2-0
                  prompt: A cat plays piano in moonlight, cinematic close-up
                  duration: 8
                  quality: 720p
                  aspect_ratio: '16:9'
                  generate_audio: true
              firstLastFrame:
                summary: First and last frame
                value:
                  model: seedance-2-0
                  prompt: A smooth cinematic transition between the two scenes
                  image_urls:
                    - https://example.com/first.jpg
                    - https://example.com/last.jpg
                  duration: 6
                  quality: 1080p
                  aspect_ratio: adaptive
            example:
              model: seedance-2-0-fast-refs
              prompt: >-
                Use the camera movement of @video1 and keep the product in
                @image1, with @audio1 as background music
              ref_imgs:
                - https://your-cdn.com/product.jpg
              ref_videos:
                - https://your-cdn.com/camera-ref.mp4
              ref_audios:
                - https://your-cdn.com/bgm.mp3
              duration: 10
              quality: 720p
              aspect_ratio: '16:9'
      responses:
        '200':
          description: Task submitted or application-level error.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  msg:
                    type: string
                  data:
                    type: object
                    properties:
                      img_uuid:
                        type: string
                required:
                  - code
                  - msg
              example:
                code: 0
                msg: Success
                data:
                  img_uuid: c12b656c-747a-44fd-9c80-add79b0c52d5
        '401':
          description: Unauthorized

````