Перелічіть моделі через GET /v1/models, щоб знайти точний id моделі

Ваш код повертає 404 на назві моделі, яка виглядала нормально в чужому прикладі. Запитайте сам API: один запит GET до https://api.cheaptokens.dev/v1/models перелічує моделі, які ви можете викликати, з їхніми лімітами контексту та виводу. Копіюйте id з цієї відповіді, а не з пам'яті, і перевірте ліміт, перш ніж задавати max_tokens.

Сторінка документації (CheapTokens docs, перевірено 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", ви вставляєте його поруч із базовою URL-адресою CheapTokens, і запит не проходить. З вашим ключем усе гаразд. Провайдери називають ту саму модель по-різному: префікс на кшталт deepseek-ai/, суфікс версії на кшталт -0731, різний регістр літер. API приймає лише точний рядок, який він перелічує, і коротка назва, взята з цінника, теж не працюватиме.

Саме тому варто один раз знайти id. Якщо хочете дізнатися всю історію про те, як виглядає неправильний id на екрані, API 401 or 404 error: wrong key, base URL or model id розповідає про це. Цей посібник — крок перед цим: знайдіть правильний id, щоб ніколи не побачити цю помилку.

Запитайте API: один запит#

Виберіть вкладку, яку ви використовуєте. Обидві надсилають той самий запит. В обох прикладах ключ береться зі змінної середовища CHEAPTOKENS_API_KEY (ключ є в dashboard, щойно на балансі з'являться кошти).

export CHEAPTOKENS_API_KEY="sk-your-key"

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

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 та їхні ліміти#

Документація перелічує ці доступні для виклику моделі (перевірено 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 токенів виводу.

Для більшості рішень важливі два числа. Контекст — це скільки модель може вмістити в одному запиті, ваш промпт і її відповідь разом. Ліміт виводу — це найдовша одинична відповідь. Якщо ці слова для вас нові, how to read AI model names і why an answer stops mid-sentence пояснюють їх простою мовою.

Виберіть першу модель для свого завдання#

Щоб почати, вам не потрібне довге дослідження бенчмарків. Більшість перших виборів вирішують два питання: наскільки великий ваш вхідний текст і наскільки довгою має бути відповідь? Натисніть випадок, найближчий до вашого.

Усі три мають спільний баланс і одну ціну в будь-який час доби, без пікових годин, тож перехід пізніше коштує вам лише зміни одного рядка. Порівняно з OpenRouter кожна з трьох дешевша загалом, з урахуванням входу й виходу разом. Ось як виглядає навантаження: скажімо, ви запускаєте невеликого асистента, який надсилає 2 000 вхідних токенів і отримує 500 у відповідь, 1 000 разів на день. Таблиця нижче в реальному часі оцінює саме це.

Поточні ціни за токен для кожної моделі є на pricing page, а model pages розповідають глибше про кожну з них. Якщо хочете порівняння за завданнями, є GLM vs DeepSeek vs MiniMax: which model to choose.

Задайте max_tokens від ліміту, потім надішліть запит#

Поширена помилка: ви просите довгий звіт від моделі, чий ліміт — 8 192, і відповідь обривається на півдорозі. Ліміт, який ви бачили в списку, — це стеля для max_tokens. Тримайтеся на ній або нижче.

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

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
  }'

Вперше робите виклик? Your first API request with CheapTokens описує формат відповіді та поле usage.

Щоб закріпити процедуру, впорядкуйте кроки:

Якщо запит усе ще не проходить#

Почніть із рядка. Id моделі, що відрізняється на один символ, — звичайна причина 404, тож вставте його знову зі списку, а не передруковуйте. 402 означає, що баланс вичерпано, а ліміт частоти — 120 запитів на хвилину на API-ключ. Помилки повертаються у стандартній JSON-формі OpenAI/Anthropic, тож SDK розбирають їх як зазвичай. Повний огляд дивіться в API 401 or 404 error.

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