Pelacak Biaya API AI: Pantau Pengeluaran dengan Header
Anda dapat membuat pelacak biaya API AI dalam sekitar lima puluh baris, karena setiap respons sudah memberi tahu Anda sisa saldo. Panduan ini menunjukkan cara mencatat pengeluaran per permintaan, membaca endpoint saldo, dan memicu peringatan sebelum saldo habis.


Poin utama
- Setiap respons membawa header X-Balance-USD dengan sisa kredit Anda.
- GET /v1/balance dan endpoint credit_grants mengembalikan saldo sesuai permintaan.
- Biaya per panggilan adalah (input x 0,15 + output x 0,50) / 1.000.000 dolar.
- Log ke CSV, lalu beri peringatan ketika saldo turun di bawah ambang batas.
Dari mana angka berasal
Saldo prabayar membuat pelacakan biaya menjadi sederhana, karena penyedia sudah menyimpan total kumulatif. Anda mendapatkannya di tiga tempat:
- Header respons
X-Balance-USDpada panggilan API, menunjukkan sisa setelah permintaan. GET /v1/balance, pencarian saldo sederhana.GET /v1/dashboard/billing/credit_grants, rute gaya OpenAI yang alat seperti dasbor dan wrapper sudah tahu cara memanggilnya.
Di samping itu, setiap penyelesaian mengembalikan objek usage dengan jumlah token prompt dan completion. Gabungkan token dengan harga ($0,15 per 1M input, $0,50 per 1M output) dan Anda dapat menghitung biaya permintaan apa pun sendiri, lalu membandingkannya dengan penurunan saldo. Keduanya harus sesuai. Jika tidak, Anda telah menemukan sesuatu untuk diselidiki. Detail parameter lengkap ada di dokumentasi.
Baca header dalam satu permintaan
Dengan curl, tambahkan -i dan lihat header:
curl -si https://api.uncensoredaiapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say hi."}]}' \
| grep -i "x-balance-usd"
Di Python, SDK OpenAI mengekspos respons mentah melalui with_raw_response, yang memberi Anda header dan objek yang diparsing bersama:
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredaiapis.com/v1", api_key="sk-your-key")
raw = client.chat.completions.with_raw_response.create(
model="uncensored",
messages=[{"role": "user", "content": "Say hi."}],
)
resp = raw.parse()
print(raw.headers.get("x-balance-usd"), resp.usage.total_tokens)Logger kecil yang mencatat setiap panggilan
Bungkus panggilan Anda dalam satu fungsi dan tulis baris CSV setiap kali. Baris tersebut memiliki waktu, ID permintaan, jumlah token, biaya yang dihitung, dan saldo.
import csv, time
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredaiapis.com/v1", api_key="sk-your-key")
PRICE_IN, PRICE_OUT = 0.15, 0.50 # dollars per 1M tokens
LOG = "api_spend.csv"
def cost(usage):
return (usage.prompt_tokens * PRICE_IN + usage.completion_tokens * PRICE_OUT) / 1_000_000
def tracked_chat(messages, tag="default"):
raw = client.chat.completions.with_raw_response.create(
model="uncensored", messages=messages)
r = raw.parse()
row = [
time.strftime("%Y-%m-%d %H:%M:%S"),
raw.headers.get("x-request-id"),
tag,
r.usage.prompt_tokens,
r.usage.completion_tokens,
round(cost(r.usage), 6),
raw.headers.get("x-balance-usd"),
]
with open(LOG, "a", newline="") as f:
csv.writer(f).writerow(row)
return r, row
Argumen tag adalah trik yang membuat log berguna. Berikan nama fitur seperti "ringkasan" atau "obrolan", dan nanti Anda dapat menjumlahkan biaya berdasarkan tag untuk melihat bagian produk mana yang menghabiskan uang. ID permintaan membantu jika Anda perlu bertanya tentang biaya atau melaporkan masalah, karena itu mengidentifikasi panggilan yang tepat.
Verifikasi sederhana matematika
Ambil panggilan dengan 2.400 token input dan 600 token output:
- Input: 2.400 x 0,15 / 1.000.000 = $0,00036
- Output: 600 x 0,50 / 1.000.000 = $0,00030
- Total: $0.00066
Seribu panggilan seperti itu berharga $0,66. Jika CSV Anda menunjukkan saldo turun jauh lebih cepat daripada jumlah biaya yang dihitung, periksa pencobaan ulang yang tidak Anda log, pekerjaan latar belakang yang menggunakan kunci yang sama, atau streaming yang Anda biarkan terbuka. Permintaan yang gagal atau ditolak tidak dikenakan biaya, sehingga kesalahan seharusnya tidak mengubah saldo. Bandingkan total dari banyak panggilan, bukan yang tunggal, agar perbedaan pembulatan kecil rata-ratanya hilang.
Panggilan streaming dan penggunaan
Dengan stream: true, angka penggunaan tiba di akhir stream. Kumpulkan dari potongan terakhir, lalu log baris setelah stream ditutup.
def tracked_stream(messages, tag="chat"):
usage = None
for chunk in client.chat.completions.create(
model="uncensored", messages=messages, stream=True):
if chunk.choices and chunk.choices[0].delta.content:
yield chunk.choices[0].delta.content
usage = getattr(chunk, "usage", None) or usage
if usage:
with open(LOG, "a", newline="") as f:
csv.writer(f).writerow([time.strftime("%F %T"), "", tag,
usage.prompt_tokens, usage.completion_tokens, round(cost(usage), 6), ""])
Jika Anda hanya membutuhkan saldo, panggil GET /v1/balance setelah stream berakhir. Ini adalah permintaan murah, dan berfungsi sebagai pemeriksaan berkala dari job cron juga.
Menjumlahkan pengeluaran berdasarkan fitur
CSV hanya berguna jika Anda membacanya. Skrip pendek ini menjumlahkan biaya berdasarkan tag dan menampilkan saldo terbaru, tanpa paket tambahan.
import csv
from collections import defaultdict
totals, last_balance = defaultdict(float), None
with open("api_spend.csv") as f:
for row in csv.reader(f):
ts, req_id, tag, pin, pout, cost_usd, balance = row
totals[tag] += float(cost_usd)
last_balance = balance or last_balance
for tag, usd in sorted(totals.items(), key=lambda kv: -kv[1]):
print(f"{tag:15s} ${usd:.4f}")
print("latest balance:", last_balance)
Jalankan setiap hari dan tempelkan output ke saluran tim Anda. Biaya yang sebelumnya tidak terlihat menjadi angka yang dapat didiskusikan orang, dan fitur yang biayanya sepuluh kali lipat dari yang lain langsung terlihat. Untuk anggaran kasar, kalikan total harian dengan 30 dan tambahkan 20 persen ruang gerak.
Tambahkan peringatan saldo rendah
Habis kredit di tengah hari membuat produk offline, jadi beri peringatan lebih awal. Job cron yang berjalan setiap 15 menit sudah cukup.
import requests
BASE = "https://api.uncensoredaiapis.com/v1"
THRESHOLD = 5.00 # dollars
r = requests.get(BASE + "/balance", headers={"Authorization": "Bearer sk-your-key"}, timeout=10)
print(r.status_code, r.text) # inspect the JSON once to see the field name
# After you know the field name, parse it and compare with THRESHOLD,
# then post to your chat webhook or send an email.
Cetak JSON mentah sekali dan lihat sebelum menulis kode parsing. Nama bidang asli membutuhkan waktu sepuluh detik untuk diperiksa, dan menebaknya dari artikel dapat merusak peringatan secara diam-diam. Pilih ambang batas yang mencakup setidaknya satu hari pengeluaran normal, yang bisa Anda lihat dari CSV: jumlah biaya kemarin dan gunakan sebagai minimum.
Saat peringatan aktif, isi saldo. Jumlah bulat dari $20 hingga $500 berlaku, dengan tambahan kredit 5% dari $50, 10% dari $100 dan 15% dari $200, dan kredit tidak akan habis. Untuk mendapatkan kunci terlebih dahulu untuk pelacak, gunakan halaman kunci API.
Kebiasaan yang membuat pengeluaran dapat diprediksi
- Gunakan satu kunci per lingkungan agar lalu lintas pengujian tidak pernah tersembunyi dalam angka produksi.
- Batasi
max_tokenspada endpoint di mana jawaban panjang tidak diperlukan. Ini opsional secara default, sehingga balasan tanpa batas dimungkinkan. - Potong riwayat obrolan. Token input lebih murah daripada output, tetapi riwayat panjang yang diulang setiap giliran akan terakumulasi.
- Tinjau total mingguan berdasarkan tag, dan cari tag yang lebih dari setengah tagihan.
Satu kebiasaan lagi: simpan ID permintaan dengan setiap baris yang dicatat. Jika angka terlihat salah sebulan kemudian, Anda dapat mencocokkannya dengan panggilan spesifik daripada berdebat dari rata-rata. Karena permintaan yang gagal tidak ditagih, retry pada kesalahan tidak menambah biaya, tetapi retry setelah jawaban sukses menambah biaya, jadi pastikan logika retry Anda hanya aktif pada kegagalan nyata. Bug yang mengirim ulang permintaan sukses dalam loop adalah penyebab paling umum dari tagihan tak terduga dengan API per-token.
Panduan lainnya
Tanya jawab
Apakah header saldo muncul di setiap respons?
Header X-Balance-USD adalah bagian dari header respons yang tercantum untuk API ini. Bacalah dari respons mentah dan anggap nilai yang hilang sebagai tidak diketahui.
Bisakah saya mendapatkan biaya tanpa mencatat setiap permintaan?
Ya. Lakukan polling GET /v1/balance secara berkala dan hitung selisih antar pembacaan.
Apakah permintaan yang gagal mengubah saldo?
Tidak. Permintaan yang gagal atau ditolak tidak dikenakan biaya.
Endpoint mana yang harus digunakan oleh alat dashboard OpenAI yang sudah ada?
Gunakan rute GET /v1/dashboard/billing/credit_grants bergaya OpenAI, yang sudah didukung oleh banyak alat.
Kunci Anda hanya selangkah lagi dari satu formulir
Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh proses pengaturannya.