Skip to main content

Model catalog and configurations

GET /api/open/v1/catalog/entries: discover models, protocols, capabilities and availability.

Request

sh
curl --fail-with-body https://acosmi.com/api/open/v1/catalog/entries
curl --fail-with-body https://acosmi.com/api/open/v1/capabilities

Both are anonymous read-only queries. Retrieve one entry with GET /api/open/v1/catalog/entries/{publicKey}. The standard /v1/models endpoint has different credential requirements from the anonymous catalog.

Identifiers and response fields

FieldTypeMeaning
version / observed_atstringCatalog revision and observation time
data[].model_idstringCatalog identifier for discovery and display
data[].public_keystringPublic model-detail URL key
data[].namestringCurrent display name, including relevant notices
profiles[].idUUIDExecution configuration used as the identifier in our examples
profiles[].wirestringopenai or anthropic
context_window / max_output_tokensnumberDeclared context and output limits
input_modalitiesarrayDeclared inputs, not generation types
capabilities / supported_parametersobject / arrayCapabilities and fields for this configuration, not a union across profiles
pricing_v2object / nullEffective V2 version, component rates and input tiers
contract_versionsarrayBilling contracts declared by the configuration

Illustrative response

This abbreviated shape is not a callable model or proof of published prices:

json
{"version":"catalog-version","observed_at":"2026-11-14T00:00:00Z","data":[{"model_id":"MODEL_ID","public_key":"PUBLIC_KEY","name":"Model name","profiles":[{"id":"PROFILE_UUID","wire":"openai","protocol_supported":false,"price_status":"missing_price","pricing_v2":null}]}]}

Determine availability

Protocol support, confirmed prices, financial readiness and release acceptance for the same contract must all hold. V1 uses price_ack_ready, financial_ready and release_accepted. V2 uses its price status, financial_ready_v2 and release_accepted_v2. A supported output-budget field and valid limit are also required.

Global compatV1Enabled=true only enables the compatibility surface. It does not make every configuration callable. The server checks credentials and current conditions again at execution. Unknown or missing prices never mean free usage.

Keep the same configuration

One profile must satisfy all selected filters. Keep its UUID, wire and model association through details, examples and playground. Channel reference information is not an upstream credential.

Model catalog · First request