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

# Generate a video



## OpenAPI

````yaml /openapi.json post /v1/videos
openapi: 3.1.0
info:
  title: Seedance API
  version: 1.0.0
  description: REST API for SeedDance video and Seedream image generation models.
servers:
  - url: https://api.seedanceapi.us
security: []
paths:
  /v1/videos:
    post:
      summary: Generate a video
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VideoRequest'
      responses:
        '202':
          description: Generation accepted
        '401':
          description: Unauthorized
        '402':
          description: Insufficient balance
      security:
        - bearerAuth: []
components:
  schemas:
    VideoRequest:
      type: object
      required:
        - model
        - prompt
      properties:
        model:
          type: string
          enum:
            - seedance-2.5/text-to-video
            - seedance-2.5/image-to-video
            - seedance-2.5/reference-to-video
            - seedance-2.0/text-to-video
            - seedance-2.0/image-to-video
            - seedance-2.0/reference-to-video
            - seedance-2.0/video-extend
            - seedance-2.0/video-edit
            - seedance-2.0/text-to-video-turbo
            - seedance-2.0/image-to-video-turbo
            - seedance-2.0-fast/text-to-video
            - seedance-2.0-fast/image-to-video
            - seedance-2.0-fast/text-to-video-turbo
            - seedance-2.0-fast/image-to-video-turbo
            - seedance-2.0-fast/video-extend
            - seedance-2.0-fast/video-edit
            - seedance-2.0-mini/text-to-video
            - seedance-2.0-mini/image-to-video
            - seedance-2.0-mini/video-extend
            - seedance-2.0-mini/video-edit
            - seedance-1.5-pro/text-to-video
            - seedance-1.5-pro/image-to-video
            - seedance-1.0-pro/text-to-video
            - seedance-1.0-pro/image-to-video
            - seedance-1.0-pro-fast/text-to-video
        prompt:
          type: string
        aspect_ratio:
          type: string
          default: '16:9'
        resolution:
          type: string
          default: 720p
        duration:
          type: integer
          default: 5
        image_url:
          type: string
          format: uri
        video_url:
          type: string
          format: uri
        generate_audio:
          type: boolean
          default: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key (ak_...) from your SeedanceAPI dashboard

````