Twoje pierwsze żądanie API w CheapTokens

Ten przewodnik prowadzi od nowego konta do działającego żądania. Potrzebujesz adresu e-mail, niewielkiego salda i terminala. API jest zgodne z OpenAI, więc jeśli wcześniej wywoływałeś OpenAI, zmieniają się tylko dwie rzeczy: bazowy adres URL i klucz.

Co jest potrzebne#

• Konto. Rejestracja odbywa się przez e-mail — bez hasła, wysyłamy link do logowania.
• Saldo. Nie ma subskrypcji: doładowujesz saldo w USD, a każde żądanie jest rozliczane za token według stałej stawki modelu.
• Klucz API z panelu.

Krok 1. Utwórz konto i doładuj saldo#

Otwórz stronę rejestracji, podaj swój e-mail i kliknij link z wiadomości. W panelu naciśnij Doładuj i wybierz sposób płatności:

• Kryptowaluty — od 5 USD; obowiązuje 5% opłata za wpłatę.
• Karta — przez partnera, który pobiera własną opłatę.

Krok 2. Skopiuj klucz API#

Gdy tylko saldo będzie większe od zera — po doładowaniu lub bonusie poleceniowym — panel sam utworzy klucz API i pokaże go jeden raz. Skopiuj go od razu i trzymaj poza kodem, na przykład w zmiennej środowiskowej:

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

Jeśli klucz wycieknie, naciśnij Rotuj: otrzymasz nowy klucz, a stary przestanie działać.

Krok 3. Wybierz model#

Żądania wymagają pełnego identyfikatora modelu — z prefiksem przed ukośnikiem, dokładnie tak, jak podaje go API. Katalog w momencie pisania (październik 2026):

Katalog może się zmieniać, więc źródłem prawdy jest samo API. To żądanie nie wymaga klucza:

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

Krok 4. Wyślij żądanie#

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

Pomyślna odpowiedź wraca w standardowym formacie Chat Completions. Skrócony przykład — Twój tekst, identyfikatory i liczby będą inne, a odpowiedź może zawierać dodatkowe pola serwisowe:

{
  "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 }
}

• Tekst znajduje się w choices[0].message.content.
• Zużycie tokenów znajduje się w usage: prompt_tokens — wejście, completion_tokens — wyjście. Te dwie liczby są podstawą rozliczenia żądania.

Python#

Zainstaluj oficjalny SDK za pomocą pip install openai i wskaż nasz bazowy adres 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#

Zainstaluj SDK za pomocą 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);

Klienci w stylu Anthropic#

Klienci zbudowani dla Anthropic Messages API używają adresu głównego bez /v1 — https://api.cheaptokens.dev — i wysyłają klucz w nagłówku x-api-key. SDK Anthropic same dodają ścieżkę i nagłówek; ustawiasz tylko bazowy adres URL i klucz.

Jeśli coś pójdzie nie tak#

• 401 Invalid API key — klucz jest błędnie wpisany lub został zrotowany. Sprawdź, czy wkleiłeś go w całości; panel pokazuje klucz tylko raz, więc jeśli został zgubiony, naciśnij Rotuj, aby uzyskać nowy.
• 402 — saldo zostało wyczerpane lub żądanie wyszło bez nagłówka Authorization.
• 400 Model "…" not found — użyj pełnego identyfikatora modelu z /v1/models, wraz z prefiksem przed ukośnikiem.
• 404 — sprawdź adres: klienci w stylu OpenAI potrzebują /v1 na końcu bazowego adresu URL.

Więcej przypadków i rozwiązań: Typowe błędy połączenia i jak je naprawić.

Ile to kosztuje#

Każde żądanie jest rozliczane za tokeny wejściowe i wyjściowe osobno, według stawki modelu za milion tokenów. Aktualne ceny — te same dane co na stronie z cennikiem:

Następny krok: podłącz agenta kodującego, na przykład Cline, albo naucz się szacować koszt agenta AI.

Polecasz CheapTokens innym programistom? W programie poleceń otrzymujesz procent od ich doładowań.