このガイドで達成できること

このチュートリアルでは、以下のタスクを行います：

• IBM Cloud のアカウントとプロジェクトを設定してください。
• 推論APIへの認証を行います。
• ファウンデーションモデルを使って、最初のチャット応答を生成しましょう。
• ご自身のデータを使ってモデルをカスタマイズするための次の手順についてご確認ください。

開始前に

以下のものが揃っていることを確認してください：

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

• Red Hat AI Inference のプロジェクトです。

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

プロジェクトIDとAPIエンドポイントを取得する

すべてのAPIリクエストには、プロジェクトIDが必要です。

1. Red Hat AI Inference のプロジェクトページへ移動してください。

2. プロジェクトを開いてください。

3. プロジェクトIDをコピーし、次の手順のために控えておいてください。

https://us-east.rhai.ibm.com/v1/projects/<project_id>/inference

API への認証を行う

ファウンデーションモデルを操作するには、まずAPIリクエストの認証を行う必要があります。 ベアラー・トークンまたは IBM Cloud APIキーのいずれかを使用できます。 このチュートリアルでは、プログラムによるアクセスを行う際に、サービス ID と API キーを併用する方法について説明します。 ベアラー・トークンの使用に関する詳細については、「 ベアラー・トークンを使用した認証 」を参照してください。

取り扱いモデルを見る

基盤モデルごとに強みが異なるため、プロジェクトで利用可能なモデルを精査することが重要です。

利用可能なすべてのモデルを一覧表示するには、以下のAPI呼び出しを行ってください。 <project_id> をプロジェクト ID に、 <api_key> をサービス ID の API キーに置き換えてください：

curl -L 'https://us-east.rhai.ibm.com/v1/projects/<project_id>/inference/models' \
  -H 'Accept: application/json' \
  -H "Authorization: Bearer <api_key>"

from openai import OpenAI
client = OpenAI(
  api_key="<api_key>",
  base_url="https://us-east.rhai.ibm.com/v1/projects/<project_id>/inference",
)
models = client.models.list()
print(models)

この応答には、使用可能なすべてのモデルと、それぞれの機能に関する情報が表示されます。 さまざまなモデルを試してみて、ご自身のユースケースに最適なモデルを見つけてください。

初めてのチャット完了を生成する

それでは、モデルにメッセージを送信して、AIが生成した返信を受け取ってみましょう。

以下のAPI呼び出しを実行してください。この際、「 <project_id> 」をプロジェクトIDに、「 <api_key> 」をサービスIDのAPIキーに置き換えてください

curl https://us-east.rhai.ibm.com/v1/projects/<project_id>/inference/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <api_key>" \
  -d '{
    "model": "granite-4-0-h-small",
    "messages": [
      {
        "role": "developer",
        "content": "You are a helpful assistant"
      },
      {
        "role": "user",
        "content": "Hello! Tell me about yourself"
      }
    ]
  }'

from openai import OpenAI
client = OpenAI(
  api_key="<api_key>",
  base_url="https://us-east.rhai.ibm.com/v1/projects/<project_id>/inference",
)
completion = client.chat.completions.create(
  model="granite-4-0-h-small",
  messages=[
    {"role": "developer", "content": "You are a helpful assistant."},
    {"role": "user", "content": "Hello! Tell me about yourself"}
  ]
)
print(completion.choices[0].message)

モデルから自己紹介の返信が届くはずです。

次のステップ

推論機能の利用を開始できたところで、次にできることは以下の通りです：