Had Kadar

Had kadar ialah sekatan yang dikenakan oleh API kami ke atas bilangan kali pengguna atau klien boleh mengakses perkhidmatan kami dalam tempoh masa tertentu.

Mengapa Had

Kami telah menetapkan had kadar pada API kami untuk membantu mencipta pengalaman terbaik untuk semua orang. Inilah sebabnya ia penting:

Untuk memastikan perkhidmatan kami selamat dan terjaga! Anggap had kadar sebagai penjaga pintu yang mesra - mereka memastikan tiada siapa boleh membebankan API kami dengan terlalu banyak permintaan serentak. Ini membantu melindungi perkhidmatan kami daripada kemungkinan penyalahgunaan dan memastikan semuanya berjalan lancar.
Untuk memastikan semua orang mendapat bahagian yang adil. Sama seperti berkongsi mainan di taman permainan, kami mahu memastikan semua pengguna kami mempunyai akses yang sama kepada API. Dengan mengehadkan secara berhemah bilangan permintaan yang boleh dibuat oleh setiap pengguna, kami memastikan tiada siapa perlu menunggu terlalu lama untuk giliran mereka.
Untuk mengekalkan prestasi yang pantas dan boleh dipercayai. Dengan mengurus aliran keseluruhan permintaan, kami boleh mengekalkan masa respons yang pantas dan perkhidmatan yang stabil untuk semua pengguna hebat kami. Ia seperti memastikan lebuh raya tidak menjadi terlalu sesak - trafik mengalir dengan lebih baik apabila kami mencegah kesesakan!

Cara Had Berfungsi

Had kadar diukur dalam 2 cara:

permintaan sesaat: Ini ialah bilangan permintaan rangkaian yang boleh anda buat sesaat.
tugas beratur: Ini ialah bilangan tugas penjanaan serentak yang boleh anda jalankan dalam baris gilir pada bila-bila masa tertentu.

Tugas beratur termasuk endpoint Teks ke 3D, Imej ke 3D, Teks ke Tekstur, dan Remesh. Endpoint lain seperti Upload dan Baki tidak termasuk dalam had ini.

Had dikenakan berdasarkan setiap akaun. Ini bermakna had dikongsi merentas semua API key anda.

Selain had kadar, keutamaan pemprosesan tugas juga akan mempengaruhi kelajuan tugas anda.

Setiap peringkat pengguna mempunyai had kadar dan tahap keutamaan khusus yang direka untuk memenuhi keperluan mereka. Berikut ialah had semasa mengikut peringkat:

Peringkat Pengguna	permintaan sesaat	tugas beratur	Tahap Keutamaan
Pro	20	10	Lalai
Premium	20	30	Lebih tinggi daripada Pro
Ultra	20	100	Tertinggi
Studio	20	20	Lebih tinggi daripada Pro
Enterprise	100	Lalai kepada 50, boleh disesuaikan	Tertinggi

Jika anda melebihi had ini, anda akan menerima respons 429 Too Many Requests daripada API kami. Terdapat dua jenis pelanggaran yang boleh mencetuskan perkara ini, setiap satu dengan respons yang berbeza:

Pelanggaran Permintaan: Ini berlaku apabila anda membuat terlalu banyak permintaan sesaat. Anda akan menerima respons 429 Too Many Requests dengan mesej RateLimitExceeded.
Pelanggaran Baris Gilir: Ini berlaku apabila anda mempunyai terlalu banyak tugas penjanaan serentak yang sedang berjalan. Anda akan menerima respons 429 Too Many Requests dengan mesej NoMoreConcurrentTasks.