サードパーティ製のアプリケーションまたはユーザーに一時的なアクセス権限を提供する必要がある場合、または機密データへのアクセスや削除などのリスクの高い操作を厳密に制御する場合、一時的な認証トークンを取得できます。一時的な認証トークンは 60 秒間有効です。これにより、長期 API キーが直接公開されるのを防ぎ、漏洩のリスクを軽減します。
前提条件
Alibaba Cloud Model Studio をアクティブ化し、API キーを取得している必要があります。
API キーの漏洩のリスクを軽減するために、API キーを環境変数として構成することをお勧めします。
リクエストの送信
リクエスト例
現在、HTTP リクエストのみがサポートされています。
curl -X POST https://dashscope-intl.aliyuncs.com/api/v1/tokens \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" サンプルレスポンス
成功レスポンスの例
{
"token":"st-****",
"expires_at":1744080369
}エラーレスポンスの例
{
"code":"InvalidApiKey",
"message":"Invalid API-key provided.",
"request_id":"902fee3b-f7f0-9a8c-96a1-6b4ea25af114"
}レスポンスパラメーター
パラメーター | オプション | タイプ | 説明 | 例 |
token | はい | String | API キーから生成された短期トークン。 60 秒間有効です。 | st-**** |
expires_at | はい | Long | Unix タイムスタンプ（秒）での有効期限。 | 1738916382 |
code | はい | String | エラーコード。 | InvalidApiKey: 無効な API キーのエラーコード Throttling.RateQuota: レート制限のエラーコード SystemError: 内部エラー |
message | はい | String | エラーメッセージ。 | Invalid API-key provided. |
request_id | はい | String | リクエスト ID。 | 902fee3b-f7f0-9a8c-96a1-6b4ea25af114 |
エラーコード
呼び出しが失敗し、エラーメッセージが返された場合は、トラブルシューティングについてエラーメッセージをご参照ください。