New API

🍥 次世代大規模モデルゲートウェイとAI資産管理システム

简体中文 | 繁體中文 | English | Français | 日本語

クイックスタート • 主な機能 • デプロイ • ドキュメント • ヘルプ

📝 プロジェクト説明

[!IMPORTANT] - 本プロジェクトは、合法的に許可された AI API ゲートウェイ、組織レベルの認証、マルチモデル管理、利用量分析、コスト管理、プライベートデプロイのシナリオのみを対象としています。 - ユーザーは、上流の API キー、アカウント、モデルサービス、インターフェース権限を合法的に取得し、上流のサービス利用規約および適用される法律法規を遵守する必要があります。 - ユーザーは、利用方法が上流のサービス利用規約および適用される法律法規に準拠していることを確認してください。 - 生成 AI サービスを公衆に提供する場合、ユーザーは適用される規制要件を遵守し、管轄区域で求められる届出、ライセンス、コンテンツセキュリティ、本人確認、ログ保持、税務、上流認可などのすべての義務を履行してください。

🤝 信頼できるパートナー

順不同

🙏 特別な感謝

感謝 JetBrains が本プロジェクトに無料のオープンソース開発ライセンスを提供してくれたことに感謝します

🚀 クイックスタート

Docker Composeを使用（推奨）

# プロジェクトをクローン
git clone https://github.com/QuantumNous/new-api.git
cd new-api

# docker-compose.yml 設定を編集
nano docker-compose.yml

# サービスを起動
docker-compose up -d

Dockerコマンドを使用

# 最新のイメージをプル
docker pull calciumion/new-api:latest

# SQLiteを使用（デフォルト）
docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  -v ./data:/data \
  calciumion/new-api:latest

# MySQLを使用
docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e SQL_DSN="root:123456@tcp(localhost:3306)/oneapi" \
  -e TZ=Asia/Shanghai \
  -v ./data:/data \
  calciumion/new-api:latest

💡 ヒント: -v ./data:/data は現在のディレクトリの data フォルダにデータを保存します。絶対パスに変更することもできます：-v /your/custom/path:/data

🎉 デプロイが完了したら、http://localhost:3000 にアクセスして使用を開始してください！

[!WARNING] 本プロジェクトを公衆向け生成 AI サービスまたは API 再販サービスとして運営する場合、ユーザーは届出、コンテンツセキュリティ、本人確認、ログ保持、税務、決済、上流認可などの必要なコンプライアンス義務を先に完了してください。

📖 その他のデプロイ方法についてはデプロイガイドを参照してください。

📚 ドキュメント

📖 公式ドキュメント |

クイックナビゲーション:

✨ 主な機能

詳細な機能については機能説明を参照してください。

🎨 コア機能

💰 認可済み利用量とコスト管理

• ✅ 合法的に許可されたシナリオでの内部チャージとクォータ割り当て（EPay、Stripe）
• ✅ 組織レベルのリクエスト単位、使用量ベース、キャッシュヒットのコスト会計
• ✅ OpenAI、Azure、DeepSeek、Claude、Qwen などのモデルのキャッシュ課金統計
• ✅ 内部管理または認可済み企業顧客向けの柔軟な課金ポリシー

🔐 認証とセキュリティ

• 😈 Discord認証ログイン
• 🤖 LinuxDO認証ログイン
• 📱 Telegram認証ログイン
• 🔑 OIDC統一認証
• 🔍 Key使用量クォータ照会（new-api-key-toolと併用）

🚀 高度な機能

APIフォーマットサポート: - ⚡ OpenAI Responses - ⚡ OpenAI Realtime API（Azureを含む） - ⚡ Claude Messages - ⚡ Google Gemini - 🔄 Rerankモデル（Cohere、Jina）

インテリジェントルーティング: - ⚖️ チャネル重み付けランダム - 🔄 失敗自動リトライ - 🚦 ユーザーレベルモデルレート制限

