Batas
Batas laju permintaan Direct API, header yang melaporkannya, serta batas ukuran dan jumlahnya.
Laju permintaan
| Kuota | Batas | Dihitung per |
|---|---|---|
| Pembacaan generasi | 30 per menit per generasi, total 1.200 per menit | kunci API |
Panggilan alat gratis (daftar, katalog, plan_media, dan setiap URL media yang diimpor oleh panggilan) | 1.000 per jam | kunci API |
Pengelolaan webhook (/webhooks dan path di bawahnya) | 60 per menit | kunci API |
/usage, /me | 60 per menit | kunci API |
Permintaan dengan kunci API yang tidak berfungsi (401) | 60 per 10 menit; setelah itu, permintaan dari alamat tersebut dijawab 429 (dengan Retry-After) sampai jendela waktunya habis, kecuali dengan kunci yang berhasil diautentikasi dalam 10 menit terakhir | alamat IP klien (alamat IPv6 dihitung per /64) |
| Panggilan alat berbayar | tanpa batas laju permintaan |
- Panggilan berbayar dibatasi oleh biaya, bukan oleh laju: batas kredit kunci Anda dan saldo organisasi Anda.
- Saat beban tinggi, generasi menunggu di
queuedhingga kapasitas model tersedia alih-alih ditolak. Memulai lebih banyak pekerjaan daripada yang dapat dijalankan model sekaligus membuat generasi berikutnya lebih lama selesai, tidak pernah gagal. - Panggilan berbayar yang ternyata tidak dikenai biaya, seperti
video_remove_audiopada video tanpa suara, dihitung terhadap kuota panggilan gratis.
Respons batas laju
Setiap endpoint yang dibatasi lajunya mengembalikan header berikut:
X-RateLimit-Limit: 1200
X-RateLimit-Remaining: 1187
X-RateLimit-Reset: 1792919760Permintaan yang ditolak dijawab dengan 429 beserta Retry-After: <seconds> dan body ini:
{
"description": "This API key read generations more than 1200 times a minute. Poll less often, or pass ?wait= to be answered when a status changes.",
"code": "rate_limited",
"data": { "retry_after_seconds": 14 }
}Tunggu selama Retry-After detik sebelum mencoba lagi. 429 tidak pernah menagih apa pun.
Batas ukuran dan jumlah
| Batas | Nilai |
|---|---|
| Body permintaan | 1 MB |
variations per permulaan gambar | 1 hingga 4 |
| Id per pembacaan batch | 10 |
wait | 45 dtk |
metadata | 20 kunci; kunci hingga 40 karakter, nilai hingga 500 |
Idempotency-Key | hingga 200 karakter, diingat selama 24 jam |
| Kunci API aktif per organisasi | 10 |
| Endpoint webhook per organisasi | 10 |
| Masa berlaku link aset | tidak kedaluwarsa |
| Input per model (panjang prompt, gambar referensi, durasi, ukuran file) | seperti yang tercantum di Model dan input_schema setiap alat |
Jika Anda mengalami kendala atau memiliki pertanyaan, jangan ragu untuk menghubungi kami. Kami dengan senang hati akan membantu. Tulis kepada kami di support@morphic.com.