new-api

 # New API 🍥 **Passerelle de modèles étendus de nouvelle génération et système de gestion d'actifs d'IA**

中文 | English | Français | 日本語

Démarrage rapide • Fonctionnalités clés • Déploiement • Documentation • Aide

📝 Description du projet

[!NOTE]
Il s'agit d'un projet open-source développé sur la base de One API

[!IMPORTANT]

• Ce projet est uniquement destiné à des fins d'apprentissage personnel, sans garantie de stabilité ni de support technique.
• Les utilisateurs doivent se conformer aux Conditions d'utilisation d'OpenAI et aux lois et réglementations applicables, et ne doivent pas l'utiliser à des fins illégales.
• Conformément aux 《Mesures provisoires pour la gestion des services d'intelligence artificielle générative》, veuillez ne fournir aucun service d'IA générative non enregistré au public en Chine.

---

🤝 Partenaires de confiance

Sans ordre particulier

---

🙏 Remerciements spéciaux

Merci à JetBrains pour avoir fourni une licence de développement open-source gratuite pour ce projet

---

🚀 Démarrage rapide

Utilisation de Docker Compose (recommandé)

# Cloner le projet
git clone https://github.com/QuantumNous/new-api.git
cd new-api

# Modifier la configuration docker-compose.yml
nano docker-compose.yml

# Démarrer le service
docker-compose up -d

Utilisation des commandes Docker

# Tirer la dernière image
docker pull calciumion/new-api:latest

# Utilisation de SQLite (par défaut)
docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  -v ./data:/data \
  calciumion/new-api:latest

# Utilisation de 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

💡 Astuce: -v ./data:/data sauvegardera les données dans le dossier data du répertoire actuel, vous pouvez également le changer en chemin absolu comme -v /your/custom/path:/data

---

🎉 Après le déploiement, visitez http://localhost:3000 pour commencer à utiliser!

📖 Pour plus de méthodes de déploiement, veuillez vous référer à Guide de déploiement

---

📚 Documentation

### 📖 [Documentation officielle](https://docs.newapi.pro/en/docs) | [](https://deepwiki.com/QuantumNous/new-api)

Navigation rapide:

Catégorie	Lien
🚀 Guide de déploiement	Documentation d'installation
⚙️ Configuration de l'environnement	Variables d'environnement
📡 Documentation de l'API	Documentation de l'API
❓ FAQ	FAQ
💬 Interaction avec la communauté	Canaux de communication

---

✨ Fonctionnalités clés

Pour les fonctionnalités détaillées, veuillez vous référer à Présentation des fonctionnalités |

🎨 Fonctions principales

Fonctionnalité	Description
🎨 Nouvelle interface utilisateur	Conception d'interface utilisateur moderne
🌍 Multilingue	Prend en charge le chinois, l'anglais, le français, le japonais
🔄 Compatibilité des données	Complètement compatible avec la base de données originale de One API
📈 Tableau de bord des données	Console visuelle et analyse statistique
🔒 Gestion des permissions	Regroupement de jetons, restrictions de modèles, gestion des utilisateurs

💰 Paiement et facturation

• ✅ Recharge en ligne (EPay, Stripe)
• ✅ Tarification des modèles de paiement à l'utilisation
• ✅ Prise en charge de la facturation du cache (OpenAI, Azure, DeepSeek, Claude, Qwen et tous les modèles pris en charge)
• ✅ Configuration flexible des politiques de facturation

🔐 Autorisation et sécurité

• 😈 Connexion par autorisation Discord
• 🤖 Connexion par autorisation LinuxDO
• 📱 Connexion par autorisation Telegram
• 🔑 Authentification unifiée OIDC
• 🔍 Requête de quota d'utilisation de clé (avec neko-api-key-tool)

🚀 Fonctionnalités avancées

Prise en charge des formats d'API:

• ⚡ OpenAI Responses
• ⚡ OpenAI Realtime API (y compris Azure)
• ⚡ Claude Messages
• ⚡ Google Gemini
• 🔄 Modèles Rerank (Cohere, Jina)

Routage intelligent:

