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

# List video models

> Lists the video models available through the API, with the modes, resolutions (and credits per
second at each), durations and aspect ratios each one supports. Requires a valid `X-API-KEY` header.



## OpenAPI

````yaml GET /video/models
openapi: 3.1.0
info:
  title: Wondercraft Public API
  version: 0.0.1
servers:
  - url: https://api.wondercraft.ai/v1
    description: Base Wondercraft API
security: []
paths:
  /video/models:
    get:
      tags:
        - Videos
      summary: List video models
      description: >-
        Lists the video models available through the API, with the modes,
        resolutions (and credits per

        second at each), durations and aspect ratios each one supports. Requires
        a valid `X-API-KEY` header.
      operationId: list_video_models_video_models_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListVideoModelsResponse'
      security:
        - APIKeyHeader: []
components:
  schemas:
    ListVideoModelsResponse:
      properties:
        models:
          items:
            $ref: '#/components/schemas/ApiVideoModel'
          type: array
          title: Models
          description: Video models available through the API
      type: object
      required:
        - models
      title: ListVideoModelsResponse
    ApiVideoModel:
      properties:
        id:
          type: string
          title: Id
          description: Model ID to pass as `model_id` when generating
        title:
          type: string
          title: Title
          description: Display name of the model
        description:
          type: string
          title: Description
          description: What the model is good at
        modes:
          items:
            $ref: '#/components/schemas/ApiVideoMode'
          type: array
          title: Modes
          description: Generation modes this model supports
        resolutions:
          items:
            $ref: '#/components/schemas/ApiVideoResolutionOption'
          type: array
          title: Resolutions
          description: Supported resolutions and their price
        default_resolution:
          $ref: '#/components/schemas/ApiResolution'
          description: Resolution used when the request sends none
        durations:
          items:
            type: integer
          type: array
          title: Durations
          description: Supported output durations in seconds
        default_duration:
          type: integer
          title: Default Duration
          description: Duration used when the request sends none
        aspect_ratios:
          items:
            $ref: '#/components/schemas/ApiAspectRatio'
          type: array
          title: Aspect Ratios
          description: Aspect ratios this model supports
        supports_audio:
          type: boolean
          title: Supports Audio
          description: Whether the output includes generated audio
        max_reference_images:
          anyOf:
            - type: integer
            - type: 'null'
          title: Max Reference Images
          description: >-
            Maximum `reference_image_ids` in references mode, or null when not
            supported
        max_reference_videos:
          anyOf:
            - type: integer
            - type: 'null'
          title: Max Reference Videos
          description: >-
            Maximum `reference_video_ids` in references mode, or null when not
            supported
        output_duration_follows_source:
          type: boolean
          title: Output Duration Follows Source
          description: >-
            In video_to_video mode the output is as long as the source clip, and
            `duration` is not sent
      type: object
      required:
        - id
        - title
        - description
        - modes
        - resolutions
        - default_resolution
        - durations
        - default_duration
        - aspect_ratios
        - supports_audio
        - output_duration_follows_source
      title: ApiVideoModel
    ApiVideoMode:
      type: string
      enum:
        - text
        - image
        - frames
        - references
        - video_to_video
      title: ApiVideoMode
    ApiVideoResolutionOption:
      properties:
        resolution:
          $ref: '#/components/schemas/ApiResolution'
          description: Value to send as `resolution`
        label:
          type: string
          title: Label
          description: Size the model renders at this tier, e.g. 360p for a 480p tier
        credits_per_second:
          type: number
          title: Credits Per Second
          description: Credits charged per generated second at this tier
      type: object
      required:
        - resolution
        - label
        - credits_per_second
      title: ApiVideoResolutionOption
    ApiResolution:
      type: string
      enum:
        - 480p
        - 720p
        - 1080p
        - 2k
        - 4k
      title: ApiResolution
      description: >-
        Output resolution shared by the image and video APIs; each model lists
        the values it supports.
    ApiAspectRatio:
      type: string
      enum:
        - '16:9'
        - '9:16'
        - '1:1'
      title: ApiAspectRatio
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-KEY

````

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