ドキュメント
エラーと回数制限
エラーのときは {"success": false, "error": {"code": "...", "message": "..."}} の形で返ります。
エラーの一覧
| HTTP | code | 意味 | 回数 |
|---|---|---|---|
| 400 | missing_file | 画像が付いていない | 数えない |
| 401 | missing_api_key / invalid_api_key | キーが無い・正しくない・再発行で無効になった | 数えない |
| 403 | account_disabled | アカウントが停止されている | 数えない |
| 413 | file_too_large | 画像が10MBを超えている | 数えない |
| 415 | unsupported_image | JPEG・PNG 以外 | 数えない |
| 422 | no_face / invalid_image | 顔が見つからない・画像を読み取れない | 数える |
| 429 | rate_limited / quota_exceeded | 1分の上限・1日の上限を超えた（Retry-After 秒後に再試行） | 数えない |
| 502 / 503 | upstream_unavailable | 一時的に解析できない（Retry-After 秒後に再試行） | 数えない |
| 503 | busy | 混み合っている（数秒おいて再試行） | 数えない |
回数制限
- 1日
- 無料 20 回 ／ 有料 1,000 回（日本時間の0時に戻ります）
- 1分
- どのプランも 10 回まで
残り回数の確かめ方
| 応答ヘッダ | 内容 |
|---|---|
X-RateLimit-Limit | 今日の上限回数 |
X-RateLimit-Remaining | 今日の残り回数 |
X-RateLimit-Reset | 回数が戻る時刻（UNIX時刻） |
Retry-After | 429・503 のとき、再試行までの秒数 |
数え方
- 画像を解析した呼び出しは、顔が見つからなかった場合も1回と数えます。
- キーの誤り・上限超過・当社側の障害など、解析しなかった呼び出しは数えません。
© 合同会社IKACHI