Skip to main content
GET
/
v1
/
openai
/
models
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}")

{
  "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:
FieldDescription
idPreferred public model id (use this in POST /chat/completions).
aliasesAll accepted request ids, including short and Hugging Face forms.
methodsOperations supported via the method request field.
default_methodApplied when method is omitted.
extra_body_helpExample method / method_params payloads.
capabilitiesInput limits and accepted content part types.
taskchat, embed, or transcribe (non-chat models use other endpoints).
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.

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
​
object
string
default:list
Allowed value: "list"