---
title: "Gets the list of available AI engine models."
method: GET
path: "/ai_models"
tags: ["AI"]
---

# Gets the list of available AI engine models.

`GET /ai_models`

Returns the catalog of engine models that can be set in the `engine_model` field of an AI.
The whole catalog is returned in a single page, so `page_size` and `page_token` are not used.
Each model has a `key_mode`: `platform` means the platform supplies access and `engine_key` is ignored, `own_or_default` means your `engine_key` is used or the platform default key when empty, and `own_required` means `engine_key` is mandatory.

## Response `200`

The list of available AI engine models.

- object
  - `next_page_token` string — Cursor token for the next page of results. Pass this value as the page_token parameter in the next request.
  - `result` AIManagerAIModel[]
    - `id` string, required — The model identifier to use as `engine_model`. Returned from the `id` field of the `GET /ai_models` response.
    - `label` string, required — Human-readable model name.
    - `vendor` string, required — Model vendor used to group models.
    - `recommended` boolean, required — Whether the platform recommends this model.
    - `tags` string[], required — Model tags. Currently `low-cost` only.
    - `description` string, required — A short description of the model.
    - `platform_managed` boolean, required — If true, the platform supplies the credentials and `engine_key` is not needed.
    - `key_mode` 'platform' | 'own_or_default' | 'own_required', required — How the engine key is handled. platform: the platform supplies access and engine_key is ignored. own_or_default: your engine_key is used, or the platform default key when empty. own_required: engine_key is mandatory.
    - `model_id_prefix` string — Present only for entries where you type the model ID yourself. Send engine_model as this prefix followed by the model ID.

## Other responses

- `401` — Authentication required (UNAUTHENTICATED).
- `500` — Internal error (INTERNAL).

## Changes

- **2026-10-06** `21abd45d9a1c` — 2 info
  - added the optional property `allOf[subschema #2]/result/items/model_id_prefix` to the response with the `200` status
  - added the required property `allOf[subschema #2]/result/items/key_mode` to the response with the `200` status
- **2026-10-05** `bd02a69a591d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/voipbin/apis/voipbin-api/changes/ai_models/get.md)

---

[API](https://skmtc.dev/voipbin/apis/voipbin-api.md) · [All operations](https://skmtc.dev/voipbin/apis/voipbin-api/llms.txt) · [OpenAPI document](https://skmtc.dev/voipbin/apis/voipbin-api/revisions/6a2b13260ccc?raw)