Ваш перший API-запит із CheapTokens

Цей посібник проведе вас від нового акаунта до робочого запиту. Вам потрібні електронна адреса, невеликий баланс і термінал. API сумісний з OpenAI, тож якщо ви вже викликали OpenAI, змінюються лише дві речі: базова URL-адреса та ключ.

Що вам потрібно#

• Акаунт. Реєстрація за електронною адресою — без пароля, ми надсилаємо вам посилання для входу.
• Баланс. Підписки немає: ви поповнюєте баланс у доларах США, і кожен запит оплачується за токенами за фіксованим тарифом моделі.
• API-ключ з вашої панелі керування.

Крок 1. Створіть акаунт і поповніть баланс#

Відкрийте сторінку реєстрації, введіть свою електронну адресу та перейдіть за посиланням із листа. У панелі керування натисніть Top up і виберіть спосіб оплати:

• Криптовалюта — від $5; застосовується 5% комісія за депозит.
• Картка — через партнера, який стягує власну комісію.

Крок 2. Скопіюйте API-ключ#

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

export CHEAPTOKENS_API_KEY="paste-your-key-here"

Якщо ключ витік, натисніть Rotate: ви отримаєте новий ключ, а старий перестане працювати.

Крок 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 та числа відрізнятимуться, а відповідь може містити додаткові службові поля:

{
  "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 і вкажіть йому нашу базову URL-адресу:

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 додають шлях і заголовок самостійно; ви лише задаєте базову URL-адресу та ключ.

Якщо щось пішло не так#

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

Більше випадків і рішень: Поширені помилки з'єднання та як їх виправити.

Скільки це коштує#

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

Наступний крок: підключіть агента для програмування, наприклад Cline, або навчіться оцінювати, скільки коштуватиме AI-агент.

Радите CheapTokens іншим розробникам? За реферальною програмою ви отримуєте відсоток від їхніх поповнень.