開始前に

• IBM Cloud の従量課金型またはサブスクリプション型のアカウントを作成します。 体験版アカウントご利用いただけません。 詳細情報やアカウントのアップグレードについては、 アカウントの種類 をご覧ください。

• Red Hat AI Inference プロジェクト を作成します。

• Red Hat AI Inference サービスにおいて、「Writer」ロール以上の権限を持っていることを確認してください。 詳細については、「 IAM アクセスの管理 」を参照してください。

ベアラー・トークンを使用した認証

ベアラー・トークンは、プロジェクトの推論機能への安全なアクセスを保証するものであり、 IBM Cloud のAPIキーから生成されます。 ベアラー・トークンは所定の期間が経過すると失効するため、定期的に更新する必要があります。

以下の例は、ベアラー・トークンを取得する方法を示しています。

curl -X POST "https://iam.cloud.ibm.com/identity/token" --header "Content-Type: application/x-www-form-urlencoded" --header "Accept: application/json" --data-urlencode "grant_type=urn:ibm:params:oauth:grant-type:apikey" --data-urlencode "apikey=$<IBM_CLOUD_API_KEY>"

ベアラー・トークンは、レスポンスに含まれる「 access_token 」です。 これらのトークンには有効期限があり、定期的に更新する必要があります。

{"access_token":"xxxxx","refresh_token":"not_supported","token_type":"Bearer","expires_in":3600,"expiration":1770058324,"scope":"ibm openid"}

APIキーを使用した認証

サービス ID API キーまたはユーザー API キーのいずれかを使用して、API キーによる認証を行うことができます。

アクセス権限の管理および委任には、 サービスID の使用が推奨されます。 サービス ID を作成したら、リクエストを認証するための サービス ID API キーを作成してください。 プロジェクト内でサービス ID および API キーを作成する方法の詳細については、 「 Red Hat AI Inference のはじめに」を 参照してください。

IAMでサービスIDを作成する際は、チャットの自動補完機能を作成するために、「Writer」サービスアクセスロールを割り当ててください。 モデルの情報を閲覧したり、チャットの完了内容を読んだりするだけでよい場合は、「Reader」サービスアクセスロールを割り当ててください。 APIへのアクセスには、プラットフォームアクセス権限は必要ありません。

あるいは、個人のユーザーAPIキーを使用して認証を行うこともできます。 詳しくは、ユーザーの API キーの管理を参照してください。