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

# List video models

> Lists the video models on sale, with the durations, resolutions, aspect ratios and frame images each accepts and its price per second of video. Requires an API key.



## OpenAPI

````yaml /openapi/naga-api.json get /v1/videos/models
openapi: 3.1.0
info:
  title: NagaAI API
  description: >-
    NagaAI routes inference requests to a pool of upstream providers behind one
    endpoint. Requests speak the OpenAI or the Anthropic dialect, and the
    gateway selects a provider that serves the requested model. Two credentials
    exist and they are not interchangeable. An API key reaches models. A
    provisioning key manages the account: its keys, its balance, and its usage.
    Each operation declares which one it accepts. NagaAI charges the account in
    credits for the tokens a request consumes, at the published price of the
    model that served it. One credit costs one US dollar.
  termsOfService: https://naga.ac/legal/terms
  contact:
    name: NagaAI
    url: https://naga.ac
  version: '2026-03-31'
  summary: >-
    One API to many model providers, in the OpenAI and Anthropic request
    formats.
servers:
  - url: https://api.naga.ac
    description: Production
security: []
tags:
  - name: Chat Completions
    description: >-
      The OpenAI Chat Completions dialect, with streaming, tools and multimodal
      input.
    externalDocs:
      url: https://platform.openai.com/docs/api-reference/chat
      description: The OpenAI reference for this dialect.
  - name: Messages
    description: >-
      The Anthropic Messages dialect, as Claude-style clients and agents speak
      it.
    externalDocs:
      url: https://docs.anthropic.com/en/api/messages
      description: The Anthropic reference for this dialect.
  - name: Responses
    description: >-
      The OpenAI Responses dialect, with structured input, tools and streamed
      output items.
    externalDocs:
      url: https://platform.openai.com/docs/api-reference/responses
      description: The OpenAI reference for this dialect.
  - name: Embeddings
    description: Vector embeddings for search, retrieval, clustering and ranking.
    externalDocs:
      url: https://platform.openai.com/docs/api-reference/embeddings
      description: The OpenAI reference for this route.
  - name: Images
    description: Image generation and editing with multimodal models.
    externalDocs:
      url: https://platform.openai.com/docs/api-reference/images
      description: The OpenAI reference for these routes.
  - name: Audio
    description: Speech from text, and text from uploaded audio.
    externalDocs:
      url: https://platform.openai.com/docs/api-reference/audio
      description: The OpenAI reference for these routes.
  - name: Videos
    description: 'Video generation as a job: submit it, poll it, download the file.'
    externalDocs:
      url: https://docs.naga.ac/api/videos
      description: The NagaAI guide to video generation.
  - name: Moderations
    description: Safety classification of text and image input.
    externalDocs:
      url: https://platform.openai.com/docs/api-reference/moderations
      description: The OpenAI reference for this route.
  - name: Models
    description: The catalog of models, their capabilities and their prices.
    externalDocs:
      url: https://platform.openai.com/docs/api-reference/models
      description: The OpenAI reference for this route.
  - name: Startups
    description: The organizations whose models the catalog carries.
    externalDocs:
      url: https://docs.naga.ac/get-started/models
      description: The NagaAI guide to the model catalog.
  - name: Account
    description: The account's balance and its usage, behind a provisioning key.
    externalDocs:
      url: https://docs.naga.ac/account/balance-and-activity
      description: The NagaAI guide to balance and activity.
  - name: API Keys
    description: The account's API keys, behind a provisioning key.
    externalDocs:
      url: https://docs.naga.ac/account/api-keys
      description: The NagaAI guide to API keys.