• ⚖️ Sélection aléatoire pondérée des canaux
• 🔄 Nouvelle tentative automatique en cas d'échec
• 🚦 Limitation du débit du modèle pour les utilisateurs

Conversion de format:

• 🔄 OpenAI Compatible ⇄ Claude Messages
• 🔄 OpenAI Compatible → Google Gemini
• 🔄 Google Gemini → OpenAI Compatible - Texte uniquement, les appels de fonction ne sont pas encore pris en charge
• 🚧 OpenAI Compatible ⇄ OpenAI Responses - En développement
• 🔄 Fonctionnalité de la pensée au contenu

Prise en charge de l'effort de raisonnement:

Voir la configuration détaillée

Modèles de la série OpenAI :

• o3-mini-high - Effort de raisonnement élevé
• o3-mini-medium - Effort de raisonnement moyen
• o3-mini-low - Effort de raisonnement faible
• gpt-5-high - Effort de raisonnement élevé
• gpt-5-medium - Effort de raisonnement moyen
• gpt-5-low - Effort de raisonnement faible

Modèles de pensée de Claude:

• claude-3-7-sonnet-20250219-thinking - Activer le mode de pensée

Modèles de la série Google Gemini:

• gemini-2.5-flash-thinking - Activer le mode de pensée
• gemini-2.5-flash-nothinking - Désactiver le mode de pensée
• gemini-2.5-pro-thinking - Activer le mode de pensée
• gemini-2.5-pro-thinking-128 - Activer le mode de pensée avec budget de pensée de 128 tokens
• Vous pouvez également ajouter les suffixes -low, -medium ou -high aux modèles Gemini pour fixer le niveau d’effort de raisonnement (sans suffixe de budget supplémentaire).

---

🤖 Prise en charge des modèles

Pour les détails, veuillez vous référer à Documentation de l'API - Interface de relais

Type de modèle	Description	Documentation
🤖 OpenAI-Compatible	Modèles compatibles OpenAI	Documentation
🤖 OpenAI Responses	Format OpenAI Responses	Documentation
🎨 Midjourney-Proxy	Midjourney-Proxy(Plus)	Documentation
🎵 Suno-API	Suno API	Documentation
🔄 Rerank	Cohere, Jina	Documentation
💬 Claude	Format Messages	Documentation
🌐 Gemini	Format Google Gemini	Documentation
🔧 Dify	Mode ChatFlow	-
🎯 Personnalisé	Prise en charge de l'adresse d'appel complète	-

📡 Interfaces prises en charge

Voir la liste complète des interfaces

• Interface de discussion (Chat Completions)
• Interface de réponse (Responses)
• Interface d'image (Image)
• Interface audio (Audio)
• Interface vidéo (Video)
• Interface d'incorporation (Embeddings)
• Interface de rerank (Rerank)
• Conversation en temps réel (Realtime)
• Discussion Claude
• Discussion Google Gemini

---

🚢 Déploiement

[!TIP] Dernière image Docker: calciumion/new-api:latest

📋 Exigences de déploiement

Composant	Exigence
Base de données locale	SQLite (Docker doit monter le répertoire /data)
**Base de données distante	MySQL ≥ 5.7.8 ou PostgreSQL ≥ 9.6
Moteur de conteneur	Docker / Docker Compose

⚙️ Configuration des variables d'environnement

Configuration courante des variables d'environnement

Nom de variable	Description	Valeur par défaut
SESSION_SECRET	Secret de session (requis pour le déploiement multi-machines)
CRYPTO_SECRET	Secret de chiffrement (requis pour Redis)	-
SQL_DSN	Chaine de connexion à la base de données	-
REDIS_CONN_STRING	Chaine de connexion Redis	-
STREAMING_TIMEOUT	Délai d'expiration du streaming (secondes)	300
STREAM_SCANNER_MAX_BUFFER_MB	Taille max du buffer par ligne (Mo) pour le scanner SSE ; à augmenter quand les sorties image/base64 sont très volumineuses (ex. images 4K)	64
MAX_REQUEST_BODY_MB	Taille maximale du corps de requête (Mo, comptée après décompression ; évite les requêtes énormes/zip bombs qui saturent la mémoire). Dépassement ⇒ 413	32
AZURE_DEFAULT_API_VERSION	Version de l'API Azure	2025-04-01-preview
ERROR_LOG_ENABLED	Interrupteur du journal d'erreurs	false
PYROSCOPE_URL	Adresse du serveur Pyroscope	-
PYROSCOPE_APP_NAME	Nom de l'application Pyroscope	new-api
PYROSCOPE_BASIC_AUTH_USER	Utilisateur Basic Auth Pyroscope	-
PYROSCOPE_BASIC_AUTH_PASSWORD	Mot de passe Basic Auth Pyroscope	-
PYROSCOPE_MUTEX_RATE	Taux d'échantillonnage mutex Pyroscope	5
PYROSCOPE_BLOCK_RATE	Taux d'échantillonnage block Pyroscope	5
HOSTNAME	Nom d'hôte tagué pour Pyroscope	new-api

