Docs / Panduan
Project dan budget
Kelompokkan key ke dalam project, beri project budget harian atau bulanan, dan arsipkan project yang tidak dipakai.
Terakhir diperbarui
Apa itu project
Project adalah kelompok API key. Pakai project untuk memisahkan aplikasi, lingkungan, atau tim, misalnya production dan staging.
- Setiap key berada di tepat satu project.
- Setiap akun dimulai dengan project bernama Default. Key yang dibuat tanpa project masuk ke sana.
- Saldo hanya satu per akun. Project membatasi pengeluaran; project bukan dompet terpisah.
Membuat project
Buka Project di dashboard untuk membuat, mengganti nama, atau mengarsipkan project. Saat membuat key di Key, pilih project-nya.
Usage, Requests, dan ekspor CSV bisa difilter per project. Total semua project sama dengan total akun.
Budget
Setiap project bisa punya budget harian, budget bulanan, atau keduanya. Keduanya opsional; budget kosong berarti tanpa budget. Budget bekerja seperti limit di key, tetapi menghitung pengeluaran semua key di project itu.
Periode memakai UTC: hari dimulai pukul 00:00 UTC, dan bulan dimulai pada tanggal 1 pukul 00:00 UTC.
Bila project mencapai budget-nya, semua key di project itu dijawab HTTP 429 project_budget_exceeded sampai periode berikutnya dimulai atau budget dinaikkan. Project lain di akun yang sama tetap berjalan.
{"error": {"message": "This project reached its monthly budget. Raise the budget or wait until 2026-11-01T00:00:00Z.", "type": "rate_limit_error", "param": null, "code": "project_budget_exceeded"}}
Request yang sedang berjalan
Budget diperiksa saat request dimulai. Request yang sudah berjalan saat budget tercapai, termasuk stream panjang, diselesaikan dan ditagih penuh. Request berikutnya ditolak. Karena itu pengeluaran bisa sedikit melewati budget.
Budget dan limit key bersamaan
Request harus lolos semua pemeriksaan. Urutannya:
| # | Cek | Hasil bila gagal |
|---|---|---|
| 1 | Project milik key tidak diarsipkan | 403 project_archived |
| 2 | Limit harian atau bulanan key | 429 key_limit_exceeded |
| 3 | Budget harian atau bulanan project | 429 project_budget_exceeded |
| 4 | Saldo yang tersedia untuk model | 402 insufficient_balance |
Budget project tidak menambah uang. Bila saldo habis lebih dulu, request dijawab 402 walaupun budget masih tersisa. Lihat Saldo.
Mengarsipkan project
Mengarsipkan project:
- menghentikan semua key di dalamnya dalam hitungan detik; key itu dijawab HTTP 403
project_archived - mencegah key baru dibuat di project itu
{"error": {"message": "This key belongs to an archived project. Restore the project to use it again.", "type": "permission_error", "param": null, "code": "project_archived"}}
Bila project dipulihkan, key-nya bekerja lagi. Project Default tidak bisa diarsipkan.
Membaca project dari kode
GET /v1/organization/projects mengembalikan semua project beserta budget dan pengeluarannya hari ini dan bulan ini. Endpoint ini butuh management key. Lihat Usage API.