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

# List models

> List the live model catalog, including pricing, modalities, and capability metadata.



## OpenAPI

````yaml GET /models
openapi: 3.1.0
info:
  title: LLM7 API
  description: >-
    Discover models, generate and edit images, and create asynchronous video
    generation tasks through the LLM7 gateway.
  version: 1.0.0
servers:
  - url: https://api.llm7.io/v1
security:
  - bearerAuth: []
paths:
  /models:
    get:
      summary: List models
      description: >-
        List the live model catalog, including pricing, modalities, and
        capability metadata.
      operationId: listModels
      responses:
        '200':
          description: Model catalog response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelListResponse'
        '429':
          $ref: '#/components/responses/RateLimited'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
      security: []
components:
  schemas:
    ModelListResponse:
      type: object
      required:
        - object
        - data
      properties:
        object:
          type: string
          description: Response container type.
          example: list
        data:
          type: array
          description: Live model records.
          items:
            $ref: '#/components/schemas/ModelRecord'
    ModelRecord:
      type: object
      additionalProperties: true
      required:
        - id
        - object
      properties:
        id:
          type: string
          description: Model ID to pass as model.
          example: gemini-veo31
        object:
          type: string
          example: model
        created:
          type:
            - integer
            - 'null'
          description: Creation timestamp when available.
        owned_by:
          type:
            - string
            - 'null'
        tier:
          type:
            - string
            - 'null'
          description: Access tier when applicable.
        model_type:
          type: string
          description: Broad model family or endpoint type. Video-capable models use video.
          example: video
        pricing_mode:
          type: string
          description: >-
            Pricing calculation mode. Token-priced models use token; video
            models use second.
        pricing:
          $ref: '#/components/schemas/ModelPricing'
        modalities:
          $ref: '#/components/schemas/ModelModalities'
        context_window:
          type:
            - object
            - 'null'
          additionalProperties: true
        usage_based_only:
          type: boolean
        stream:
          type: boolean
        json_mode:
          type: boolean
        reasoning:
          type: boolean
        tools_calling:
          type: boolean
        capabilities:
          $ref: '#/components/schemas/ModelCapabilities'
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          $ref: '#/components/schemas/ErrorObject'
    ModelPricing:
      type: object
      additionalProperties: true
      properties:
        input:
          type: number
          description: Input-token price for token-priced models.
        output:
          type: number
          description: Output-token price for token-priced models.
        price:
          type: number
          description: >-
            Per-unit price for non-token pricing modes. Video models use public
            USD price per generated second.
          example: 0.01875
        minimum_request_price_usd:
          type: number
        minimum_cache_tokens:
          type: number
        currency:
          type: string
          example: USD
        unit:
          type: string
          example: second
    ModelModalities:
      type: object
      properties:
        input:
          type: array
          items:
            type: string
          example:
            - text
            - image
        output:
          type: array
          items:
            type: string
          example:
            - video
    ModelCapabilities:
      type: object
      additionalProperties: true
      properties:
        video_generation:
          type: boolean
          description: Whether the model can generate video.
        video_async:
          type: boolean
          description: Whether video generation is asynchronous.
        supported_seconds:
          type: array
          description: Allowed seconds values for video generation.
          items:
            type: integer
          example:
            - 4
            - 6
            - 8
        supported_sizes:
          type: array
          description: Allowed output sizes for video generation.
          items:
            type: string
          example:
            - 1280x720
            - 720x1280
            - 1920x1080
        max_reference_images:
          type: integer
          description: Maximum number of uploaded reference images.
        max_reference_image_bytes:
          type: integer
          description: Maximum bytes per uploaded reference image.
          example: 8388608
        requires_reference_image:
          type: boolean
          description: Whether at least one input_reference file is required.
    ErrorObject:
      type: object
      required:
        - message
        - type
        - code
      properties:
        message:
          type: string
        type:
          type: string
        param:
          type:
            - string
            - 'null'
        code:
          type: string
  responses:
    RateLimited:
      description: Gateway or upstream rate limit.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    UpstreamUnavailable:
      description: Upstream provider is temporarily unavailable.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````