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

# List models

> Returns an OpenAI-compatible list of models available on the Modellix LLM gateway. Each `data[].id` uses `provider/name` form. Uses the query rate limit (separate from inference RPM).



## OpenAPI

````yaml /llm/api/llm.json get /models
openapi: 3.1.0
info:
  title: Modellix LLM API
  description: >-
    Public API of the Modellix LLM gateway: OpenAI-compatible Chat Completions
    and Responses, Anthropic-compatible Messages, plus model listing and request
    logs.


    Optional fields follow the corresponding official protocols; this document
    lists commonly used core fields only.
  version: '2026-08-07'
  contact:
    name: Modellix
servers:
  - url: https://llm.modellix.ai/v1
    description: Production
security:
  - BearerAuth: []
  - ApiKeyAuth: []
tags:
  - name: Chat Completions
    description: OpenAI-compatible Chat Completions
  - name: Responses
    description: OpenAI-compatible Responses
  - name: Messages
    description: Anthropic-compatible Messages
  - name: Models
    description: List available models
  - name: Logs
    description: List team request logs
paths:
  /models:
    get:
      tags:
        - Models
      summary: List models
      description: >-
        Returns an OpenAI-compatible list of models available on the Modellix
        LLM gateway. Each `data[].id` uses `provider/name` form. Uses the query
        rate limit (separate from inference RPM).
      operationId: listModels
      responses:
        '200':
          description: OpenAI-compatible model list
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelListResponse'
              examples:
                ok:
                  summary: Model list
                  value:
                    object: list
                    data:
                      - id: openai/gpt-5.5
                        object: model
                      - id: openai/gpt-5.6-sol
                        object: model
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
        '502':
          $ref: '#/components/responses/UpstreamError'
components:
  schemas:
    ModelListResponse:
      type: object
      required:
        - object
        - data
      properties:
        object:
          type: string
          example: list
        data:
          type: array
          items:
            $ref: '#/components/schemas/ModelListItem'
    ModelListItem:
      type: object
      required:
        - id
        - object
      properties:
        id:
          $ref: '#/components/schemas/ModelId'
        object:
          type: string
          example: model
        created:
          type: integer
          description: Optional creation UNIX timestamp
        owned_by:
          type: string
          description: Optional owner label
    ErrorBody:
      type: object
      required:
        - error
      description: >-
        Gateway error envelope shared by Chat Completions, Responses, and
        Messages.
      properties:
        error:
          type: object
          required:
            - message
            - type
          additionalProperties: true
          description: Error details object.
          properties:
            message:
              type: string
              description: Human-readable error message.
            type:
              type: string
              description: >-
                Error type string (for example invalid_request_error,
                rate_limit_exceeded, insufficient_quota).
              examples:
                - invalid_request_error
                - api_error
                - rate_limit_exceeded
                - request_limited
                - insufficient_quota
            code:
              type:
                - string
                - 'null'
              description: Optional machine-readable error code, or null.
            param:
              type:
                - string
                - 'null'
              description: Optional parameter name related to the error, or null.
    ModelId:
      type: string
      description: Model ID in `provider/name` form
      examples:
        - openai/gpt-5.5
        - openai/gpt-5.6-sol
        - anthropic/claude-sonnet-5
        - google/gemini-3.6-flash
  responses:
    Unauthorized:
      description: >-
        Missing or invalid API key, or conflicting Authorization and x-api-key
        values
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorBody'
          example:
            error:
              message: invalid API key
              type: invalid_request_error
    RateLimited:
      description: >-
        Rate limited (RPM or other request limits), or the selected model is
        temporarily unavailable (e.g. upstream deployment cooldown)
      headers:
        X-RateLimit-Limit:
          description: Maximum number of requests allowed in the current rate-limit window.
          schema:
            type: integer
        X-RateLimit-Remaining:
          description: Number of requests remaining in the current rate-limit window.
          schema:
            type: integer
        X-RateLimit-Reset:
          description: Unix timestamp (seconds) when the current rate-limit window resets.
          schema:
            type: integer
        Retry-After:
          schema:
            type: integer
          description: >-
            May be returned when the model is temporarily unavailable; value in
            seconds
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorBody'
          examples:
            rpm:
              summary: RPM exceeded
              value:
                error:
                  message: rate limit exceeded
                  type: rate_limit_exceeded
            modelCooldown:
              summary: Model temporarily unavailable
              value:
                error:
                  message: >-
                    the selected model is temporarily unavailable, please retry
                    later or try another model
                  type: api_error
    UpstreamError:
      description: >-
        Temporary service unavailability or upstream error (client-facing
        message may be sanitized)
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorBody'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        Authorization: Bearer <Modellix API Key> (OpenAI SDK, Codex, OpenCode,
        etc.)
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        x-api-key: <Modellix API Key> (Anthropic SDK, Claude Code, etc.).
        Equivalent to Bearer; if both are present they must be the same key.

````