Model Discovery

GET https://gateway.primexos.com/v1/models

Returns an OpenAI-compatible ID list for enabled, available CHAT, CODE, and VISION models by default. It requires a valid prx- key but is not billable and remains available at zero balance. Pass ?service_type=IMAGE (or another service type) to list IDs for that type instead.

curl https://gateway.primexos.com/v1/models \
  -H "Authorization: Bearer prx-YOUR_KEY"

Retrieve one ID with GET /v1/models/:id. These routes return OpenAI-compatible identity fields, not prices, billing units, or capabilities. Use them for SDK and editor model pickers. Use the unauthenticated public catalogue's offerings list when you also need offering types, service/billing metadata, availability, and customer pricing:

curl https://app.primexos.com/api/public/catalog

Do not ship a hard-coded inventory. Cache briefly and refresh after a model_not_found or model_not_available response.