Batas laju

Periksa berapa banyak permintaan dan tugas yang diizinkan oleh paket Anda, serta apa yang harus dilakukan saat Anda mencapai suatu batas.

Batas berdasarkan paket

Untuk menjaga API tetap cepat dan tersedia bagi semua orang, Meshy membatasi setiap akun dengan dua cara:

Permintaan per detik: berapa banyak permintaan API yang dapat Anda kirim setiap detik.
Tugas bersamaan: berapa banyak tugas Anda yang dapat berstatus PENDING atau IN_PROGRESS pada saat yang sama.

Batas-batas ini bergantung pada paket Anda:

Paket	Permintaan per detik	Tugas bersamaan	Prioritas
Pro	20	10	Default
Premium	20	30	Lebih tinggi dari Pro
Ultra	20	100	Tertinggi
Studio	20	60, atau 20 pada beberapa paket Studio sebelumnya	Lebih tinggi dari Pro
Enterprise	100	100 secara default, atau batas khusus	Tertinggi

Prioritas bukanlah sebuah batas. Saat antrean sedang sibuk, Meshy memulai tugas dengan prioritas lebih tinggi terlebih dahulu.

Apa yang dihitung dalam setiap batas

Setiap permintaan API dihitung dalam permintaan per detik, termasuk permintaan yang mengambil, mencantumkan, atau melakukan streaming tugas. Permintaan dari aplikasi web Meshy tidak dihitung.

Batas tugas bersamaan menghitung tugas, bukan permintaan. Setiap endpoint yang membuat tugas memeriksa batas ini sebelum membuat tugas tersebut. Misalnya, Teks ke 3D, Gambar ke 3D, Multi-Gambar ke 3D, Retexture, Remesh, Rigging, Animasi, Teks ke Gambar, endpoint pencetakan 3D, dan Creative Lab memeriksanya.

Permintaan yang tidak membuat tugas tidak dihitung dalam batas ini. Misalnya, Balance, Penggunaan, serta permintaan yang mengambil, mencantumkan, atau melakukan streaming tugas tidak dihitung.

Batas siapa yang berlaku

Tabel berikut menunjukkan batas siapa yang dihitung untuk kunci API, Playground, dan aplikasi web Anda:

Tempat Anda bekerja	Akun pribadi	Tim
Kunci API	Batas Anda	Batas tim, dibagikan oleh setiap kunci API dalam tim
Playground	Batas Anda	Batas Anda sendiri sebagai anggota yang sedang masuk
Aplikasi web	Tugas bersamaan Anda	Tugas bersamaan Anda sendiri. Tugas yang dimulai oleh pemilik tim juga dihitung dalam batas tim.

Saat Anda mencapai batas

Saat Anda melampaui suatu batas, API mengembalikan 429 Too Many Requests. Pesan tersebut memberi tahu Anda batas mana yang telah tercapai:

Terlalu banyak permintaan per detik: pesannya adalah Rate limit exceeded. Tunggu selama jumlah detik yang tertera pada header Retry-After, lalu coba lagi.
Terlalu banyak tugas bersamaan: pesan dimulai dengan NoMorePendingTasks. Pada paket tak terbatas yang kreditnya telah habis, pesan dimulai dengan NoMoreConcurrentTasks. 429 ini tidak memiliki header Retry-After. Tunggu hingga salah satu tugas Anda selesai, lalu buat tugas berikutnya.

Header batas laju

Respons API menyertakan header berikut untuk membantu Anda mengatur kecepatan permintaan:

Header	Deskripsi
`X-RateLimit-Limit`	Jumlah permintaan yang diizinkan per detik pada paket Anda.
`X-RateLimit-Remaining`	Sisa permintaan pada detik saat ini.
`X-RateLimit-Reset`	Jumlah detik hingga anggaran Anda terisi penuh kembali.
`Retry-After`	Jumlah detik yang harus ditunggu sebelum permintaan berikutnya. Dikirim bersama `429` untuk terlalu banyak permintaan per detik, dan saat Anda mengambil tugas yang masih berstatus `PENDING` atau `IN_PROGRESS`.

Jika Retry-After muncul, tunggu selama jumlah detik tersebut sebelum mengirim permintaan berikutnya.