認証
キーを保護し適切なヘッダーを使用。
API キーは環境変数に保存し、ソース、URL、画像、ログに含めないでください。信頼できるサーバーのみに送信し、漏洩時は交換してください。
例に必要なライブラリと対応ランタイムを用意し、環境変数 STALI_API_KEY を設定してください。例のモデルを、利用可能でプロトコルに合うものに置き換えてください。
認証
両方の認証ヘッダー形式を受け付けます。どちらを使用しても構いません：
認証方式は一つだけ送信してください。両方のヘッダーがある場合は x-api-key が優先されます。Bearer が正しくても、x-api-key が誤っていると 401 になる場合があります。
x-api-key: sk-apv-...
Authorization: Bearer sk-apv-...新しいキーは認証用にハッシュとして保存され、AES-256-GCMで暗号化されるため、所有者はコンソールで表示または再コピーできます。この機能以前に作成された古いキーは復元できません。アカウントごとに同時にアクティブにできるキーは最大10個です。
デバイスごと、またはアプリケーションごとに個別のキーを作成することをお勧めします。キーが漏洩した場合でも、該当するキーのみを無効化すればよく、「使用状況」ページでキーごとのコストを個別に確認できます。Gitにプッシュするソースコードにキーを直接貼り付けないでください。環境変数や、リポジトリ外の設定ファイルに配置してください。
例はソース確認とローカル検証の対象であり、全アプリバージョンの実機検証を意味しません。実運用前に設定、小さなリクエスト、使用量を確認してください。