Fitur platform
Akun perusahaan
Cara kerja kunci API, anggaran anggota, kesalahan, dan log saat sebuah tim berbagi satu saldo perusahaan.
Akun perusahaan memungkinkan seluruh tim membelanjakan dari satu saldo. Saldo akun pemilik menjadi saldo perusahaan, setiap anggota memanggil API dengan kuncinya sendiri, dan setiap tagihan diambil dari saldo bersama tersebut. Endpoint, isi permintaan, dan penyiapan klien sama seperti akun pribadi; halaman ini hanya membahas apa yang berubah ketika pemanggil tergabung dalam sebuah perusahaan.
Anggota mengirim permintaan
acme-…Dengan kuncinya sendiri, yang diawali prefiks perusahaan.
Pemeriksaan anggaran
Perkiraan biaya harus muat dalam sisa anggaran anggota.
Ditagihkan ke perusahaan
Dengan harga, grup, dan langganan akun pemilik.
Dicatat atas nama anggota
Pemilik dan admin dapat merincinya per anggota, model, kunci, dan tanggal.
| Peran | Akun | Yang dapat dilakukan |
|---|---|---|
| Pemilik | Akun yang mengajukan | Saldonya adalah saldo perusahaan. Mengelola semua orang, mengisi ulang saldo, dan melihat penggunaan seluruh perusahaan. Tidak dapat dinonaktifkan. |
| Admin | Dibuat dari undangan | Memanggil API dalam batas anggaran, mengundang dan mengelola anggota, mengisi ulang saldo, dan melihat penggunaan seluruh perusahaan. |
| Anggota | Dibuat dari undangan | Menggunakan API, workbench gambar dan video, serta Castaly dalam batas anggaran. Tidak dapat mengisi ulang saldo. |
Admin dan anggota adalah akun baru yang dibuat dari undangan email. Alamat email yang diundang belum boleh terdaftar, sehingga akun pribadi yang sudah ada tidak dapat bergabung ke perusahaan. Akun-akun ini tidak ikut serta dalam program hadiah platform.
Pemilik dan admin dapat menonaktifkan akun kapan saja, dan sesi serta kuncinya langsung berhenti berfungsi. Akun hanya dinonaktifkan, tidak pernah dihapus, sehingga riwayat penggunaannya tetap tersimpan.
Kunci API
Section titled “Kunci API”Kunci perusahaan diawali prefiks kunci perusahaan, misalnya acme- diikuti 48 huruf dan angka. Anda memilih prefiks saat mengajukan; prefiks ditetapkan saat disetujui dan tidak dapat diubah setelahnya. Prefiks terdiri dari 2 sampai 16 huruf kecil dan angka serta diawali huruf.
Kunci yang sama juga berfungsi dengan sk- menggantikan prefiks. Gunakan penulisan itu untuk klien yang hanya menerima kunci berawalan sk-: kedua penulisan adalah kunci yang sama, dengan izin dan penagihan yang sama.
Authorization: Bearer acme-<48 characters>Authorization: Bearer sk-<48 characters>Kunci yang dikirim dengan prefiks yang bukan milik perusahaannya sendiri ditolak sebagai kunci tidak valid dengan 401.
Kunci yang dibuat pemilik sebelum pengajuan disetujui juga ditampilkan dengan prefiks perusahaan. Penulisan sk- miliknya tetap berfungsi, jadi integrasi yang sudah ada tidak perlu diubah.
Admin dan anggota hanya membuat dan melihat kunci mereka sendiri di konsol. Pemilik dan admin dapat mengelola semua kunci perusahaan dari konsol perusahaan, difilter per anggota.
Anggaran anggota
Section titled “Anggaran anggota”Setiap admin dan anggota memiliki anggaran. Tidak ada uang yang dipindahkan kepada mereka; anggaran adalah jumlah maksimum yang boleh mereka belanjakan dari saldo perusahaan.
| Mode | Perilaku |
|---|---|
| Tanpa batas | Hanya dibatasi oleh saldo perusahaan. |
| Sekali | Jatah tetap yang tidak pernah diatur ulang dengan sendirinya. |
| Bulanan | Mulai lagi dari nol pada pukul 00:00 UTC setiap tanggal 1. |
Mengubah batasnya saja akan mempertahankan jumlah yang sudah terpakai. Beralih ke mode lain akan mulai menghitung dari nol.
Sebelum permintaan dijalankan, gateway mencadangkan perkiraan biayanya dari sisa anggaran anggota dan menolak permintaan jika tidak cukup. Permintaan kemudian diselesaikan sesuai biaya sebenarnya. Penyelesaian tidak pernah menolak, sehingga permintaan terakhir bisa membuat anggota sedikit melewati batas; permintaan berikutnya ditolak. Jika permintaan gagal atau dananya dikembalikan, jumlahnya juga kembali ke anggaran anggota.
Anggota menerima email saat telah memakai 80% anggarannya dan sekali lagi saat anggaran habis.
Penagihan, grup, dan batas laju
Section titled “Penagihan, grup, dan batas laju”Bagi gateway, permintaan anggota adalah permintaan dari akun pemilik. Semua hal selain anggaran mengikuti pemilik:
- Tagihan diambil dari saldo perusahaan dengan cara yang sama seperti untuk pemilik, termasuk langganan pemilik.
- Harga, grup, dan model yang dapat dipanggil sebuah kunci mengikuti akun pemilik.
- Batas laju dihitung untuk seluruh perusahaan. Pemilik dan semua anggota berbagi satu jatah, sehingga
429bisa disebabkan oleh lalu lintas orang lain.
Saat saldo perusahaan habis, permintaan dari semua orang di perusahaan gagal dengan 403 dan insufficient_user_quota, sama seperti akun pribadi. Pemilik dan admin dapat mengisi ulang dari konsol perusahaan; anggota tidak bisa. Jika peringatan saldo diatur, pemilik dan admin menerima email saat saldo turun di bawahnya.
Kesalahan
Section titled “Kesalahan”| Situasi | Status | Cara mengenalinya |
|---|---|---|
| Kunci membawa prefiks perusahaan lain | 401 |
Ditolak sebagai kunci tidak valid |
| Anggaran anggota habis | 403 |
code bernilai enterprise_member_budget_exhausted |
| Anggota dinonaktifkan, atau perusahaan ditangguhkan | 403 |
message menyatakan akun dinonaktifkan |
| Saldo perusahaan habis | 403 |
code bernilai insufficient_user_quota |
| Perusahaan secara keseluruhan mencapai batas laju | 429 |
Sama seperti akun pribadi |
Mencoba ulang tidak menyelesaikan kasus 401 dan 403. Kesalahan anggaran hilang saat admin menaikkan batas atau, untuk anggaran bulanan, saat bulan berikutnya dimulai; kesalahan saldo hilang setelah isi ulang.
Tugas asinkron
Section titled “Tugas asinkron”Tugas yang dikirim dengan kunci seorang anggota hanya dapat dikueri dengan kunci milik anggota tersebut. Mengkuerinya dengan kunci anggota lain memberikan hasil yang sama seperti tugas yang tidak ada. Kunci milik pemilik dapat mengkueri tugas yang dikirim oleh siapa pun di perusahaan.
Penggunaan dan log
Section titled “Penggunaan dan log”- Setiap log permintaan mencatat anggota mana yang mengirim permintaan tersebut.
- Di konsol mereka sendiri, admin dan anggota hanya melihat permintaan mereka sendiri.
- Halaman log pemilik menampilkan permintaan dari seluruh perusahaan, dengan kolom Anggota tambahan.
- Pemilik dan admin dapat merinci pengeluaran per anggota, model, kunci, dan tanggal di konsol perusahaan, serta membuka setiap permintaan dari anggota mana pun.
- Seberapa jauh ke belakang data tersedia mengikuti retensi log akun pemilik, lihat Retensi data. Jika pemilik memperpendeknya, laporan perusahaan juga ikut memendek.
Mendapatkan akun perusahaan
Section titled “Mendapatkan akun perusahaan”Ajukan dari konsol Modelflare dengan nama perusahaan, prefiks kunci yang Anda inginkan, dan email kontak. Setelah pengajuan disetujui, akun Anda menjadi pemilik, saldonya menjadi saldo perusahaan, dan Anda mengundang tim dari konsol perusahaan. Halaman Enterprise menjelaskan paket lengkapnya.