Kembali ke blog

MemulaiPanduan

Permintaan API pertama Anda dengan CheapTokens

Dari akun baru hingga permintaan yang berhasil dalam sekitar lima menit — saldo, kunci API, ID model, dan contoh curl, Python, serta JavaScript yang siap dijalankan.

Oleh CheapTokens TeamDiterbitkan 3 menit baca

Jendela terminal dengan permintaan curl ke api.cheaptokens.dev/v1/chat/completions dan respons JSON
Di halaman ini
  1. Yang Anda butuhkan
  2. Langkah 1. Buat akun dan isi saldo
  3. Langkah 2. Salin kunci API Anda
  4. Langkah 3. Pilih model
  5. Langkah 4. Kirim permintaan
  6. curl
  7. Python
  8. JavaScript
  9. Klien bergaya Anthropic
  10. Jika ada yang tidak beres
  11. Berapa biayanya

Panduan ini membawa Anda dari akun baru hingga permintaan yang berhasil. Anda memerlukan alamat email, saldo kecil, dan terminal. API ini kompatibel dengan OpenAI, jadi jika Anda pernah memanggil OpenAI sebelumnya, hanya dua hal yang berubah: base URL dan kuncinya.

Yang Anda butuhkan#

  • Akun. Pendaftaran melalui email — tanpa kata sandi, kami mengirimkan tautan masuk.
  • Saldo. Tidak ada langganan: Anda mengisi saldo USD dan setiap permintaan ditagih per token dengan tarif tetap model.
  • Kunci API dari dasbor Anda.

Langkah 1. Buat akun dan isi saldo#

Buka halaman pendaftaran, masukkan email Anda dan ikuti tautan dari surat tersebut. Di dasbor tekan Top up dan pilih cara pembayaran:

  • Kripto — mulai dari $5; berlaku biaya deposit 5%.
  • Kartu — melalui mitra, yang mengenakan biayanya sendiri.

Langkah 2. Salin kunci API Anda#

Begitu saldo Anda lebih dari nol — setelah isi ulang atau bonus referral — dasbor membuat kunci API Anda dan menampilkannya sekali. Segera salin dan simpan di luar kode Anda, misalnya dalam variabel lingkungan:

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

Jika kunci bocor, tekan Rotate: Anda mendapat kunci baru dan kunci lama berhenti berfungsi.

Langkah 3. Pilih model#

Permintaan memerlukan ID model lengkap — dengan awalan sebelum garis miring, persis seperti yang terdaftar di API. Katalog saat penulisan (Oktober 2026):

Model ID model API Konteks Output maks
GLM-5.3-Flash zai-org/GLM-5.3-Flash 390K token 8.192 token
DeepSeek-V4-Flash deepseek-ai/DeepSeek-V4-Flash-0731 380K token 32.768 token
MiniMax-M2.7 MiniMaxAI/MiniMax-M2.7 200K token 8.192 token

Katalog dapat berubah, jadi sumber kebenarannya adalah API itu sendiri. Permintaan ini tidak memerlukan kunci:

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

Langkah 4. Kirim permintaan#

curl#

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

Jawaban yang berhasil kembali dalam format Chat Completions standar. Contoh yang dipersingkat — teks, ID, dan angka Anda akan berbeda, dan respons mungkin membawa bidang layanan tambahan:

json
{
  "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 }
}
  • Teks ada di choices[0].message.content.
  • Penggunaan token ada di usage: prompt_tokens — input, completion_tokens — output. Kedua angka inilah yang ditagih untuk permintaan tersebut.

Python#

Instal SDK resmi dengan pip install openai dan arahkan ke base URL kami:

python
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#

Instal SDK dengan npm install openai:

javascript
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);

Klien bergaya Anthropic#

Klien yang dibuat untuk Anthropic Messages API menggunakan alamat root tanpa /v1 — https://api.cheaptokens.dev — dan mengirim kunci di header x-api-key. SDK Anthropic menambahkan path dan header sendiri; Anda hanya mengatur base URL dan kuncinya.

Jika ada yang tidak beres#

  • 401 Invalid API key — kunci salah ketik atau sudah dirotasi. Periksa bahwa Anda menempelkannya utuh; dasbor hanya menampilkan kunci sekali, jadi jika hilang, tekan Rotate untuk mendapat kunci baru.
  • 402 — saldo habis, atau permintaan dikirim tanpa header Authorization.
  • 400 Model "…" not found — gunakan ID model lengkap dari /v1/models, termasuk awalan sebelum garis miring.
  • 404 — periksa alamatnya: klien bergaya OpenAI memerlukan /v1 di akhir base URL.

Kasus dan perbaikan lainnya: Kesalahan koneksi umum dan cara memperbaikinya.

Berapa biayanya#

Setiap permintaan ditagih untuk token input dan output secara terpisah, dengan tarif model per juta token. Harga saat ini — data yang sama seperti di halaman harga:

Model Konteks Input $/1Jt Output $/1Jt OpenRouter in OpenRouter out
GLM-5.3-Flash reasoning 390K $0.027 $0.08 $0.048 $0.20
DeepSeek-V4-Flash 380K $0.0221 $0.10 $0.016 $0.64
MiniMax-M2.7 200K $0.05 $0.15 $0.30 $1.20

Harga dalam USD per 1 juta token. Angka OpenRouter ditampilkan sebagai perbandingan dan dapat berubah sewaktu-waktu.

Langkah selanjutnya: hubungkan agen coding, misalnya Cline, atau pelajari cara memperkirakan biaya agen AI.

Merekomendasikan CheapTokens ke developer lain? Lewat program referral, Anda mendapat persentase dari isi ulang mereka.