AIin1Portal

認証方式

AIone は OpenAI 互換プロトコルと Anthropic ネイティブプロトコルの両方に対応しています。ご利用のクライアントに応じて、適切な認証ヘッダーと Base URL を選択してください。

OpenAI 互換フォーマット

OpenAI SDK、Cursor、Cline、Continue、および自社開発の OpenAI Compatible クライアントに適用されます。

  • Base URL: https://api.portal.aiin1.ai/v1
  • 認証ヘッダー：
Authorization: Bearer sk-nex-xxxxxxxxxxxxxxxxxxxx

例：

curl https://api.portal.aiin1.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-nex-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "messages": [{"role": "user", "content": "こんにちは"}],
    "max_tokens": 256
  }'

Anthropic ネイティブフォーマット

Claude Code、Anthropic SDK、および Messages API を直接呼び出すクライアントに適用されます。

  • Base URL: https://api.portal.aiin1.ai
  • 認証ヘッダー：
x-api-key: sk-nex-xxxxxxxxxxxxxxxxxxxx
anthropic-version: 2023-06-01

例：

curl https://api.portal.aiin1.ai/v1/messages \
  -H "x-api-key: sk-nex-your-key-here" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "messages": [{"role": "user", "content": "こんにちは"}],
    "max_tokens": 256
  }'

クライアントが Base URL の入力のみを求める場合、Anthropic ネイティブクライアントでは https://api.portal.aiin1.ai を入力してください。SDK がプロトコルに従い /v1/messages にリクエストを送信します。

Gemini ネイティブフォーマット

Google Gemini SDK、自社ゲートウェイ集約、および Gemini generateContent API を直接呼び出すクライアントに適用されます。

  • Base URL: https://api.portal.aiin1.ai
  • 認証ヘッダー：
Authorization: Bearer sk-nex-xxxxxxxxxxxxxxxxxxxx

例：

curl https://api.portal.aiin1.ai/v1beta/models/gemini-2.5-flash:generateContent \
  -H "Authorization: Bearer sk-nex-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "こんにちは"}]}],
    "generationConfig": {"maxOutputTokens": 256}
  }'

リクエストフォーマットは Google Gemini API と完全に同一です。詳細なパラメータについては Gemini ネイティブインターフェース ドキュメントをご参照ください。

セキュリティに関する注意事項

  • API キーは sk-nex- プレフィックスで始まり、AIone コンソールで作成・管理できます。
  • API キーをコードリポジトリにコミットしないでください
  • フロントエンドのコードに API キーをハードコードしないでください
  • 環境変数を使用してキーを保管することを推奨します：
export AIONE_API_KEY="sk-nex-your-key-here"
import os
from openai import OpenAI
 
client = OpenAI(
    api_key=os.environ["AIONE_API_KEY"],
    base_url="https://api.portal.aiin1.ai/v1",
)

キー管理

操作 説明
作成 コンソール → API Keys → 作成。許可するモデル範囲を制限可能
ローテーション 新しいキーを作成し、切り替え完了後に古いキーを無効化または削除
無効化/有効化 キーの使用権限を一時的に停止
削除 永久削除（復元不可）