API リファレンス
API 認証とレート制限
GET /models 以外のすべてのリクエストに API キーが必要です。キーはアカウントに属し、そのクレジットを消費します。
API キーを取得Wan 3 API チーム ·
キーの送り方
Authorization ヘッダーに Bearer 方式でキーを入れます。キーは sk- で始まる 43 文字です。
http
Authorization: Bearer sk-...curl "https://api.wan3api.org/v1/balance" \
-H "Authorization: Bearer $API_KEY"キーを秘密に保つ
- API はサーバーから呼び出してください。ブラウザーやモバイルアプリでは誰でもキーを読めます。
- キーは環境変数やシークレット管理サービスに保存し、ソース管理に含めないでください。
- アプリや環境ごとにキーを分ければ、1 つを無効化しても他に影響しません。
- 漏えいが疑われたらすぐに無効化してください。そのキーのリクエストは即座に失敗します。
レート制限
キーごとに毎分 60 リクエストまで。超えると Retry-After ヘッダー付きで 429 rate_limited が返ります。また、1 アカウントで同時に処理できる生成は 3 件までで、超えると 429 too_many_running_tasks になります。
認証エラー
キーがない・形式が違う・無効化済みの場合は 401 invalid_api_key、停止中のアカウントは 403 account_disabled です。