> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toapis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 非同期タスクのレート制限

> ToAPIs の送信・照会レート制限

> [!NOTE]
>
> **中国本土のユーザー向け：** 中国本土のユーザーは `https://toapis.cn` を API エンドポイント（Base URL）としてご利用ください。本ドキュメント内の例では `https://toapis.com` を `https://toapis.cn` に置き換えてください。

ToAPIs は非同期送信と状態照会に独立した token bucket を使用し、同期モデルのリクエスト枠を消費しません。

| グループ | 送信 RPM / RPS / 10秒バースト | 照会 RPM / RPS / 10秒バースト |
| - | - | - |
| `default` | 300 / 5 / 50 | 3,000 / 50 / 500 |
| `vip` | 1,000 / 16.7 / 167 | 10,000 / 166.7 / 1,667 |
| `svip` | 2,000 / 33.3 / 334 | 30,000 / 500 / 5,000 |

ユーザー ID 単位で、同一ユーザーの Token は共有します。送信と照会は独立し、業務エラーは消費、`429` は消費しません。バッチ照会は1リクエストとして数え、最大100件です。

```text theme={null}
Retry-After
X-RateLimit-Limit
X-RateLimit-Remaining
X-RateLimit-Reset
X-RateLimit-Category: async_submit | async_query
```

```json 429 theme={null}
{"error":{"code":"rate_limit_exceeded","message":"Async task request rate exceeded"}}
```

```json 503 theme={null}
{"error":{"code":"rate_limit_unavailable","message":"The async task submit limiter is temporarily unavailable"}}
```

送信リミッター障害は `503`、照会はフェイルオープンです。[Webhook](https://docs.toapis.com/docs/ja/api-reference/webhooks/task-webhooks.md) を主経路にし、ポーリングは5～10秒以上、ランダムジッター付きにしてください。`429/503` では `Retry-After` を優先し、なければ指数バックオフを使用します。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.