REST API 資格情報

ほとんどの API メソッドでは、リクエストに IBM Cloud Identity and Access Management (IAM) ベアラー・トークンをアクセストークンとして含める必要があります。 IAM ベアラー・トークンを生成するには、IBM Cloud API キーを使用します。

REST API 要求を認証するには、以下のステップを実行します。

1. IBM Cloud API キーは、さまざまな方法で作成できます。

   詳細については、 IBM Cloud API キーを参照してください。

2. IBM Cloud API キーを使用して、IAM ベアラー・トークンを作成します。

   詳しくは、API キーを使用した IBM Cloud IAM トークンの生成を参照してください。

3. REST 要求を送信するときに IAM トークンを指定します。

   curl -X 'POST' https://{region}.ml.cloud.ibm.com/ml/v1/text/generation
   --header "Authorization: Bearer {IAM-token}..."
   

トークンの有効期限が切れた場合は、ユーザーがトークンをリフレッシュする必要があります。 トークンをリフレッシュするには、ステップ 2 から始まる手順を繰り返します。

Python ライブラリーの資格情報

Python ライブラリーを使用する場合は、API キーと IAM トークンのどちらを使用するかを選択できます。

IAM トークンを自分で作成し、そのトークンをライブラリーに渡す場合は、トークンの有効期限が切れる前にトークンのリフレッシュを管理する必要があります。

API キーをライブラリー内の APIClient に渡すと、クライアントは IAM トークンを生成し、必要に応じてトークンをリフレッシュします。

from ibm_watsonx_ai.foundation_models import ModelInference

model_inference = ModelInference(
    model_id="ibm/granite-13b-chat-v2",
    credentials={
        "apikey": "***",
        "url": "https://{region}.ml.cloud.ibm.com"
    },
    project_id="*****"
    )

from ibm_watsonx_ai import APIClient
from ibm_watsonx_ai import Credentials

credentials = Credentials(
  url = "https://{region}.ml.cloud.ibm.com",
  api_key = "{api-key}"
)

client = APIClient(credentials)

詳細情報

• プロジェクト ID の検索
• API リファレンス
• Pythonライブラリ

親トピック 生成的AIソリューションのコーディング