Had kadar

Semak berapa banyak permintaan dan tugas yang dibenarkan oleh pelan anda, dan apa yang perlu dilakukan apabila anda mencapai had.

Had mengikut pelan

Untuk memastikan API kekal pantas dan tersedia untuk semua orang, Meshy mengehadkan setiap akaun dalam dua cara:

Permintaan sesaat: berapa banyak permintaan API yang boleh anda hantar setiap saat.
Tugas serentak: berapa banyak tugas anda yang boleh berada dalam status PENDING atau IN_PROGRESS pada masa yang sama.

Had ini bergantung kepada pelan anda:

Pelan	Permintaan sesaat	Tugas serentak	Keutamaan
Pro	20	10	Lalai
Premium	20	30	Lebih tinggi daripada Pro
Ultra	20	100	Tertinggi
Studio	20	60, atau 20 untuk sesetengah pelan Studio terdahulu	Lebih tinggi daripada Pro
Enterprise	100	100 secara lalai, atau had tersuai	Tertinggi

Keutamaan bukanlah had. Apabila barisan gilir sibuk, Meshy memulakan tugas dengan keutamaan yang lebih tinggi terlebih dahulu.

Apa yang dikira untuk setiap had

Setiap permintaan API dikira ke arah permintaan sesaat, termasuk permintaan yang mendapatkan, menyenaraikan, atau menstrim tugas. Permintaan daripada aplikasi web Meshy tidak dikira.

Had tugas serentak mengira tugas, bukan permintaan. Setiap endpoint yang mencipta tugas akan menyemak had ini sebelum mencipta satu tugas. Sebagai contoh, Teks ke 3D, Imej ke 3D, Berbilang Imej ke 3D, Retekstur, Remesh, Rigging, Animasi, Teks ke Imej, endpoint pencetakan 3D, dan Creative Lab menyemak had ini.

Permintaan yang tidak mencipta tugas tidak dikira. Sebagai contoh, Balance, Penggunaan, dan permintaan yang mendapatkan, menyenaraikan, atau menstrim tugas tidak dikira.

Had siapa yang berkenaan

Jadual berikut menunjukkan had siapa yang dikira untuk kunci API, Playground, dan aplikasi web anda:

Tempat anda bekerja	Akaun peribadi	Pasukan
Kunci API	Had anda	Had pasukan, dikongsi oleh setiap kunci API dalam pasukan tersebut
Playground	Had anda	Had anda sendiri sebagai ahli yang log masuk
Aplikasi web	Tugas serentak anda	Tugas serentak anda sendiri. Tugas yang dimulakan oleh pemilik pasukan turut dikira ke arah had pasukan.

Apabila anda mencapai had

Apabila anda melebihi had, API mengembalikan 429 Too Many Requests. Mesej tersebut memberitahu anda had mana yang telah anda capai:

Terlalu banyak permintaan sesaat: mesejnya ialah Rate limit exceeded. Tunggu bilangan saat yang dinyatakan dalam header Retry-After, kemudian cuba semula.
Terlalu banyak tugas serentak: mesej bermula dengan NoMorePendingTasks. Pada pelan tanpa had dengan tiada baki kredit, mesej bermula dengan NoMoreConcurrentTasks. 429 ini tiada header Retry-After. Tunggu sehingga salah satu tugas anda selesai, kemudian cipta tugas yang seterusnya.

Header had kadar

Respons API menyertakan header berikut untuk membantu anda mengatur rentak permintaan anda:

Header	Penerangan
`X-RateLimit-Limit`	Bilangan permintaan yang dibenarkan sesaat untuk pelan anda.
`X-RateLimit-Remaining`	Baki permintaan untuk saat semasa.
`X-RateLimit-Reset`	Bilangan saat sehingga kuota anda penuh semula.
`Retry-After`	Bilangan saat untuk menunggu sebelum permintaan seterusnya. Dihantar bersama `429` apabila terlalu banyak permintaan sesaat, dan apabila anda mendapatkan tugas yang masih berstatus `PENDING` atau `IN_PROGRESS`.

Apabila Retry-After hadir, tunggu bilangan saat tersebut sebelum menghantar permintaan seterusnya.