OneGatewayドキュメント

日本語

简体中文
English

日本語

简体中文
English

テーマ

クイックスタート ​

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

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

ホーム画面のクイックスタートガイド

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

1. API Key を取得する ​

OneGateway コンソールにログインし、API Keys 画面を開いて Create API Key をクリックします。

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

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

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

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

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

bash
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
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
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 が利用可能なモデルの画面から取得したものかを確認してください。

Claude Code、Codex で使う

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

3. 利用量を確認する ​

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

次のステップ ​

ロール早見表 ​

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

Copyright © 2026 AIRPULSE TECHNOLOGIES PTE. LTD.