Models & Catalog API

Status: Preview. Useful for discovery and evaluation; handle metadata changes and missing fields before GA.

Three endpoints help you discover account-visible models before deciding between model: "auto" and a pinned id.

Endpoints

Endpoint	Purpose
`GET /v1/models`	OpenAI-compatible flat list for discovery
`GET /v1/catalog/models`	Richer model metadata (capabilities, modalities)
`GET /v1/catalog/capabilities`	What you can do today, capability by capability

curl https://api.beatra.ai/v1/models \
  -H "Authorization: Bearer $BEATRA_API_KEY"

{
  "object": "list",
  "data": [
    { "id": "<model-id>", "object": "model", "owned_by": "beatra" }
  ]
}

The set is your account's view. Models can appear and disappear as enablement changes; cache for short periods only.

GET /v1/models

GET /v1/catalog/models

GET /v1/catalog/capabilities