クイックスタート

HALO では、1 つのプロジェクトスコープキーで、プロバイダー固有のモデル API、長期メモリ、認証、サービス ID、使用量制御を利用できます。このクイックスタートでは、OpenAI 互換モデルへの最初のリクエストを送信します。

#始める前に

HALO アカウントと有効なプロジェクトが必要です。モデル呼び出しでは、プロジェクト所有者のアカウント残高が使用されます。

#1.プロジェクトを作成する

HALO ダッシュボードで プロジェクトを選択し、連携するアプリケーションまたは環境用のプロジェクトを作成します。

1. 1
   境界に名前を付けます

   本番環境、ステージング環境、関連のない OEM 製品には、別々のプロジェクトを使用してください。メモリと認証データはプロジェクトごとに分離されます。

2. 2
   プロジェクトを開く

   選択したプロジェクトが、キー、モデル、メモリ、履歴、認証を管理するダッシュボードのコンテキストになります。

#2. API キーを作成する

API キーを選択してクライアントキーを作成し、一度だけコピーします。サーバーのシークレット管理ツールに HALO_API_KEY として保存してください。

HALO_API_KEY=sk-your-project-client-key

#3.リクエストを行う

HALO は各プロバイダー固有の通信プロトコルを維持します。既存の OpenAI クライアントのベース URL を HALO のベース URL に変更すれば、その他のリクエスト構造はそのまま使用できます。

curl https://api.agihalo.com/openai/v1/chat/completions \
  -H "Authorization: Bearer $HALO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-mini",
    "messages": [
      { "role": "user", "content": "Reply with one word: ready" }
    ]
  }'

#次のステップ