API キー

Tokener.ai API キーは https://api.tokener.ai/v1 へのリクエストを認証します。キーは組織に属し、組織のプリペイドクレジットから消費されます。

組織内の権限

Owner と admin は組織内でユーザーが作成したすべてのキーを表示・管理できます。 Member が表示・管理できるのは自分で作成したキーだけです。すべてのロールが自分のキーを作成できます。

キーを作成

コンソールで API keys を開きます。
アプリまたは環境向けに名前を付けます（例: prod-web）。
キーを作成し、シークレットをコピーします。

作成結果は最大 30 秒待ちます。タイムアウトや接続の問題により、キーが作成済みでも結果が不明になることがあります。そのダイアログでは再送信できず、自動で再試行することもありません。元のダイアログを開いたままにすると、最終結果を受け取れます。閉じる場合は、新しいキーを作成する前にキー一覧を確認してください。遅れて届いた応答がシークレットを表示したり、新しく開いたダイアログを変更したりすることはありません。

Tokener はキーを暗号化して保存するため、失効するまでは再表示できます。失効すると、保存されたキーは完全に削除されます。

キーを使う

Bearer トークンとして送信します。

HTTP

Authorization: Bearer sk-...

無効化または失効

無効化すると記録を残したままトラフィックを止められます。漏洩の可能性がある場合は失効してください。無効化・失効済みのキーはゲートウェイで拒否されます。

ベストプラクティス

アプリまたは環境ごとに 1 キー
定期ローテーションと人員変更後のローテーション
git にコミットせず、ブラウザにも出荷しない