API キー
API キーは、VocalLab API へのリクエストを認証します。API アクセスには Pro 以上のプランが必要です。
キーを作成する
- Developer settings を開きます。
- 名前（例: 「Production」や「Zapier」）を入力し、Create key をクリックします。
- キーをすぐにコピーしてください。
vl_live_で始まり、表示されるのは一度きりです。当社はハッシュ化したものだけを保存しており、再度表示することはできません。
キーを使う
すべてのリクエストで Bearer トークンとして送信します:
curl https://api.vocallab.ai/api/v1/ping \
-H "Authorization: Bearer vl_live_..."
キーを無効化する
Developer settings で、対象のキーの横にある Revoke をクリックします。すぐに使えなくなります。キーが漏洩した場合は、無効化して新しいキーを作成してください。
推奨される運用
- キーは環境変数またはシークレットマネージャーに保存してください。コードや git には絶対に含めないでください。
- アプリや連携ごとに別々のキーを使うと、他に影響を与えずに 1 つだけ無効化できます。
- プランが Pro 未満になると、再び Pro 以上に戻るまでキーは使えなくなります（削除はされません）。
制限
- 1 アカウントあたり最大 5 個のアクティブなキー。
- キーごとに 1 分あたり 60 リクエスト。