制限
Direct API のリクエストレート制限、それを示すヘッダー、サイズと件数の制限について説明します。
リクエストレート
| バケット | 上限 | カウント単位 |
|---|---|---|
| 生成の読み取り | 生成 1 件につき毎分 30 回、合計で毎分 1,200 回 | API キー |
無料のツール呼び出し（一覧、カタログ、plan_media、呼び出しが取り込む各メディア URL） | 毎時 1,000 回 | API キー |
Webhook の管理（/webhooks とその配下のパス） | 毎分 60 回 | API キー |
/usage、/me | 毎分 60 回 | API キー |
API キーが機能しないリクエスト（401） | 10 分あたり 60 回。超えると、そのアドレスからのリクエストはウィンドウが空くまで 429（Retry-After 付き）を返します。ただし、直近 10 分以内に認証に成功したキーは除きます | クライアントの IP アドレス（IPv6 アドレスは /64 単位） |
| 有料のツール呼び出し | リクエストレートの制限なし |
- 有料の呼び出しはレートではなく金額で制限されます。キーの クレジット上限 と組織の残高です。
- 高負荷時、生成は拒否されるのではなく、モデルの処理枠が空くまで
queuedで待機します。モデルが同時に処理できる以上の作業を開始すると、後の生成に時間がかかるようになりますが、失敗することはありません。 - 結果として無料になった有料の呼び出し（音声のない動画に対する
video_remove_audioなど）は、無料の呼び出しのバケットにカウントされます。
レート制限のレスポンス
レート制限のあるエンドポイントは、すべて次のヘッダーを返します。
X-RateLimit-Limit: 1200
X-RateLimit-Remaining: 1187
X-RateLimit-Reset: 1792919760拒否されたリクエストは、Retry-After: <seconds> と次のボディを付けて 429 を返します。
{
"description": "This API key read generations more than 1200 times a minute. Poll less often, or pass ?wait= to be answered when a status changes.",
"code": "rate_limited",
"data": { "retry_after_seconds": 14 }
}再試行する前に Retry-After の秒数だけ待ってください。429 で課金されることはありません。
サイズと件数の制限
| 制限 | 値 |
|---|---|
| リクエストボディ | 1 MB |
画像の生成開始 1 回あたりの variations | 1 から 4 |
| 一括読み取り 1 回あたりの ID 数 | 10 |
wait | 45 秒 |
metadata | 20 キー。キーは最大 40 文字、値は最大 500 文字 |
Idempotency-Key | 最大 200 文字、24 時間保持 |
| 組織あたりの有効な API キー | 10 |
| 組織あたりの Webhook エンドポイント | 10 |
| アセットリンクの有効期間 | 無期限 |
| モデルごとの入力（プロンプトの長さ、参照画像、尺、ファイルサイズ） | モデル と各ツールの input_schema に記載のとおり |
何かお困りのことやご質問がありましたら、お気軽にご連絡ください。喜んでお手伝いします。こちらまでご連絡ください support@morphic.com.