Skip to main content
GET
Gunakan API Key untuk melihat biaya dalam rentang waktu tertentu, dengan filter model dan pengelompokan berdasarkan model, hari kalender, atau keduanya. Hasil agregasi dikembalikan langsung tanpa membuat tugas atau melakukan polling status.

Autentikasi

string
wajib
Gunakan API Key yang sama dengan panggilan model melalui autentikasi Bearer Token. Dapatkan kunci di halaman pengelolaan API Key.
Kueri tetap dapat dilakukan saat saldo 0. Saldo tidak diperiksa, tetapi status dan masa berlaku API Key, daftar IP yang diizinkan, serta status akun tetap diperiksa.

Endpoint

Kedua endpoint memiliki fungsi yang sama dan mendukung CORS. Simpan API Key dengan aman dan jangan tampilkan dalam kode frontend publik.

Parameter permintaan

Semua parameter dikirim melalui query URL.
integer | string
Waktu mulai, inklusif. Mendukung timestamp Unix dalam detik atau string RFC3339 dengan zona waktu, misalnya 2026-09-01T00:00:00+08:00.Jika tidak diberikan, nilainya 24 jam sebelum end. Timestamp menggunakan detik, bukan milidetik.
integer | string
Waktu akhir, eksklusif. Format sama dengan start; jika tidak diberikan, menggunakan waktu saat ini.Harus setelah start, dan end - start tidak boleh melebihi 31 hari.
string
Nama model. Jika tidak diberikan, semua model dihitung. Pisahkan beberapa model dengan koma; maksimal 50.Pencocokan persis tanpa membedakan huruf besar dan kecil. Wildcard tidak didukung.Contoh: gpt-5.6-luna,sora-2
string
default:"none"
Pengelompokan:
  • none: hanya total; items berupa array kosong
  • model: berdasarkan model
  • date: berdasarkan hari kalender
  • model,date: berdasarkan model dan hari kalender
string
default:"Asia/Shanghai"
Nama zona waktu IANA. Default: Asia/Shanghai.Hanya memengaruhi batas hari jika group_by mencakup date, tanpa mengubah waktu mulai dan akhir kueri. Waktu RFC3339 dibaca menurut zona waktu dalam string tersebut.
string
default:"key"
Cakupan statistik:
  • key: hanya API Key saat ini (default)
  • account: seluruh API Key pada akun pemilik kunci saat ini
Rentang kueri adalah [start, end): mencakup awal, tidak mencakup akhir. Gunakan waktu yang sama untuk end kueri sebelumnya dan start kueri berikutnya agar batas waktu tidak dihitung dua kali.Saat menyusun URL secara manual, enkode + dalam RFC3339 sebagai %2B. cURL --data-urlencode, Python params, dan JavaScript URLSearchParams pada contoh menanganinya secara otomatis.

Contoh permintaan

Total biaya API Key saat ini selama 24 jam terakhir

Tanpa parameter query, rentang waktu, cakupan, dan pengelompokan default digunakan.

Biaya harian seluruh akun untuk model tertentu

Melihat biaya dari 11 hingga 18 September 2026, waktu Beijing, tidak termasuk 18 September.

Mengelompokkan berdasarkan model dan hari kalender

Setiap elemen items pada pengelompokan ini memuat model dan date.

Kolom respons

boolean
Keberhasilan kueri: true jika berhasil, false jika terjadi kesalahan kueri penggunaan.
object
Jika berhasil, mengembalikan cakupan kueri, total, dan rincian kelompok.
data.total dan data.items[] menggunakan kolom statistik yang sama:
object
Jika kueri penggunaan gagal, berisi code, message, dan type, dengan type bernilai usage_query_error. Kesalahan autentikasi 401 / 403 dikembalikan oleh lapisan autentikasi.

Batas permintaan dan cache

  • Maksimal 60 kueri per menit per API Key; batas API global juga berlaku
  • Hasil dengan parameter sama disimpan dalam cache selama 60 detik; header respons X-Usage-Cache bernilai hit atau miss
  • Catatan biaya biasanya tersedia dalam 1 detik, tetapi data 1 menit terakhir mungkin belum lengkap dan cache dapat menambah keterlambatan
  • Interval kueri disarankan minimal 1 menit; jangan gunakan sebagai notifikasi penagihan real-time

Dasar penghitungan

  • Menggunakan catatan panggilan yang berhasil ditagihkan, sama dengan data dasbor situs resmi
  • Panggilan gagal dan pengembalian dana setelah tugas gagal tidak dihitung; tidak perlu dikurangi sendiri. Batch gambar yang sebagian berhasil ditagihkan berdasarkan gambar yang benar-benar diberikan
  • Berdasarkan waktu pencatatan tagihan. Tugas gambar dan video asinkron dicatat saat selesai, bukan saat dikirim; tugas yang melewati tengah malam masuk ke tanggal selesai
  • API Key yang dibuat ulang setelah dihapus adalah kunci baru. Kueri scope=key pada kunci baru tidak mencakup riwayat kunci lama
  • Penyesuaian saldo manual bukan biaya panggilan dan tidak termasuk statistik
  • Data setelah 27 April 2026 tersedia

Penanganan kesalahan

503 usage_unavailable tidak mengembalikan jumlah biaya. Artinya kueri tidak tersedia, bukan biaya 0. Jangan mengubah respons gagal menjadi nilai nol atau menimpa hasil sukses sebelumnya.

Perbandingan dengan endpoint lain

Untuk sisa kuota, gunakan Kueri saldo token atau Kueri saldo pengguna.