フォーマット変換: - 🔄 OpenAI Compatible ⇄ Claude Messages - 🔄 OpenAI Compatible → Google Gemini - 🔄 Google Gemini → OpenAI Compatible - テキストのみ、関数呼び出しはまだサポートされていません - 🚧 OpenAI Compatible ⇄ OpenAI Responses - 開発中 - 🔄 思考からコンテンツへの機能

Reasoning Effort サポート:

詳細設定を表示

OpenAIシリーズモデル: - o3-mini-high - 高思考努力 - o3-mini-medium - 中思考努力 - o3-mini-low - 低思考努力 - gpt-5-high - 高思考努力 - gpt-5-medium - 中思考努力 - gpt-5-low - 低思考努力

Claude思考モデル: - claude-3-7-sonnet-20250219-thinking - 思考モードを有効にする

Google Geminiシリーズモデル: - gemini-2.5-flash-thinking - 思考モードを有効にする - gemini-2.5-flash-nothinking - 思考モードを無効にする - gemini-2.5-pro-thinking - 思考モードを有効にする - gemini-2.5-pro-thinking-128 - 思考モードを有効にし、思考予算を128トークンに設定する - Gemini モデル名の末尾に -low / -medium / -high を付けることで推論強度を直接指定できます（追加の思考予算サフィックスは不要です）。

🤖 モデルサポート

詳細についてはAPIドキュメント - ゲートウェイインターフェース

📡 サポートされているインターフェース

完全なインターフェースリストを表示

• チャットインターフェース (Chat Completions)
• レスポンスインターフェース (Responses)
• イメージインターフェース (Image)
• オーディオインターフェース (Audio)
• ビデオインターフェース (Video)
• エンベッドインターフェース (Embeddings)
• 再ランク付けインターフェース (Rerank)
• リアルタイム対話インターフェース (Realtime)
• Claudeチャット
• Google Geminiチャット

🚢 デプロイ

[!TIP] 最新のDockerイメージ: calciumion/new-api:latest

📋 デプロイ要件

⚙️ 環境変数設定

一般的な環境変数設定

📖 完全な設定: 環境変数ドキュメント

🔧 デプロイ方法

方法 1: Docker Compose（推奨）

# プロジェクトをクローン
git clone https://github.com/QuantumNous/new-api.git
cd new-api

# 設定を編集
nano docker-compose.yml

# サービスを起動
docker-compose up -d

方法 2: Dockerコマンド

SQLiteを使用:

docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  -v ./data:/data \
  calciumion/new-api:latest

MySQLを使用:

docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e SQL_DSN="root:123456@tcp(localhost:3306)/oneapi" \
  -e TZ=Asia/Shanghai \
  -v ./data:/data \
  calciumion/new-api:latest

💡 パス説明: - ./data:/data - 相対パス、データは現在のディレクトリのdataフォルダに保存されます - 絶対パスを使用することもできます：/your/custom/path:/data

方法 3: 宝塔パネル

1. 宝塔パネル（9.2.0バージョン以上）をインストールし、アプリケーションストアでNew-APIを検索してインストールします。

📖 画像付きチュートリアル

⚠️ マルチマシンデプロイの注意事項

[!WARNING] - すべてのノードで同じプライマリデータベースと同じ SESSION_SECRET を使用してください。異なる場合、Access Token、Refresh セッション、一時認証フローを一貫して検証できません。 - 同じ Redis に接続するノードでは同じ CRYPTO_SECRET も設定してください。異なる場合、キャッシュキーのダイジェストが一致せず、共有エントリを正しく再利用できません。

ログイン Session とユーザー単位の有効数／発行数制限では、データベースが信頼できる唯一の情報源です。Redis の Session エントリは短期キャッシュであり、TTL は SYNC_FREQUENCY（デフォルト 60 秒）に従い、Session の残り有効期間を超えません。