レート制限

ご利用のプランで許可されているリクエスト数とタスク数、そして制限に達したときの対処方法を確認できます。

---

プランごとの制限

APIを誰にとっても高速かつ利用可能な状態に保つため、Meshyは各アカウントを2つの方法で制限しています。

• 秒間リクエスト数：1秒あたりに送信できるAPIリクエストの数です。
• 同時実行タスク数：PENDING または IN_PROGRESS の状態で同時に存在できるタスクの数です。

制限はプランによって異なります。

優先度は制限ではありません。キューが混雑している場合、Meshyは優先度の高いタスクから先に開始します。

各制限にカウントされるもの

タスクの取得、一覧表示、ストリーミングを行うリクエストを含め、すべてのAPIリクエストが秒間リクエスト数にカウントされます。Meshyのウェブアプリからのリクエストはカウントされません。

同時実行タスク数の制限は、リクエストではなくタスクをカウントします。タスクを作成するすべてのエンドポイントは、タスクを作成する前にこの制限をチェックします。たとえば、テキストから3D、画像から3D、マルチ画像から3D、リテクスチャ、リメッシュ、Rigging、アニメーション、テキストから画像、3Dプリント関連のエンドポイント、Creative Labがこれをチェックします。

タスクを作成しないリクエストは、この制限にカウントされません。たとえば、Balance、Usage、およびタスクの取得・一覧表示・ストリーミングを行うリクエストはカウントされません。

誰の制限が適用されるか

次の表は、APIキー、Playground、ウェブアプリがそれぞれ誰の制限にカウントされるかを示しています。

---

制限に達した場合

制限を超えると、APIは 429 Too Many Requests を返します。メッセージには、どの制限に達したかが示されます。

• 秒間リクエスト数の超過：メッセージは Rate limit exceeded です。Retry-After ヘッダーに記載された秒数だけ待ってから再試行してください。
• 同時実行タスク数の超過：メッセージは NoMorePendingTasks で始まります。クレジットが残っていない無制限プランの場合は NoMoreConcurrentTasks で始まります。この 429 には Retry-After ヘッダーはありません。いずれかのタスクが完了するのを待ってから、次のタスクを作成してください。

---

レート制限ヘッダー

APIレスポンスには、リクエストのペースを調整できるよう、次のヘッダーが含まれています。

Retry-After が含まれている場合は、その秒数だけ待ってから次のリクエストを送信してください。