認証

EmpirioLabs APIキーを使ってベアラートークンですべてのリクエストを安全に保護します

すべてのEmpirioLabsのAPIリクエストには、Authorizationヘッダーにベアラートークンを含める必要があります。

APIキー形式

APIキーはsk-empiriolabs-プレフィックスを使用します。ダッシュボードからアカウントごとに最大50のAPIキーを生成できます。

1Authorization: Bearer sk-empiriolabs-...

ヘッダー形式

すべてのリクエストにヘッダーを含めること:

$curl "https://api.empiriolabs.ai/v1/models" \
> -H "Authorization: Bearer sk-empiriolabs-your_key_here"

料金制限

各アカウントはデフォルトのレート制限から始まります:

制限デフォルト
1分あたりのリクエスト数50回転
トークン数/分2,000,000 TPM

より高い限度額が必要な場合は、support@empiriolabs.aiまでメールしてください。詳細はLimits and API Keysを参照してください。

推奨される実践

  • 本番、ステージング、開発用の別々のAPIキーを生成する
  • 鍵は定期的に、そして曝露が疑われた直後にローテーションしてください
  • 鍵はシークレットマネージャやデプロイプラットフォームに保存し、クライアントサイドのコードや公開リポジトリ、ログには絶対に保存しません
  • 未使用のキーは速やかにダッシュボードから削除してください

資格を試しましょう

鍵が動作しているか素早く確認する方法:

$curl "https://api.empiriolabs.ai/v1/models" \
> -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

モデルカタログの200応答で、あなたのキーが有効でアカウントが正しく設定されていることが確認されます。

一般的な認証応答

ステータスコード意味どうすればいいか
401 Unauthorizedトークンが欠損している、形が変わっている、または見つからないAuthorization: Bearer sk-empiriolabs-...ヘッダー形式とキーがダッシュボードに存在するかを確認してください
402 Payment Required口座のクレジットが不足していますダッシュボードの請求ページでクレジットを補充してください
429 Too Many Requests速度制限を超えました(50回転デフォルト)指数的バックオフで再挑戦し、リクエストボリュームを確認してください