oxDocs
Browse documentation
Introduction
Vision API

Get started

Quickstart
Inference API
Realtime
Integrations
LiveKit & SIP
Administration
Reference

Inference

Models

Discover the model IDs and live availability currently admitted for inference.

List live availability

GET /models returns the current model catalog in an OpenAI-compatible list. This endpoint is public. Availability is runtime state: use only IDs whose status is ready, and check again after a capacity or provider error.

bash

curl --fail-with-body "$OX_VISION_API_BASE_URL/models" \
  --header "Accept: application/json"
json

{
  "object": "list",
  "data": [{
    "id": "Qwen/Qwen3-VL-30B-A3B-Instruct",
    "object": "model",
    "owned_by": "hallikar",
    "status": "ready"
  }]
}

Treat the catalog as admission state

A model appearing in repository configuration or a model card does not prove it is currently admitted. The live catalog is authoritative for request selection. A later request can still fail because availability changes between discovery and inference, so handle 429, 502, 503, and 504 explicitly.

Help improve this guideFound something unclear or incomplete?
Report an issue ↗View source ↗