GET /v1/models
Machine-readable list of model IDs, routes, and capability tags for applications and agents.
aisa.one/models
Browse, filter, and compare models, with current prices.
List models with the API
Send your API key as a Bearer token. Listing models is free; requests without an API key return402.
aisa metadata object for each model:
Filter the list with
jq:
Endpoints by model type
Calling a model on an unsupported route returns
400 with error.code set to model_route_not_supported; error.supported_routes lists the routes that work. Request and response schemas for each endpoint are documented in the API Reference.
Call a model
Point any OpenAI-compatible SDK athttps://api.aisa.one/v1 and pass a model id from the catalog:
Browse and compare on aisa.one
For interactive browsing, visit aisa.one/models. You can search by model, provider, or endpoint, filter by provider and capability, and compare models side by side. It also displays each model’s current price, which these docs do not list.How models are billed
Models draw on the same prepaid balance as data APIs. The billing unit depends on the model:- Text and embedding models: Billed per token, with separate rates for input and output, and for cache reads or writes where caching is supported.
- Image models: Billed per token, per request, or per image (sometimes varying by image size), depending on the model.
- Video models: Billed per output second or per token, by resolution.
Chinese models
Qwen, DeepSeek, Kimi, GLM, ByteDance Seed, MiniMax, and other Chinese models use the same endpoints. See Chinese AI Models for per-family guides.Notes for agents
- Use only model IDs dynamically returned by
GET /v1/models. Do not guess model IDs or reuse them from memory. - Select the endpoint from the model’s
routeslist; prioritize the route marked"preferred": truewhen present. - Do not assume a model supports a modality simply because its upstream family does. Always check
model_typeandcapabilities. - Listing models via
GET /v1/modelsis free and allowed before the user approves any spend. Current prices are listed on aisa.one/models, not in these docs.