API reference

Models

List available models and the full model catalog.

GET /models/available#

List the models you can use with POST /zo/ask. When authenticated with an API key, the list includes your BYOK (Bring Your Own Key) configurations.

Response#

modelsarray

List of available models.

models[].model_namestring

The value to pass to model_name in /zo/ask.

models[].labelstring

Human-readable model name.

models[].vendorstring

Model provider (e.g. "Anthropic", "OpenAI", "Custom").

models[].descriptionstring | null

Short description of the model's capabilities.

models[].typestring | null

Either "fast" or "capable", indicating the model's speed/capability tradeoff.

models[].context_windownumber | null

Maximum context window size in tokens.

models[].is_byokboolean

Whether this is a BYOK (Bring Your Own Key) model.

GET /models/catalog#

The full public model catalog: the picker model list plus catalog-level metadata (default chat model, featured models, deprecation map). No authentication required. Cached for 5 minutes.

Response#

modelsarray

The picker model list, sorted by priority.

default_chat_model_idstring

Public id of the default chat model.

featured_model_idsarray

Public ids of featured models.

featured_models_are_freeboolean

When true, featured models are free to use.

featured_model_labelsarray

Labels for featured_model_ids, in order.

promo_end_datestring | null

Promo end date (YYYY-MM-DD) or null.

deprecation_mapobject

Map of deprecated public model id → active successor public id.