Skip to main content
AIsa routes LLM, image, video, and embedding models through a single API key. Because models are frequently added and retired, this page explains how to query the catalog dynamically rather than maintaining a static list.

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 return 402.
The response follows the standard OpenAI list format, extended with an 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 at https://api.aisa.one/v1 and pass a model id from the catalog:
For the Anthropic SDK and other clients, see OpenAI / Anthropic SDK.

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.
The live catalog shows each model’s billing type and current price. The final charge for each call is recorded in your usage logs. See Billing & Credits for balances, spend limits, and quotes.

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 routes list; prioritize the route marked "preferred": true when present.
  • Do not assume a model supports a modality simply because its upstream family does. Always check model_type and capabilities.
  • Listing models via GET /v1/models is free and allowed before the user approves any spend. Current prices are listed on aisa.one/models, not in these docs.