Request API đầu tiên của bạn với CheapTokens

Hướng dẫn này đưa bạn từ một tài khoản mới đến một request hoạt động được. Bạn cần một địa chỉ email, một số dư nhỏ và một terminal. API tương thích với OpenAI, nên nếu bạn đã từng gọi OpenAI, chỉ có hai thứ thay đổi: base URL và key.

Những gì bạn cần#

• Một tài khoản. Đăng ký bằng email — không cần mật khẩu, chúng tôi gửi cho bạn một liên kết đăng nhập.
• Một số dư. Không có gói đăng ký: bạn nạp số dư bằng USD và mỗi request được tính phí theo token với mức giá cố định của model.
• Một API key từ dashboard của bạn.

Bước 1. Tạo tài khoản và nạp tiền#

Mở trang đăng ký, nhập email của bạn và làm theo liên kết trong thư. Trong dashboard nhấn Top up và chọn cách thanh toán:

• Crypto — từ $5; áp dụng phí nạp 5%.
• Thẻ — thông qua một đối tác, đối tác này thu phí riêng của họ.

Bước 2. Sao chép API key#

Ngay khi số dư lớn hơn 0 — sau khi nạp tiền hoặc nhận thưởng giới thiệu — dashboard sẽ tạo API key và hiển thị nó một lần. Hãy sao chép ngay và giữ nó ngoài mã nguồn của bạn, ví dụ trong một biến môi trường:

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

Nếu key bị lộ, nhấn Rotate: bạn nhận được một key mới và key cũ ngừng hoạt động.

Bước 3. Chọn một model#

Các request cần ID model đầy đủ — với tiền tố trước dấu gạch chéo, đúng như API liệt kê. Danh mục tại thời điểm viết (tháng 10 năm 2026):

Danh mục có thể thay đổi, nên nguồn chân lý chính là API. Request này không cần key:

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

Bước 4. Gửi 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"}]
  }'

Một câu trả lời thành công trả về theo định dạng Chat Completions chuẩn. Một ví dụ rút gọn — văn bản, ID và số của bạn sẽ khác, và phản hồi có thể chứa thêm các trường dịch vụ:

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

• Văn bản nằm trong choices[0].message.content.
• Lượng token sử dụng nằm trong usage: prompt_tokens — đầu vào, completion_tokens — đầu ra. Hai con số này là những gì request được tính phí.

Python#

Cài đặt SDK chính thức bằng pip install openai và trỏ nó đến base URL của chúng tôi:

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#

Cài đặt SDK bằng 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);

Các client kiểu Anthropic#

Các client được xây dựng cho Anthropic Messages API dùng địa chỉ gốc không có /v1 — https://api.cheaptokens.dev — và gửi key trong header x-api-key. Các SDK Anthropic tự thêm đường dẫn và header; bạn chỉ cần đặt base URL và key.

Nếu có gì đó không ổn#

• 401 Invalid API key — key bị nhập sai hoặc đã bị rotate. Kiểm tra rằng bạn đã dán toàn bộ; dashboard chỉ hiển thị key một lần, nên nếu bị mất, nhấn Rotate để lấy key mới.
• 402 — số dư đã hết, hoặc request được gửi đi mà không có header Authorization.
• 400 Model "…" not found — dùng ID model đầy đủ từ /v1/models, bao gồm tiền tố trước dấu gạch chéo.
• 404 — kiểm tra địa chỉ: các client kiểu OpenAI cần /v1 ở cuối base URL.

Thêm các trường hợp và cách khắc phục: Các lỗi kết nối thường gặp và cách sửa chúng.

Chi phí là bao nhiêu#

Mỗi request được tính phí cho token đầu vào và đầu ra riêng biệt, theo mức giá của model trên mỗi triệu token. Giá hiện tại — cùng dữ liệu như trên trang giá:

Bước tiếp theo: kết nối một coding agent, ví dụ Cline, hoặc học cách ước tính chi phí của một AI agent.

Bạn giới thiệu CheapTokens cho các lập trình viên khác? Với chương trình giới thiệu, bạn nhận phần trăm từ các lần nạp tiền của họ.