Model discovery - FlexAI Docs

There are two ways to enumerate the catalog at runtime, and they cover different audiences.

Endpoint	Auth	Returns	Use when
`GET /api/models`	None (public)	Every model in the catalog, across all modalities, whether or not it’s currently serving. Includes per-token `pricing`, capability tags, and `health_status`.	You want one public call that surfaces the whole catalog with capabilities and pricing.
`GET /v1/models`	Bearer key	Every live model across all modalities in OpenAI’s `Model` shape, each with a `category` field. Only models currently serving appear.	Your client speaks OpenAI’s `/v1/models`, or you want just what’s callable right now.

/v1/models is the OpenAI-shaped list of what’s live right now; each entry’s category tells you which endpoint to call (see Category → endpoint). /api/models is the full catalog with capability tags, health, and per-token pricing.

Calling `/api/models`

No auth, no headers, no params. Returns a JSON array of model objects.

curl https://tokens.flex.ai/api/models | jq '.[0]'

Each entry follows this shape:

{
  "slug": "qwen-qwen2-5-32b-instruct",
  "model_name": "Qwen2.5-32B-Instruct-FP8",
  "display_name": "Qwen 2.5 32B Instruct",
  "description": "Qwen 2.5 32B — instruction-tuned text model ...",
  "category": "text",
  "context_window": 32768,
  "max_output": 8192,
  "input_per_mtok": 0.80,
  "output_per_mtok": 0.80,
  "supports": ["chat", "tool_use", "streaming"],
  "pricing": [],
  "health_status": "healthy",
  "provider": "Qwen"
}

The fields you’ll filter on most often:

category — the model’s modality/family: text, code, reasoning, multimodal, vision, embedding, image, audio, video. Determines which endpoint to call (see Category → endpoint).
supports[] — capability tags like chat, tool_use, streaming, vision, reasoning, embeddings. This is what to filter on when you care about a specific capability.
model_name — the value to pass as model in subsequent API calls. (slug is the dashboard URL form; model_name is the API form.)
input_per_mtok / output_per_mtok — per-token pricing (USD per million tokens).

A few filter examples:

# All tool-calling models
curl -s https://tokens.flex.ai/api/models \
  | jq '[.[] | select(.supports | index("tool_use"))]'

# All vision-capable models (accept image input on /v1/chat/completions)
curl -s https://tokens.flex.ai/api/models \
  | jq '[.[] | select(.supports | index("vision"))]'

# Just the names and prices of embedding models
curl -s https://tokens.flex.ai/api/models \
  | jq '[.[] | select(.supports | index("embeddings")) | {model_name, input_per_mtok}]'

Category → endpoint

A model’s category (on both /api/models and /v1/models) tells you which endpoint it’s called through:

`category`	Call with
`text`, `code`, `reasoning`, `multimodal`, `vision`	`POST /v1/chat/completions`
`embedding`	`POST /v1/embeddings`
`image`	`POST /v1/images/generations`
`audio` (text-to-speech)	`POST /v1/audio/speech`
`audio` (speech-to-text)	`POST /v1/audio/transcriptions`
`video`	`POST /v1/videos/generations`

For audio, the supports[] tags disambiguate direction: a model carrying audio_transcription is speech-to-text; otherwise it’s text-to-speech.

Per-capability discovery flow

Each subsection: how to find the models, then the endpoint to call once you have a model_name.

Chat & text

curl -s https://tokens.flex.ai/api/models \
  | jq '[.[] | select(.supports | index("chat")) | .model_name]'

Call with POST /v1/chat/completions. See streaming and tool use for the common patterns.

Vision (image input on chat)

curl -s https://tokens.flex.ai/api/models \
  | jq '[.[] | select(.supports | index("vision")) | .model_name]'

Call with POST /v1/chat/completions and pass image parts in the content array. The full pattern lives in the vision guide.

Embeddings

curl -s https://tokens.flex.ai/api/models \
  | jq '[.[] | select(.supports | index("embeddings")) | .model_name]'

Call with POST /v1/embeddings. See the embeddings guide.

​Calling /api/models

​Category → endpoint

​Per-capability discovery flow

​Chat & text

​Vision (image input on chat)

​Embeddings

​See also