---
head:
  - - meta
    - name: description
      content: OneGateway で API Key と API URL を取得し、モデル ID をコピーして最初のモデル呼び出しを行い、クォータ、リクエストログ、利用量を確認します。
---

# クイックスタート

OneGateway は統合 AI ゲートウェイプラットフォームです。統一された API エンドポイントから各プロバイダーのモデルを呼び出せ、OpenAI、Anthropic などのインターフェース形式に対応し、スマートルーティング、セマンティックキャッシュ、多次元課金、コンテンツの安全性といったガバナンス機能を提供します。

このガイドでは、認証情報の取得から最初の呼び出しまでの流れを数分で完了できるよう説明します。

::: tip ホーム画面のクイックスタートガイド
ログインすると、ホーム画面に **Quick Start** ガイドが表示されます。メンバーは手順に従って API Key を作成し、呼び出しを行い、リクエストログを確認します。管理者は手順に従ってプロバイダーを接続し、ユーザーを作成し、ユーザーのクォータを設定します。このガイドの手順はメンバー向けガイドと同じなので、あわせてご覧ください。
:::

## 1. API Key を取得する

OneGateway コンソールにログインし、[API Keys](/ja/user/tokens) 画面を開いて **Create API Key** をクリックします。

- 名前を入力するだけで作成できます。デフォルトではクォータ無制限、有効期限なし、すべてのモデルを呼び出し可能です
- 制限が必要な場合は **Advanced settings** を開き、クォータ、有効期限、グループ料金、利用可能なモデルを設定します

作成に成功したら、完全なキー（`sk-` プレフィックス付き）をコピーします。キーはデフォルトでマスク表示されるため、大切に保管してください。画面上部の **API URL** は次の手順で使う Base URL なので、あわせてコピーします。

## 2. 最初のモデルを呼び出す

まず[利用可能なモデル](/ja/user/models)を開き、呼び出したいモデルを見つけて、モデル ID の横にあるコピーアイコンをクリックします。呼び出せるモデルは管理者が設定します。リクエストにはカードに表示される表示名ではなく、必ずモデル ID を使用してください。

OneGateway は複数のインターフェース形式に対応しています。以下では最もよく使われる OpenAI 形式を例にします。例のアドレス、キー、モデルを、コピーした API URL、API Key、モデル ID に置き換えてください。

::: code-group

```bash [cURL]
curl https://your-api-endpoint/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "messages": [{ "role": "user", "content": "こんにちは" }]
  }'
```

```python [Python]
from openai import OpenAI

client = OpenAI(
    base_url="https://your-api-endpoint/v1",
    api_key="sk-xxxxxxxx"
)

resp = client.chat.completions.create(
    model="your-model-id",
    messages=[{"role": "user", "content": "こんにちは"}]
)
print(resp.choices[0].message.content)
```

```ts [TypeScript]
import OpenAI from 'openai'

const client = new OpenAI({
  baseURL: 'https://your-api-endpoint/v1',
  apiKey: 'sk-xxxxxxxx'
})

const resp = await client.chat.completions.create({
  model: 'your-model-id',
  messages: [{ role: 'user', content: 'こんにちは' }]
})
console.log(resp.choices[0].message.content)
```

:::

アプリケーションがすでに Anthropic など別のインターフェース形式を使っている場合は、上記の書き方に変更する必要はありません。リクエスト先のアドレスを OneGateway の API URL に置き換えるだけで使えます。

呼び出しが成功しない場合は、まず API URL が完全か、キーを漏れなくコピーしたか、モデル ID が利用可能なモデルの画面から取得したものかを確認してください。

::: tip Claude Code、Codex で使う
Claude Code、Codex などのツールから OneGateway 経由でモデルを呼び出したい場合は、[よく使うツールとの連携](/ja/guide/tools)を参照してください。
:::

## 3. 利用量を確認する

呼び出しのたびにクォータがリアルタイムで差し引かれ、呼び出し記録は約 2 分後にリクエストログに表示されます。次の場所で確認できます。

- [API Keys](/ja/user/tokens) のカードで、各キーの残りクォータと使用率を確認
- [リクエストログ](/ja/user/usage)で、呼び出しごとのモデル、Token 使用量、費用を確認
- [個人ダッシュボード](/ja/user/my-dashboard)で、クォータの状況と最近の費用・利用量の推移を確認

## 次のステップ

- [Playground](/ja/user/playground) でモデルと直接対話する、または[よく使うツールとの連携](/ja/guide/tools)に従って Claude Code、Codex などのクライアントを設定する
- [よくある質問](/ja/guide/faq)で、接続、権限、クォータ、呼び出しのトラブルシューティングについて確認する
- [はじめに](/ja/guide/introduction)を読んで、OneGateway の用途とドキュメントの構成を理解する
- [API Keys](/ja/user/tokens) で利用可能なモデルと IP 制限を設定する
- [セマンティックキャッシュ](/ja/guide/semantic-cache)を使って重複リクエストのコストを削減する
- 管理者は[プロバイダーとモデル](/ja/admin/providers-and-models)でモデルを接続してグループ料金を設定し、続いて[ユーザーの管理](/ja/admin/users)でメンバーのアカウントを管理する

## ロール早見表

| ロール | できること |
| ---- | ---------- |
| メンバー | 自分の API Key の作成と管理、利用量とリクエストログの確認、引き換えコードでのチャージ |
| 管理者 | 自社のプロバイダー、モデル、料金、グループ料金、メンバーの API Key、引き換えコード、クォータ設定の管理 |