Menu docs

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:

#CekHasil bila gagal
1Project milik key tidak diarsipkan403 project_archived
2Limit harian atau bulanan key429 key_limit_exceeded
3Budget harian atau bulanan project429 project_budget_exceeded
4Saldo yang tersedia untuk model402 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.