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

curl https://gateway.vlm.run/v1/openai/models \
  -H "Authorization: Bearer $VLMRUN_API_KEY"

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://gateway.vlm.run/v1/openai",
  apiKey: process.env.VLMRUN_API_KEY,
});

const models = await client.models.list();
for (const model of models.data) {
  console.log(model.id);
}

{
  "data": [
    {
      "id": "<string>",
      "object": "model",
      "created": 123,
      "owned_by": "vlm-run",
      "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"
}

GET

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

curl https://gateway.vlm.run/v1/openai/models \
  -H "Authorization: Bearer $VLMRUN_API_KEY"

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://gateway.vlm.run/v1/openai",
  apiKey: process.env.VLMRUN_API_KEY,
});

const models = await client.models.list();
for (const model of models.data) {
  console.log(model.id);
}

{
  "data": [
    {
      "id": "<string>",
      "object": "model",
      "created": 123,
      "owned_by": "vlm-run",
      "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).

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

curl https://gateway.vlm.run/v1/openai/models \
  -H "Authorization: Bearer $VLMRUN_API_KEY"

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://gateway.vlm.run/v1/openai",
  apiKey: process.env.VLMRUN_API_KEY,
});

const models = await client.models.list();
for (const model of models.data) {
  console.log(model.id);
}

The OpenAI Python and Node.js SDKs 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

Hide child attributes

data.id

string

required

data.object

string

default:model

Allowed value: "model"

data.created

integer

data.owned_by

string

default:vlm-run

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.

Describes how many images / videos a model accepts and whether it supports text-only prompts, so clients can validate a request before sending it. None means unlimited (no cap on that input type).

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"

Chat Completions Get Model

Overview

Guides

API Reference

Misc

Model fields

Models

Chat Completions

Authorizations

Response

​Model fields

​Related

Models

Chat Completions

Authorizations

Response

Model fields

Related