Каталог моделей та їхні ціни

Прочитайте, які моделі може назвати запит і за якою ціною кожна з них рахується зараз.

Каталог моделей — це список моделей, вартість яких Slen уміє рахувати. За ним рахується кожна оцінка й кожен холд виклику моделі. Через API каталог доступний лише для читання, а консоль показує його на екрані Моделі.

Що в списку

Відповідь перелічує всі активні моделі, які на момент запиту мають чинну ціну, у порядку model_code. Модель без чинної ціни до списку не потрапляє.

Каталог один для всіх проєктів: список не залежить від того, яких провайдерів підключив проєкт. Він не ділиться на сторінки, тому у відповіді немає meta.

model_code — це ім’я, яким вузол AI-модель називає модель. Виклик моделі, якої немає в каталозі або яку в ньому вимкнули, відхиляється з кодом model_not_allowed, і виконання закінчується failed. Для активної моделі без чинної ціни код — cost_calculation_failed.

Як записано ціну

Ціну вказано за мільйон токенів, у валюті, яку називає currency. input_price_per_million і output_price_per_million є завжди. cached_input_price_per_million дорівнює null у моделі, яка не має окремої ціни на кешовані вхідні токени.

Ціна — це версія. model_price_id називає чинну версію, а effective_from і effective_to обмежують час, коли вона застосовується. effective_to дорівнює null, поки версія не має кінця. Холд зберігає версію, за якою його пораховано, тому пізніша зміна ціни не змінює вартості ранішого запиту.

Операції

Описи операцій і полів подано англійською.

Доступні моделі з чинними цінами

GET /v1/models

Дозвіл: read

Відповіді

200

Price snapshots effective at this instant

application/json

{
  "data": [
    {
      "model_code": "gpt-4o-mini",
      "provider": "openai",
      "model_price_id": "74438200973594624",
      "input_price_per_million": "0.02700000",
      "output_price_per_million": "0.02700000",
      "cached_input_price_per_million": "0.02700000",
      "max_output_tokens": 1,
      "currency": "USD",
      "effective_from": "2026-10-02T09:30:00Z",
      "effective_to": "2026-10-02T09:30:00Z"
    }
  ]
}

Помилки

Статус	Коди	Коли
401		No credential, or one that is not valid
403		Authenticated, but not allowed: scope (`insufficient_scope`), policy or tenant (`not_a_member`); a blocked end customer (`customer_blocked`); an act only a signed-in person may take (`session_required`); the role rule on members and invitations (`member_forbidden`, `invite_forbidden`); a write to the organization's own rows, or a read of the audit journal, by a caller that does not reach every project (`project_access_restricted`)

Заголовки

X-Request-Id

Тіло кожної помилки — конверт помилки.

Приклади

Отримати список моделей

Відповідь тут скорочено до однієї моделі.

Terminal

curl https://api.slen.ai/api/v1/models \
  -H "Authorization: Bearer $SLEN_API_KEY"

200 OK

{
  "data": [
    {
      "model_code": "gpt-4o-mini",
      "provider": "openai",
      "model_price_id": "1108",
      "input_price_per_million": "0.15000000",
      "output_price_per_million": "0.60000000",
      "cached_input_price_per_million": "0.07500000",
      "max_output_tokens": 16384,
      "currency": "USD",
      "effective_from": "2026-01-01T00:00:00+00:00",
      "effective_to": null
    }
  ]
}

Що читати далі

Моделі та ціни — той самий каталог у консолі.
Огляд — як у відповіді записуються гроші.
Автентифікація — дозвіл, який потрібен ключу, щоб читати каталог.
Коди помилок — кожен код API — що він означає і що робити.

Зібрано з openapi b070e1f, sdk contract 5cc7055, php ae4a53b, node 84bc62d