paths:
  /v1/videos/models:
    get:
      tags:
        - Videos
      summary: List video models
      description: >-
        Lists the video models on sale, with the durations, resolutions, aspect
        ratios and frame images each accepts and its price per second of video.
        Requires an API key.
      operationId: list_video_models
      responses:
        '200':
          description: >-
            Every video model on sale, with what it accepts and its price per
            second.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VideoModelsResponse'
              examples:
                basic:
                  summary: One model and its prices per second
                  value:
                    object: list
                    data:
                      - id: kling-v3.0-pro
                        supported_durations:
                          - 3
                          - 4
                          - 5
                          - 6
                          - 7
                          - 8
                          - 9
                          - 10
                          - 11
                          - 12
                          - 13
                          - 14
                          - 15
                        supported_resolutions:
                          - 720p
                        supported_aspect_ratios:
                          - '16:9'
                          - '9:16'
                          - '1:1'
                        supported_frame_images:
                          - first_frame
                          - last_frame
                        generate_audio: true
                        seed: false
                        pricing:
                          - resolution: 720p
                            with_audio: false
                            per_second: '0.056'
                          - resolution: 720p
                            with_audio: true
                            per_second: '0.084'
          x-retry-safe: false
        '401':
          description: >-
            The API key is missing, malformed, disabled, or does not belong to
            an account that may call this route.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              examples:
                invalid-api-key:
                  summary: 401 — the key is not one this gateway serves
                  value:
                    error:
                      type: invalid_api_key
                      message: >-
                        The provided API key is invalid. Please ensure your API
                        key is correct and active. You can find more information
                        about obtaining a key on our website: https://naga.ac If
                        you just created this key, wait a few minutes and try
                        again.
          x-retry-safe: false
        '500':
          description: >-
            The gateway failed for a reason of its own. Report it — this status
            marks NagaAI's own bugs.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          x-retry-safe: true
        '503':
          description: >-
            A store the gateway needs did not respond. `Retry-After`, when
            present, carries the suggested wait.
          headers:
            Retry-After:
              schema:
                type: string
              description: How long to wait before retrying, in seconds.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          x-retry-safe: true
      security:
        - bearerAuth: []
        - xApiKeyAuth: []
      x-codeSamples:
        - lang: bash
          label: curl
          source: |-
            curl https://api.naga.ac/v1/videos/models \
              -H "Authorization: Bearer $NAGA_API_KEY"
components:
  schemas:
    VideoModelsResponse:
      type: object
      description: The video models the caller can submit for.
      required:
        - object
        - data
      properties:
        object:
          type: string
          description: Always `list`.
          example: list
        data:
          type: array
          items:
            $ref: '#/components/schemas/VideoModel'
          description: One entry per model.
    ErrorEnvelope:
      type: object
      description: >-
        `{"error": {…}}` — the body of every non-2xx answer outside
        `/v1/messages`.
      required:
        - error
      properties:
        error:
          allOf:
            - $ref: '#/components/schemas/ErrorBody'
          description: The failure itself, and the envelope's only member.
    VideoModel:
      type: object
      description: What one video model accepts and what a second of it costs.
      required:
        - id
        - supported_durations
        - supported_resolutions
        - supported_aspect_ratios
        - supported_frame_images
        - generate_audio
        - seed
        - pricing
      properties:
        id:
          type: string
          description: The model id to submit with.
        supported_durations:
          type: array
          items:
            type: integer
            format: int64
          description: Clip lengths in seconds the model accepts.
        supported_resolutions:
          type: array
          items:
            type: string
          description: Resolutions the model accepts.
        supported_aspect_ratios:
          type: array
          items:
            type: string
          description: Aspect ratios the model accepts.
        supported_frame_images:
          type: array
          items:
            type: string
          description: >-
            Frame types `frame_images` may pin: a subset of `first_frame` and
            `last_frame`.
        generate_audio:
          type: boolean
          description: 'Whether `generate_audio: true` is accepted.'
        seed:
          type: boolean
          description: Whether `seed` is honoured.
        pricing:
          type: array
          items:
            $ref: '#/components/schemas/VideoPrice'
          description: The price of one second, per resolution and with or without audio.
    ErrorBody:
      type: object
      description: 'The `error` member: what went wrong, in the caller''s terms.'
      required:
        - type
        - message
      properties:
        type:
          type: string
          description: >-
            The class of the failure; a provider's own class can reach you
            unchanged.
          examples:
            - invalid_request_error
            - authentication_required
            - invalid_api_key
            - invalid_provisioning_key
            - invalid_session_token
            - disabled_api_key
            - disabled_provisioning_key
            - expired_api_key
            - credit_limit_exceeded
            - rate_limit_exceeded
            - model_deprecated
            - inappropriate_content
            - billing_metering_incomplete
            - billing_request_id_invalid
            - billing_writer_missing
            - server_error
        message:
          type: string
          description: The human-readable sentence shown to the caller.
        code:
          type:
            - string
            - 'null'
          description: The finer-grained code, when the failure has one.
        param:
          type:
            - string
            - 'null'
          description: The request field the failure is about, when it is about one.
    VideoPrice:
      type: object
      description: The price of one second of video for one SKU.
      required:
        - resolution
        - with_audio
        - per_second
      properties:
        resolution:
          type: string
          description: The resolution this price applies to.
        with_audio:
          type: boolean
          description: Whether this price is for a clip with a soundtrack.
        per_second:
          type: string
          description: Credits per second, as a decimal string.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'An account API key. Send it as `Authorization: Bearer <key>`.'
    xApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        An account API key. Send it as `x-api-key: <key>`, the header
        Anthropic-style clients use.

````

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