> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# Бесплатные модели

> Текстовые модели без платы за токены: как распознать их, кто может вызывать и какие действуют ограничения.

# Бесплатные модели

ID модели с окончанием `-free` означает бесплатную модель: токены не оплачиваются. У бесплатного варианта отдельный ID, отличный от платного. Передавайте точный ID с `-free`.

* Ниже перечислены три бесплатные текстовые модели. Также бесплатна `jev-1.14-free` в [Decisions API](/decisions). У моделей изображений и видео нет бесплатных ID.
* Их может вызывать любой ключ, группа которого имеет доступ к группе бесплатных моделей, включая стандартную `auto`. Нулевой баланс и отсутствие пополнений не мешают.
* На аккаунт действует лимит: 1 успешный запрос в минуту до первого пополнения и до 10 после него.
* Бесплатные модели могут быть ограничены или отключены в любой момент. Не делайте критически важную работу в рабочей среде зависимой от них.

## ID моделей

Список соответствует публичному каталогу (`GET /v1/text/models`, семейство `free`).

| ID бесплатной модели                                                               | Платный вариант       | Страница семейства                              |
| ---------------------------------------------------------------------------------- | --------------------- | ----------------------------------------------- |
| [`glm-5.3-flash-free`](/text-api/glm/chat-completions)                             | `glm-5.3-flash`       | [GLM](/text-api/glm/chat-completions)           |
| [`deepseek-v4.1-flash-free`](/text-api/deepseek/chat-completions)                  | `deepseek-v4.1-flash` | [DeepSeek](/text-api/deepseek/chat-completions) |
| `gemini-3.8-flash-free` (см. страницу [Gemini](/text-api/gemini/chat-completions)) | `gemini-3.8-flash`    | [Gemini](/text-api/gemini/chat-completions)     |

Если отправить ID платного варианта, это будет отдельный оплачиваемый запрос.

## Кто может пользоваться

* Любой действующий ключ с доступом его группы к бесплатной группе. Ключи стандартной группы `auto` имеют такой доступ.
* Допускается нулевой баланс и аккаунт, который ещё ни разу не пополнялся.
* Поле `model` в ответе содержит имя с `-free`.

Аккаунт с одним регистрационным бонусом может вызывать только модели из списка бесплатного доступа; бесплатные ID входят в этот список. `GET /v1/free-tier` возвращает список без ключа. Пополнение снимает это ограничение.

## Ограничения

| Состояние аккаунта              | Успешных запросов в минуту |
| ------------------------------- | -------------------------- |
| До первого пополнения           | 1                          |
| После пополнения на любую сумму | До 10                      |

* Учитываются успешные запросы. При ошибке запроса или потока занятое место возвращается. Ограничена частота вызовов, а не число одновременно выполняемых запросов.
* Бесплатные и платные запросы учитываются раздельно и не расходуют лимит друг друга.
* При исчерпании обычного минутного лимита аккаунта бесплатные запросы всё равно могут быть отклонены.

При превышении возвращается `429 rate_limit_exceeded` с заголовком `Retry-After` и полем `retry_after_seconds`. Подождите указанное число секунд. Сообщение описывает лимит; ниже точный текст для аккаунта без пополнений:

```json
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded: this model allows at most 1 successful requests per minute per account. Retry after 60 seconds. Accounts that have topped up get a higher per-minute limit.",
    "retryable": true,
    "request_id": "req_abc123",
    "retry_after_seconds": 60
  }
}
```

После пополнения сообщение содержит `at most 10 successful requests per minute`, а последнее предложение исчезает. Код совпадает с кодом обычного лимита аккаунта, поэтому различайте их по сообщению. Подождите число секунд из `Retry-After` / `retry_after_seconds` и повторите запрос. См. [ошибки](/errors#text-endpoints).

## Отличия от платных моделей

* **Не опубликованы ограничения контекста и выхода.** В бесплатных записях каталога нет контекстного окна, максимального выхода и цен. Параметры платного варианта не гарантируются для бесплатного ID.
* **Рассуждение не гарантируется.** Параметры платной модели, например `thinking` и `reasoning_effort`, могут работать иначе.
* **Форматы могут различаться.** Например, `glm-5.3-flash-free` не поддерживает `/v1/responses`. Перед использованием формата, отличного от Chat Completions, проверьте страницу семейства.
* **Скорость и доступность могут различаться.** Бесплатные модели могут работать медленнее, ограничиваться или отключаться без уведомления. Суточная квота не гарантируется.
* **Нет отдельной цены кэшированного входа.** Бесплатные ID вообще не оплачиваются за токены.

## Попробуйте модель

**`cURL`**

```bash title="cURL"
curl --request POST \
  --url https://api.beatapi.io/v1/chat/completions \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "glm-5.3-flash-free",
  "messages": [{ "role": "user", "content": "Say hello in one sentence." }]
}'
```

## Изображения и видео

Бесплатных моделей изображений и видео нет. Они оплачиваются за задачи; см. [быстрый старт](/quick-guide).