📖 Configuration complète: Documentation des variables d'environnement

🔧 Méthodes de déploiement

Méthode 1: Docker Compose (recommandé)

# Cloner le projet
git clone https://github.com/QuantumNous/new-api.git
cd new-api

# Modifier la configuration
nano docker-compose.yml

# Démarrer le service
docker-compose up -d

Méthode 2: Commandes Docker

Utilisation de SQLite:

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

Utilisation de 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

💡 Explication du chemin:

• ./data:/data - Chemin relatif, données sauvegardées dans le dossier data du répertoire actuel
• Vous pouvez également utiliser un chemin absolu, par exemple : /your/custom/path:/data

Méthode 3: Panneau BaoTa

1. Installez le panneau BaoTa (version ≥ 9.2.0)
2. Recherchez New-API dans le magasin d'applications
3. Installation en un clic

📖 Tutoriel avec des images

⚠️ Considérations sur le déploiement multi-machines

[!WARNING]

• Doit définir SESSION_SECRET - Sinon l'état de connexion sera incohérent sur plusieurs machines
• Redis partagé doit définir CRYPTO_SECRET - Sinon les données ne pourront pas être déchiffrées

🔄 Nouvelle tentative de canal et cache

Configuration de la nouvelle tentative: Paramètres → Paramètres de fonctionnement → Paramètres généraux → Nombre de tentatives en cas d'échec

Configuration du cache:

• REDIS_CONN_STRING: Cache Redis (recommandé)
• MEMORY_CACHE_ENABLED: Cache mémoire

---

🔗 Projets connexes

Projets en amont

Projet	Description
One API	Base du projet original
Midjourney-Proxy	Prise en charge de l'interface Midjourney

Outils d'accompagnement

Projet	Description
neko-api-key-tool	Outil de recherche de quota d'utilisation avec une clé
new-api-horizon	Version optimisée haute performance de New API

---

💬 Aide et support

📖 Ressources de documentation

Ressource	Lien
📘 FAQ	FAQ
💬 Interaction avec la communauté	Canaux de communication
🐛 Commentaires sur les problèmes	Commentaires sur les problèmes
📚 Documentation complète	Documentation officielle

🤝 Guide de contribution

Bienvenue à toutes les formes de contribution!

• 🐛 Signaler des bogues
• 💡 Proposer de nouvelles fonctionnalités
• 📝 Améliorer la documentation
• 🔧 Soumettre du code

---

📜 Licence

Ce projet est sous licence GNU Affero General Public License v3.0 (AGPLv3).

Si les politiques de votre organisation ne permettent pas l'utilisation de logiciels sous licence AGPLv3, ou si vous souhaitez éviter les obligations open-source de l'AGPLv3, veuillez nous contacter à : support@quantumnous.com

---

🌟 Historique des étoiles

[](https://star-history.com/#Calcium-Ion/new-api&Date)

---

### 💖 Merci d'utiliser New API Si ce projet vous est utile, bienvenue à nous donner une ⭐️ Étoile！ **[Documentation officielle](https://docs.newapi.pro/en/docs)** • **[Commentaires sur les problèmes](https://github.com/Calcium-Ion/new-api/issues)** • **[Dernière version](https://github.com/Calcium-Ion/new-api/releases)** _{Construit avec ❤️ par QuantumNous}