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

# List Models

> List available VLM Run Gateway models and their capabilities

Authentication is optional. Anonymous and authenticated callers share the
same [rate limits](/gateway/rate-limits) as chat completions. See
[Authentication](/gateway/authentication) for tier details.

For availability status and use-case guidance, see [Models](/gateway/models).

## Model fields

VLM Run Gateway model entries extend the OpenAI list-models shape with these fields:

| Field             | Description                                                             |
| ----------------- | ----------------------------------------------------------------------- |
| `id`              | Preferred public model id (use this in `POST /chat/completions`).       |
| `aliases`         | All accepted request ids, including short and Hugging Face forms.       |
| `methods`         | Operations supported via the `method` request field.                    |
| `default_method`  | Applied when `method` is omitted.                                       |
| `extra_body_help` | Example `method` / `method_params` payloads.                            |
| `capabilities`    | Input limits and accepted content part types.                           |
| `task`            | `chat`, `embed`, or `transcribe` (non-chat models use other endpoints). |

<RequestExample>
  ```python Python theme={"theme":{"light":"github-light","dark":"dark-plus"}}
  from openai import OpenAI

  client = OpenAI(
      base_url="https://gateway.vlm.run/v1/openai",
      api_key="<VLMRUN_API_KEY>",
  )

  models = client.models.list()
  for model in models.data:
      caps = model.capabilities
      print(f"{model.id}: {caps.supported_input_types}")
  ```

  ```bash cURL theme={"theme":{"light":"github-light","dark":"dark-plus"}}
  curl https://gateway.vlm.run/v1/openai/models \
    -H "Authorization: Bearer $VLMRUN_API_KEY"
  ```
</RequestExample>

<Note>
  The OpenAI Python SDK may not surface VLM Run Gateway-specific fields like
  `capabilities` or `methods` on the typed `Model` object. Parse the raw
  response or use cURL when you need the full catalog metadata.
</Note>

## Related

<CardGroup cols={2}>
  <Card title="Models" icon="table-list" href="/gateway/models">
    Full catalog with availability status and use-case guidance.
  </Card>

  <Card title="Chat Completions" icon="comments" href="/gateway/api-reference/post-chat-completions">
    Send inference requests using model ids from this endpoint.
  </Card>
</CardGroup>


## OpenAPI

````yaml gateway/openapi.json GET /v1/openai/models
openapi: 3.1.0
info:
  title: VLM Run Gateway API
  summary: Unified gateway for real-time vision-language inference.
  description: |
    The **VLM Run Gateway API** is the public entry point to the VLM Run
    inference platform. It fronts vision-language and computer-vision models
    behind a single OpenAI-compatible surface plus first-class real-time
    transports.

    [Terms of service](https://vlm.run/terms) |
    [VLM Run](https://vlm.run) |
    [Send email to support@vlm.run](mailto:support@vlm.run)
  termsOfService: https://vlm.run/terms
  contact:
    name: VLM Run
    url: https://vlm.run/
    email: support@vlm.run
  version: 0.10.0
servers:
  - url: https://gateway.vlm.run
    description: Production
  - url: http://localhost:8001
    description: Local development
security: []
paths:
  /v1/openai/models:
    get:
      summary: List Models
      operationId: list_models_v1_openai_models_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelListResponse'
      security:
        - HTTPBearer: []
components:
  schemas:
    ModelListResponse:
      properties:
        object:
          type: string
          const: list
          title: Object
          default: list
        data:
          items:
            $ref: '#/components/schemas/ModelInfo'
          type: array
          title: Data
      type: object
      required:
        - data
      title: ModelListResponse
    ModelInfo:
      properties:
        id:
          type: string
          title: Id
        object:
          type: string
          const: model
          title: Object
          default: model
        created:
          type: integer
          title: Created
        owned_by:
          type: string
          title: Owned By
          default: vlmrt
        aliases:
          items:
            type: string
          type: array
          title: Aliases
        methods:
          items:
            type: string
          type: array
          title: Methods
        default_method:
          type: string
          title: Default Method
          default: ''
        extra_body_help:
          type: string
          title: Extra Body Help
          default: ''
        capabilities:
          $ref: '#/components/schemas/ModelCapabilities'
        task:
          type: string
          enum:
            - chat
            - embed
            - transcribe
          title: Task
          default: chat
      type: object
      required:
        - id
      title: ModelInfo
      description: Model metadata for ``GET /v1/openai/models``.
    ModelCapabilities:
      properties:
        max_images:
          anyOf:
            - type: integer
            - type: 'null'
          title: Max Images
          default: 1
        max_videos:
          anyOf:
            - type: integer
            - type: 'null'
          title: Max Videos
          default: 0
        supports_text_only:
          type: boolean
          title: Supports Text Only
          default: true
        supports_document_url:
          type: boolean
          title: Supports Document Url
          default: false
        supported_input_types:
          items:
            type: string
          type: array
          title: Supported Input Types
      type: object
      title: ModelCapabilities
      description: |-
        Declared input capabilities exposed via ``GET /v1/openai/models``.

        Mirrors :class:`vlmrt.chat.backends.ChatCapabilities` but as a
        Pydantic model so the info surfaces cleanly in the API response
        (and in the ``vlmrt chat --models`` table).  ``None`` means
        unlimited.
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````