Ang iyong unang API request sa CheapTokens

Dinadala ka ng gabay na ito mula sa bagong account tungo sa gumaganang request. Kailangan mo ng email address, maliit na balanse at terminal. Ang API ay OpenAI-compatible, kaya kung nakatawag ka na sa OpenAI dati, dalawang bagay lang ang nagbabago: ang base URL at ang key.

Ano ang kailangan mo#

• Isang account. Ang sign-up ay sa pamamagitan ng email — walang password, nagpapadala kami ng sign-in link.
• Isang balanse. Walang subscription: nagto-top up ka ng USD balance at ang bawat request ay sinisingil per token sa fixed rate ng modelo.
• Isang API key mula sa iyong dashboard.

Hakbang 1. Gumawa ng account at mag-top up#

Buksan ang sign-up page, ilagay ang iyong email at sundan ang link mula sa sulat. Sa dashboard pindutin ang Top up at piliin kung paano magbabayad:

• Crypto — mula $5; may 5% deposit fee.
• Card — sa pamamagitan ng partner, na may sariling fee.

Hakbang 2. Kopyahin ang iyong API key#

Sa sandaling lumampas sa zero ang iyong balanse — pagkatapos ng top-up o referral bonus — gagawa ang dashboard ng iyong API key at ipapakita ito nang isang beses. Kopyahin agad ito at ilayo sa iyong code, halimbawa sa isang environment variable:

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

Kung ma-leak ang key, pindutin ang Rotate: makakakuha ka ng bagong key at titigil na gumana ang luma.

Hakbang 3. Pumili ng modelo#

Ang mga request ay nangangailangan ng buong model ID — kasama ang prefix bago ang slash, eksakto kung paano ito nakalista ng API. Ang catalog sa oras ng pagsulat (Oktubre 2026):

Maaaring magbago ang catalog, kaya ang source of truth ay ang API mismo. Ang request na ito ay hindi nangangailangan ng key:

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

Hakbang 4. Ipadala ang request#

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

Ang matagumpay na sagot ay bumabalik sa standard na Chat Completions format. Isang pinaikling halimbawa — magkakaiba ang iyong text, IDs at numero, at maaaring may dagdag na service fields ang response:

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

• Ang text ay nasa choices[0].message.content.
• Ang token usage ay nasa usage: prompt_tokens — input, completion_tokens — output. Ang dalawang numerong ito ang sinisingil para sa request.

Python#

I-install ang official SDK gamit ang pip install openai at ituro ito sa aming base 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#

I-install ang SDK gamit ang 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);

Mga Anthropic-style na client#

Ang mga client na ginawa para sa Anthropic Messages API ay gumagamit ng root address na walang /v1 — https://api.cheaptokens.dev — at ipinapadala ang key sa x-api-key header. Ang mga Anthropic SDK ay mismo ang nagdadagdag ng path at header; base URL at key lang ang itinatakda mo.

Kung may mali#

• 401 Invalid API key — mali ang pagkakasulat ng key o na-rotate ito. Tiyakin na na-paste mo ito nang buo; ang dashboard ay nagpapakita ng key nang isang beses lang, kaya kung nawala ito, pindutin ang Rotate para makakuha ng bago.
• 402 — naubos na ang balanse, o ang request ay naipadala nang walang Authorization header.
• 400 Model "…" not found — gamitin ang buong model ID mula sa /v1/models, kasama ang prefix bago ang slash.
• 404 — suriin ang address: ang mga OpenAI-style na client ay nangangailangan ng /v1 sa dulo ng base URL.

Higit pang mga kaso at fix: Common connection errors and how to fix them.

Magkano ang gastos#

Ang bawat request ay sinisingil para sa input at output tokens nang hiwalay, sa rate ng modelo per million tokens. Kasalukuyang mga presyo — parehong data tulad ng nasa pricing page:

Susunod na hakbang: ikonekta ang coding agent, halimbawa Cline, o matutunan kung paano tantiyahin ang magagastos ng AI agent.

Inirerekomenda mo ba ang CheapTokens sa ibang developer? Sa referral program, makakatanggap ka ng porsyento ng kanilang mga top-up.