Назад в блог

Начало работыИнструкция

Список моделей GET /v1/models: как найти точный id модели

Один GET-запрос покажет точные id моделей с лимитами контекста и ответа. Скопируйте id, задайте max_tokens и выберите первую модель под задачу.

Автор: CheapTokens TeamОпубликовано 4 мин чтения

Терминал с GET-запросом к списку моделей
Содержание
  1. Почему у одной модели везде разные id
  2. Спросите API: один запрос
  3. Три id и их лимиты
  4. Выберите первую модель под задачу
  5. Задайте max_tokens по лимиту и отправьте запрос
  6. Если запрос всё равно падает

Код отвечает 404 на имя модели, которое в чужом примере работало. Спросите у самого API: один GET-запрос на https://api.cheaptokens.dev/v1/models вернёт модели, которые можно вызвать, с лимитами контекста и ответа. Берите id из этого ответа, а не из памяти, и сверяйте лимит, прежде чем ставить max_tokens.

Страница документации CheapTokens (проверено 28 октября 2026) описывает GET /v1/models как список доступных для вызова моделей с лимитами контекста и ответа. Рядом — GET /v1/models/{model} для одной модели и GET /v1/capabilities. Сам чат идёт через POST /v1/chat/completions (совместим с OpenAI) или POST /v1/messages (совместим с Anthropic).

Почему у одной модели везде разные id#

Допустим, вы нашли туториал для другого провайдера. В нём model: "deepseek-chat", вы подставляете его рядом с базовым адресом CheapTokens, и запрос падает. С ключом всё в порядке. Провайдеры называют одну модель по-разному: префикс вроде deepseek-ai/, суффикс версии вроде -0731, другой регистр. API принимает только ту строку, которую перечисляет, а короткое имя с ценника не подойдёт.

Поэтому id стоит один раз посмотреть в списке, а не вспоминать. Как выглядит неверный id на экране, подробно разобрано в статье Ошибка API 401 или 404: ключ, base URL или id модели. Это руководство — шаг раньше: найти верный id и вообще не увидеть ту ошибку.

Спросите API: один запрос#

Выберите вкладку по вкусу. Запрос в обоих одинаковый. В обоих примерах ключ берётся из переменной окружения CHEAPTOKENS_API_KEY (ключ — в личном кабинете, когда на балансе есть средства).

Один запрос, два способа

curl

bash
export CHEAPTOKENS_API_KEY="sk-your-key"

curl https://api.cheaptokens.dev/v1/models \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY"

Python

python
import json
import os

import requests

resp = requests.get(
    "https://api.cheaptokens.dev/v1/models",
    headers={"Authorization": f"Bearer {os.environ['CHEAPTOKENS_API_KEY']}"},
    timeout=30,
)
resp.raise_for_status()
print(json.dumps(resp.json(), indent=2))

Версия на Python нарочно печатает сырой JSON. Прочитайте его один раз глазами: вас интересуют id моделей и рядом с ними лимиты контекста и ответа. Копируйте id целиком.

Порядок запросов: список моделей, точный id, запрос в чат
Порядок действий: список моделей, копирование id, затем запрос в чат

Три id и их лимиты#

В документации перечислены такие модели (проверено 28 октября 2026). В model отправляйте строку в коде в начале каждой строки:

  • zai-org/GLM-5.3-Flash — контекст 390K, ответ до 8 192 токенов.
  • deepseek-ai/DeepSeek-V4-Flash-0731 — контекст 380K, ответ до 32 768 токенов.
  • MiniMaxAI/MiniMax-M2.7 — контекст 180K, ответ до 8 192 токенов.

Для выбора важны два числа. Контекст — сколько модель удерживает в одном запросе: ваш промпт и её ответ вместе. Лимит ответа — самая длинная одна реплика. Если слова новые, их простым языком объясняют статьи как читать названия моделей ИИ и почему ответ обрывается на полуслове.

Окно контекста и лимит ответа трёх моделей
Контекст и лимит ответа из документации CheapTokens, проверено 28 октября 2026

Выберите первую модель под задачу#

Для старта длинное сравнение по бенчмаркам не нужно. Первый выбор обычно решают два вопроса: насколько велик ваш ввод и какой длины нужен ответ? Нажмите на случай, ближайший к вашему.

Выберите свой случай

Какой у вас случай?

Я вставляю длинный документ

Берите zai-org/GLM-5.3-Flash. У неё самое большое окно из трёх, 390K, так что длинный документ и вопрос к нему помещаются в один запрос. Ответ — до 8 192 токенов, этого хватает на пересказ или извлечение данных.

Мне нужны длинные ответы (до 32 768 токенов)

Берите deepseek-ai/DeepSeek-V4-Flash-0731. Она отдаёт до 32 768 токенов за один ответ и держит окно 380K, так что и длинный сгенерированный текст, и цикл агента помещаются.

Я пишу код с умеренным промптом

Берите MiniMaxAI/MiniMax-M2.7. Окна 180K хватает на несколько файлов и переписку вокруг них; ответ — до 8 192 токенов.

У всех трёх один баланс и одна цена в любое время суток, без пиковых часов, так что смена модели позже — это одна заменённая строка. В сумме, с учётом входа и выхода, каждая из трёх дешевле OpenRouter. Вот как выглядит нагрузка: допустим, у вас небольшой помощник, который отправляет 2 000 токенов на входе и получает 500 в ответ, 1 000 раз в день. Живая таблица ниже считает именно это.

Модель За запрос 1 000 запросов OpenRouter, 1 000 запросов
GLM-5.3-Flash $0.00006 $0.06 $0.121
DeepSeek-V4-Flash $0.00008 $0.08 $0.173
MiniMax-M2.7 $0.00018 $0.175 $1.20

2 000 входных и 500 выходных токенов на запрос. Цены за 1M токенов актуальны и меняются вместе с нашими тарифами; столбец OpenRouter показывает справочные цены для той же нагрузки.

Текущие цены за токены по каждой модели — на странице цен, а подробнее про каждую модель — на страницах моделей. Если нужно сравнение по задачам, есть статья GLM, DeepSeek или MiniMax: какую модель выбрать.

Задайте max_tokens по лимиту и отправьте запрос#

Частая оплошность: вы просите длинный отчёт у модели с лимитом 8 192, и ответ обрывается на середине. Лимит из списка — потолок для max_tokens. Оставайтесь на нём или ниже.

Вот запрос с полным id из списка. Он просит длинный ответ у модели, которая его позволяет:

bash
curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Write a 1,500-word guide to API keys."}],
    "max_tokens": 4000
  }'

Первый вызов ещё впереди? Первый запрос к API CheapTokens разбирает формат ответа и поле usage.

Чтобы закрепить порядок, расставьте шаги:

Расставьте по порядку

Расставьте шаги по порядку

  1. Вызвать GET /v1/models
  2. Скопировать точный id модели
  3. Сверить лимит ответа и задать max_tokens не выше него
  4. Отправить запрос в чат

Если запрос всё равно падает#

Начните со строки. Id, отличающийся на один символ, — обычная причина 404, поэтому вставьте его из списка заново, а не перепечатывайте. 402 значит, что баланс исчерпан, а лимит запросов — 120 в минуту на один API-ключ. Ошибки приходят в стандартном JSON-формате OpenAI и Anthropic, так что SDK разбирают их как обычно. Полный разбор — в статье Ошибка API 401 или 404.

API совместим с OpenAI и Anthropic по адресу https://api.cheaptokens.dev/v1; Anthropic SDK и Claude Code используют корневой адрес https://api.cheaptokens.dev без /v1. Больше деталей настройки — в документации.