クイックスタート

このページでは最短の手順でモデル呼び出しを 1 回動かします。完了したら、ユーザーガイドの各機能ページを必要に応じて読んでください。

前提条件

Glacier AI のアカウント。登録時にメールアドレスの確認を求められることがあります。
アカウントに利用可能なクォータがあること。新しいアカウントで残高が 0 の場合は、まずウォレットでチャージするか引き換えコードを使ってください。

このページの例ではサイトアドレスを https://api.example.com と表記します。実際に利用しているアドレスに置き換えてください。

ステップ 1: 登録してログインする

サイトのトップページを開き、右上の「ログイン」をクリックするか、/sign-in に直接アクセスします。
アカウントがない場合は「登録」をクリックするか /sign-up にアクセスし、案内に従ってユーザー名とパスワードを入力します。必要に応じてメール認証と人間確認を完了します。
ログインするとコンソールに入ります。左側のナビゲーションに、現在のアカウントで利用できる機能モジュールが表示されます。

詳細は登録とログインを参照してください。

ステップ 2: API キーを作成する

左側のナビゲーションで「API キー」をクリックするか、/keys に直接アクセスします。
「API キーを作成」をクリックし、名前を入力します（「本番環境」「テスト用」など用途がわかる名前を推奨）。
必要に応じてクォータ、有効期限、モデル制限、グループ、IP 許可リストを設定します。判断できない場合はすべて空欄のままにすると制限なしになります。
保存後、一覧から完全なキーを表示してコピーします。形式は sk-xxxxxxxx です。

詳細は API キーを参照してください。

ステップ 3: 最初のリクエストを送る

プラットフォームは OpenAI 互換 API を提供します。公式 SDK のベース URL を、サイトアドレス + /v1 に置き換えるだけです。

curl https://api.example.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "こんにちは"}]
  }'

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxx",
    base_url="https://api.example.com/v1",
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "こんにちは"}],
)
print(response.choices[0].message.content)

コードを書きたくない場合は、左側ナビゲーションの「プレイグラウンド」（/playground）から、ブラウザー上でモデルを選んで会話を送信できます。

ステップ 4: 利用状況と課金を確認する

左側のナビゲーションで「利用ログ」をクリックするか、/usage-logs/common にアクセスします。
先ほどのリクエスト記録を見つけ、モデル、トークン数、所要時間、消費クォータを確認します。
レコードをクリックすると詳細が開き、リクエスト ID、モデルマッピング、課金内訳などを確認できます。

詳細はログと非同期タスクを参照してください。

よくある問題

症状	確認するポイント
401 Unauthorized が返る	`Authorization: Bearer <キー>` の形式、キーが有効化されているか、期限切れでないかを確認します。
403 Forbidden が返る	キーのモデル制限、グループ権限、IP 許可リストを確認します。
クォータ不足と表示される	ウォレットで残高やサブスクリプションのクォータ、さらにキー自体のクォータ上限を確認します。
モデルが存在しないと表示される	モデルマーケットでそのモデルが有効か、現在のグループで利用できるかを確認します。
ログに記録が見当たらない	ログの書き込みには数秒の遅れがあります。少し待って更新してください。失敗した応答がすべてエラー記録になるわけでもありません。

次のステップ

機能ガイド概要: 全機能の索引と、おすすめの読む順番。
API とプレイグラウンド: 対応するすべてのエンドポイントとネイティブ形式での呼び出し方法。
チャットアプリ連携: よく使う AI クライアントに設定をワンクリックで取り込みます。