List Models

List available VLM Run Gateway models and their capabilities

GET /v1/openai/models

Python

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}")

200

{
  "data": [
    {
      "id": "<string>",
      "object": "model",
      "created": 123,
      "owned_by": "vlmrt",
      "aliases": [
        "<string>"
      ],
      "methods": [
        "<string>"
      ],
      "default_method": "",
      "extra_body_help": "",
      "capabilities": {
        "max_images": 1,
        "max_videos": 0,
        "supports_text_only": true,
        "supports_document_url": false,
        "supported_input_types": [
          "<string>"
        ]
      },
      "task": "chat"
    }
  ],
  "object": "list"
}

Authentication is optional. Anonymous and authenticated callers share the same rate limits as chat completions. See Authentication for tier details.

For availability status and use-case guidance, see 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).

Python

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}")

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.

Related

Models

Full catalog with availability status and use-case guidance.

Chat Completions

Send inference requests using model ids from this endpoint.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

200 - application/json

Successful Response

data · ModelInfo · object[] · required

Hide child attributes

data. id · string · required

data. object · string · default: model

Allowed value: "model"

data. created · integer

data. owned_by · string · default: vlmrt

data. aliases · string[]

data. methods · string[]

data. default_method · string · default: ""

data. extra_body_help · string · default: ""

data. capabilities · ModelCapabilities · object

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.

Hide child attributes

data.capabilities. max_images · integer | null · default: 1

data.capabilities. max_videos · integer | null · default: 0

data.capabilities. supports_text_only · boolean · default: true

data.capabilities. supports_document_url · boolean · default: false

data.capabilities. supported_input_types · string[]

data. task · enum<string> · default: chat

Available options: chat, embed, transcribe

object · string · default: list

Allowed value: "list"