Models
SmartAPI exposes a catalog of models from multiple providers. You pass the model’s
identifier in the model field of your request, and SmartAPI routes it to the
appropriate upstream provider.
Browsing models#
The full, up-to-date catalog — including pricing — is available on the Models page. Each model lists its provider, type, supported endpoint protocols, and credit-based pricing.
Choosing an endpoint#
The model you pick determines which endpoint to call:
| Model family | Endpoint | Protocol |
|---|---|---|
| OpenAI, and OpenAI-compatible models | POST /chat/completions | OpenAI |
| OpenAI Responses models | POST /responses | openai-response |
| Anthropic Claude models | POST /messages | Anthropic |
| Image generation models | POST /generate/image/generations | SmartAPI |
| Video generation models | POST /generate/video/tasks | SmartAPI |
Calling a model on an endpoint it does not support returns 400 unsupported_protocol. Check the model’s supported endpoint types on the
Models page.
Model metadata#
Each model in the catalog carries the following attributes:
- Model name — the identifier you send in the
modelfield (for examplegpt-4.1,claude-haiku-4-6). - Provider — the upstream provider, such as
openaioranthropic. - Type — the capability category:
LLM,EMBEDDING,IMAGE_GENERATION,TEXT_TO_SPEECH, orVIDEO_GENERATION. - Billing type — how usage is charged:
USAGE(per token),PER_CALL, orMODEL(image/video billed in credits). - Price — token-based models show credits per 1M tokens (input / output / cached input); image/video models show credit unit prices (per image / per second, plus resolution multipliers for video). All prices use the exchange rate $1 = 100 credits.
- Tags — capability markers; models tagged
thinkingsupport thinking/reasoning.
Thinking/reasoning is controlled by request parameters (reasoning_effort or
thinking). See Chat Completions,
Responses, and Messages for usage.
The live API serves text/chat (LLM), image generation (IMAGE_GENERATION),
and video generation (VIDEO_GENERATION) models. See Image
Generation and Video
Generation for how to call them.
Example: list models programmatically#
The model catalog can also be fetched from the console API (no key required):
curl https://api.smartapi.cc/api/console/v1/model/list \
-H "Content-Type: application/json" \
-d '{}'The response is wrapped in the standard console envelope
({ "code": 0, "message": "...", "data": ... }), where code equal to 0
indicates success.