Permintaan pertama ke CheapTokens di Python dengan requests, tanpa SDK

Anda tidak perlu paket openai untuk berbicara dengan API yang kompatibel dengan OpenAI. Satu panggilan requests.post, kunci Bearer, dan body JSON sudah cukup, dan Anda bisa melihat persis apa yang dikirim melalui jaringan. Panduan ini membangun skrip tersebut untuk CheapTokens (https://api.cheaptokens.dev/v1/chat/completions) dan diakhiri dengan mencetak jawaban, finish_reason, dan penggunaan token.

Ini cocok jika Anda berada di mesin yang terkunci di mana hanya requests yang terpasang, jika cron job kecil tidak boleh menarik SDK, atau jika Anda hanya ingin memahami apa yang dilakukan SDK untuk Anda. Panduan permintaan pertama mencakup SDK, curl, dan Node; ini adalah versi Python murni.

Seluruh skrip#

Simpan kunci Anda di variabel lingkungan terlebih dahulu (lihat cara menyimpan kunci API dengan aman), lalu simpan ini sebagai ask.py:

import os
import requests

url = "https://api.cheaptokens.dev/v1/chat/completions"
headers = {"Authorization": f"Bearer {os.environ['CHEAPTOKENS_API_KEY']}"}
payload = {
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [
        {"role": "user", "content": "Explain what a token is in two sentences."}
    ],
    "max_tokens": 200,
}

try:
    r = requests.post(url, headers=headers, json=payload, timeout=30)
    r.raise_for_status()
except requests.exceptions.Timeout:
    raise SystemExit("No reply within 30 seconds - try again or raise the timeout")
except requests.exceptions.HTTPError as e:
    raise SystemExit(f"HTTP {e.response.status_code}: {e.response.text}")

data = r.json()
choice = data["choices"][0]
print(choice["message"]["content"])
print("finish_reason:", choice["finish_reason"])
print("usage:", data["usage"])

Jalankan python ask.py. Id model adalah id gateway lengkap, deepseek-ai/DeepSeek-V4-Flash-0731; jika Anda tidak yakin apa yang harus diisi, daftar model dengan GET /v1/models. Untuk mencoba model lain, ganti dengan zai-org/GLM-5.3-Flash dan jangan ubah apa pun: satu saldo mencakup semua model.

Apa yang dilakukan setiap baris#

Berikut lima ide yang menjadi dasar skrip. Quickstart requests (dokumen hidup, diperiksa 2 November 2026) menjelaskan sebagian besarnya, dan referensi Chat Completions dari OpenAI mendefinisikan field dalam balasan.

Poin ketiga adalah yang sering dilewatkan orang. Skrip yang menggantung selamanya di cron job jauh lebih buruk daripada skrip yang gagal dengan jelas setelah 30 detik.

Membaca balasan#

Respons yang berhasil adalah JSON. Bagian yang Anda pedulikan, menurut referensi Chat Completions:

• choices[0].message.content adalah teksnya. Nilainya bisa null, jadi jangan memanggil metode string padanya secara sembarangan.
• choices[0].finish_reason menyatakan mengapa model berhenti: stop (selesai), length (dipotong oleh batas max_tokens), tool_calls, content_filter.
• usage.prompt_tokens, usage.completion_tokens dan usage.total_tokens adalah yang Anda bayar: input, output, dan jumlahnya.

Balasan memiliki bentuk ini (angkanya adalah placeholder):

{
  "choices": [
    {
      "message": {"role": "assistant", "content": "A token is a small piece of text..."},
      "finish_reason": "stop"
    }
  ],
  "usage": {"prompt_tokens": 18, "completion_tokens": 52, "total_tokens": 70}
}

Saat tidak berhasil#

Skrip mengubah sebagian besar kegagalan menjadi satu baris output. Berikut arti umum masing-masing:

Untuk body error yang sebenarnya dan pemeriksaan langkah demi langkah kunci, base URL, dan id model, gunakan Error API 401 atau 404: kunci, base URL, atau id model salah. Dua jebakan kecil: jika Anda melihat KeyError: 'choices', Anda mem-parse body error sebagai keberhasilan, yang berarti raise_for_status() dilewati. Dan jika mesin Anda memiliki file ~/.netrc, requests dapat menggunakan kredensialnya alih-alih header Authorization yang Anda setel.

Berapa biaya satu panggilan#

Dengan angka placeholder dari balasan di atas (sekitar 18 token masuk, 52 keluar), satu panggilan ke DeepSeek-V4-Flash berbiaya $0.0000055. Itu angka yang tidak bisa Anda rasakan, jadi skalakan. Katakanlah skrip Anda merangkum 1.000 tiket dukungan per hari, kira-kira 800 token masuk dan 300 keluar masing-masing:

Harga tetap per model, tanpa jam sibuk, jadi skrip yang sama berbiaya sama pada pukul 3 pagi dan siang. Harga per model saat ini ada di halaman harga, dan dokumen mencantumkan endpoint-nya.

Langkah selanjutnya#

Setelah ini berhasil, langkah berikutnya yang biasa adalah loop atas banyak input, retry pada 429 (lihat 429 Too Many Requests: retry dengan backoff), atau panggilan yang sama dengan streaming. Jika Anda lebih suka tidak mengelola HTTP sendiri, jalur SDK hanya berjarak satu perubahan base_url.