Jika integrasi anda mengalami ralat 429, RateLimitExceeded, atau NoMoreConcurrentTasks semasa memanggil API Meshy, panduan ini menerangkan mengapa had ini wujud dan cara merancang integrasi anda supaya berfungsi dalam had tersebut.
Mengapa had kadar wujud
API Meshy berada di hadapan pengiraan GPU dikongsi yang digunakan untuk menjana model 3D, tekstur dan aset berkaitan. Had kadar dan had keserentakan melindungi infrastruktur dikongsi itu supaya kualiti penjanaan dan masa pemprosesan kekal konsisten untuk setiap pengguna di platform. Setiap akaun, berdasarkan pelan semasanya, mempunyai bilangan maksimum permintaan yang boleh dibuat dalam tetingkap masa tertentu dan bilangan maksimum tugasan penjanaan yang boleh berjalan (dalam baris gilir atau sedang diproses) pada satu-satu masa.
Had permintaan vs. had baris gilir/keserentakan
Terdapat dua had yang berbeza, dan ia gagal secara berbeza:
Had kadar permintaan (429 / RateLimitExceeded): ini mengehadkan bilangan panggilan API (cth. penciptaan tugasan, pengundian status) yang boleh anda buat seminit. Melebihinya bermakna anda memanggil API terlalu kerap, tanpa mengira bilangan tugasan yang benar-benar sedang berjalan.
Had keserentakan / baris gilir (NoMoreConcurrentTasks): ini mengehadkan bilangan tugasan penjanaan yang boleh berada dalam baris gilir atau sedang diproses pada masa yang sama. Melebihinya bermakna anda sudah mempunyai bilangan maksimum tugasan aktif dan perlu menunggu satu tugasan selesai sebelum menghantar tugasan lain.
Semak had permintaan dan keserentakan semasa pelan anda dalam papan pemuka Meshy, kerana had ini boleh berbeza mengikut peringkat pelan.
Strategi backoff untuk ralat 429
Apabila anda menerima respons 429 atau RateLimitExceeded, jangan cuba semula permintaan yang sama serta-merta. Sebaliknya:
Gunakan backoff eksponen: tunggu selang masa yang singkat, kemudian gandakan selang tersebut pada setiap kegagalan berikutnya, sehingga had maksimum yang munasabah.
Tambah jitter (offset rawak yang kecil) pada selang backoff anda supaya berbilang pekerja dalam sistem anda tidak mencuba semula pada saat yang sama.
Patuhi mana-mana pengepala Retry-After atau had kadar yang dikembalikan dalam respons, jika ada, dan jangan meneka masa menunggu.
Hadkan bilangan cubaan semula bagi setiap permintaan supaya kegagalan berterusan tidak berulang tanpa henti.
Merancang dengan had keserentakan
Ralat NoMoreConcurrentTasks bermaksud anda sudah mencapai had maksimum tugas aktif akaun anda. Untuk mengelakkannya dalam pengeluaran:
Kekalkan baris gilir setempat atau penjadual tugas dalam aplikasi anda sendiri yang hanya menghantar tugasan penjanaan baharu selepas tugasan sebelumnya selesai atau bilangan tugas aktif anda menurun di bawah had.
Semak status tugasan secara berkala (atau gunakan webhook, jika disokong dalam aliran kerja anda) untuk mengetahui bila slot tersedia, bukannya menghantar permintaan secara spekulatif.
Kelompokkan dan hadkan kadar tugasan penjanaan pukal daripada menghantar semua permintaan sekali gus — ini melicinkan kadar permintaan dan bilangan tugasan serentak anda.
Bina pemantauan/amaran di pihak anda supaya lonjakan ralat 429/NoMoreConcurrentTasks dapat dilihat sebelum ia menjejaskan pengguna anda.
Mencuba semula penjanaan yang gagal atau tidak memuaskan
API Meshy pada masa ini tidak menyokong "cubaan semula" terbina dalam bagi penjanaan sedia ada untuk pelan individu atau studio — jika sesuatu hasil tidak memenuhi jangkaan anda, anda perlu menghantar permintaan penjanaan baharu, yang akan menggunakan kredit seperti biasa. Apabila saluran automatik anda mengendalikan ralat sementara (seperti 429), pastikan logik cubaan semula anda hanya menghantar semula permintaan asal selepas backoff, dan tidak mencipta tugasan penjanaan pendua setiap kali.
Bila perlu mempertimbangkan peningkatan pelan
Jika anda telah melaksanakan backoff dan baris gilir yang peka terhadap keserentakan tetapi masih kerap mencapai had kadar atau keserentakan, itu biasanya tanda bahawa keperluan daya pemprosesan integrasi anda telah melebihi had pelan semasa anda. Semak papan pemuka anda untuk elaun permintaan dan keserentakan bagi pelan semasa anda, dan pertimbangkan untuk menaik taraf atau menghubungi pasukan jualan Meshy tentang akses API peringkat perusahaan jika anda memerlukan daya pemprosesan yang lebih tinggi secara berterusan.
Soalan Lazim
1. Apakah maksud ralat 429 atau RateLimitExceeded?
Ini bermaksud anda telah melebihi bilangan permintaan API yang dibenarkan dalam tetingkap masa tertentu bagi pelan anda. Perlahankan kadar permintaan anda dan gunakan backoff eksponen sebelum mencuba semula.
2. Apakah maksud NoMoreConcurrentTasks?
Ini bermaksud anda sudah mencapai bilangan maksimum tugasan penjanaan yang berada dalam baris gilir atau sedang diproses untuk akaun anda. Tunggu sehingga tugasan sedia ada selesai, atau kurangkan bilangan tugasan yang anda hantar serentak, sebelum menghantar lebih banyak tugasan.
3. Bagaimana saya boleh mengetahui had kadar dan keserentakan akaun saya?
Semak papan pemuka Meshy anda untuk had yang berkaitan dengan pelan semasa anda, kerana had ini mungkin berbeza antara peringkat pelan.
4. Adakah Meshy menyokong cubaan semula automatik untuk tugasan penjanaan?
Tidak, bukan untuk pelan individu atau studio — penjanaan yang gagal atau tidak memuaskan mesti dihantar semula sebagai permintaan baharu, yang menggunakan kredit seperti biasa. Pelanggan Enterprise patut menghubungi pasukan jualan tentang fungsi cubaan semula.
5. Apakah cara terbaik untuk mengelakkan ralat ini dalam saluran pengeluaran?
Laksanakan baris gilir setempat yang mengehadkan penghantaran supaya kekal di bawah had keserentakan anda, tambah backoff eksponen dengan jitter untuk sebarang respons 429, dan pantau kadar ralat supaya anda boleh bertindak balas sebelum ia menjejaskan pengguna anda.
6. Bila patut saya meningkatkan pelan kerana had kadar?
Jika anda sudah melaksanakan backoff dan baris gilir yang mengambil kira keserentakan tetapi masih kerap mencapai had ini, penggunaan anda berkemungkinan telah melebihi pelan semasa anda — semak papan pemuka anda atau hubungi pasukan jualan tentang pelan dengan daya pemprosesan yang lebih tinggi.