Первый API-запрос через CheapTokens

Эта инструкция проведёт от нового аккаунта до работающего запроса. Понадобятся email, небольшой баланс и терминал. API совместим с OpenAI: если вы уже обращались к OpenAI, меняются только адрес API и ключ.

Что понадобится#

• Аккаунт. Регистрация по email — без пароля, мы пришлём ссылку для входа.
• Баланс. Подписки нет: вы пополняете баланс в долларах, а каждый запрос списывается по токенам по фиксированному тарифу модели.
• API-ключ из личного кабинета.

Шаг 1. Зарегистрируйтесь и пополните баланс#

Откройте страницу регистрации, введите email и перейдите по ссылке из письма. В кабинете нажмите Пополнить и выберите способ оплаты:

• Криптовалюта — от $5, комиссия за пополнение 5%.
• Карта — через партнёра, у него своя комиссия.

Шаг 2. Скопируйте API-ключ#

Как только на балансе появятся деньги — после пополнения или реферального бонуса, — кабинет сам создаст API-ключ и покажет его один раз. Сразу скопируйте его и не храните в коде, например положите в переменную окружения:

export CHEAPTOKENS_API_KEY="вставьте-ваш-ключ"

Если ключ утёк, нажмите Обновить: вы получите новый ключ, а старый перестанет работать.

Шаг 3. Выберите модель#

В запросе нужен полный ID модели — с префиксом до косой черты, ровно как его отдаёт API. Каталог на момент написания (октябрь 2026 года):

Каталог может меняться, поэтому источник истины — сам API. Этот запрос не требует ключа:

curl https://api.cheaptokens.dev/v1/models

Шаг 4. Отправьте запрос#

curl#

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": "Say hello in three languages"}]
  }'

Успешный ответ приходит в стандартном формате Chat Completions. Сокращённый пример — ваш текст, идентификаторы и числа будут другими, в ответе могут быть и служебные поля:

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Hello! Hola! Bonjour!" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 14, "completion_tokens": 9, "total_tokens": 23 }
}

• Текст ответа — в choices[0].message.content.
• Расход токенов — в usage: prompt_tokens — вход, completion_tokens — выход. Именно за эти два числа списывается оплата запроса.

Python#

Установите официальный SDK командой pip install openai и укажите наш адрес API:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)
resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": "Say hello in three languages"}],
)
print(resp.choices[0].message.content)
print("tokens in/out:", resp.usage.prompt_tokens, resp.usage.completion_tokens)

JavaScript#

Установите SDK командой npm install openai:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.cheaptokens.dev/v1",
  apiKey: process.env.CHEAPTOKENS_API_KEY,
});
const resp = await client.chat.completions.create({
  model: "deepseek-ai/DeepSeek-V4-Flash-0731",
  messages: [{ role: "user", content: "Say hello in three languages" }],
});
console.log(resp.choices[0].message.content);

Клиенты в стиле Anthropic#

Клиенты для Anthropic Messages API используют корневой адрес без /v1 — https://api.cheaptokens.dev — и передают ключ в заголовке x-api-key. SDK Anthropic добавляют путь и заголовок сами: достаточно указать адрес и ключ.

Если что-то пошло не так#

• 401 Invalid API key — ключ скопирован с ошибкой или был заменён новым. Проверьте, что вставили его целиком; кабинет показывает ключ только один раз, поэтому если он потерян — нажмите Обновить и получите новый.
• 402 — закончился баланс или запрос ушёл без заголовка Authorization.
• 400 Model "…" not found — укажите полный ID модели из /v1/models, вместе с префиксом до косой черты.
• 404 — проверьте адрес: клиентам в стиле OpenAI нужен /v1 в конце адреса API.

Другие случаи и их решения — в статье Частые ошибки подключения и их исправление.

Сколько это стоит#

Каждый запрос оплачивается за входные и выходные токены отдельно, по тарифу модели за миллион токенов. Актуальные цены — те же данные, что на странице цен:

Дальше: подключите агента для кода, например Cline, или узнайте, как рассчитать расходы AI-агента.

Советуете CheapTokens другим разработчикам? По реферальной программе вы получаете процент от их пополнений.