Aller au contenu

Intégrations

Connectez les outils que votre équipe utilise déjà.

Dirigez une seule fois les clients compatibles et les flux de travail API vers New API. Conservez vos outils familiers pendant que votre organisation contrôle l'accès aux modèles, l'usage et les dépenses.

Avant de connecter

Préparez d'abord le parcours d'accès.

Une intégration fiable commence par un responsable identifié, un modèle approuvé et une clé révocable sans modifier le code de l'application.

Confirmer un responsable

Désignez un responsable d'espace de travail ou de projet capable d'approuver les modèles, de suivre l'usage et de réagir lorsqu'une requête est bloquée.

Approuver le modèle

Consultez le catalogue de modèles et vérifiez que la capacité, le contexte et le parcours du fournisseur correspondent au flux de travail visé.

Définir un quota

Fixez une limite d'usage explicite à la clé ou à l'équipe avant de connecter un éditeur, un agent ou un service partagé.

Clients compatibles

Un parcours géré unique pour le travail IA quotidien.

Utilisez New API depuis l'éditeur, le terminal ou le client d'API compatible adapté au flux de travail.

VS Code

Flux de travail IA basés sur un éditeur

Codex

Flux de travail par agent et terminal

Claude Code

Flux de travail compatibles Anthropic

Trae

Flux de travail d'éditeurs pensés pour l'IA

Zcode

Flux de travail d'assistant de programmation

Clients compatibles

Configuration compatible OpenAI

Configurer avec soin

Gardez des identifiants et un comportement de requête prévisibles.

L'intégration doit être facile à tester pour un développeur et facile à examiner pour un administrateur.

Utiliser une clé côté serveur

Stockez la clé d'API New API dans une variable d'environnement ou un gestionnaire de secrets. Ne la placez jamais dans du code navigateur, un dépôt ou des journaux de requêtes.

Adapter le format de requête

Choisissez le point de terminaison correspondant à la famille de modèles, puis conservez l'identifiant du modèle et les champs requis dans le corps de la requête.

Testez une petite requête

Commencez par une requête représentative à faible volume. Vérifiez la réponse, le journal d'usage, le comportement des quotas et la gestion des erreurs avant le déploiement.

Orchestration d'agents

Laissez les agents appeler des outils via un parcours encadré unique.

Un agent peut planifier une tâche, récupérer du contexte et appeler un modèle approuvé, tandis que New API maintient les identifiants, l'accès aux modèles et la trace des requêtes sous les mêmes contrôles d'exploitation.

Requête de tâche
Agent
Récupérer du contexte
Appel de modèle
Résultat examiné

Un chemin d'intégration clair

De la configuration à un résultat encadré.

  1. 01

    Choisir un modèle approuvé

    Sélectionnez un modèle et une capacité rendus disponibles par votre organisation.

  2. 02

    Définir le point de terminaison compatible

    Configurez le client avec un point de terminaison New API et une clé d'API gérée.

  3. 03

    Examiner l'usage dans son contexte

    Utilisez les journaux de requêtes, les quotas et les données d'usage avant d'étendre l'accès.

FAQ d'intégration

Des réponses concrètes avant la production.

Utilisez ces réponses pour planifier une première connexion. La référence de l'API reste la source de vérité pour les champs de points de terminaison et le comportement propre à chaque fournisseur.

Par où commencer ?

Commencez par un flux de travail piloté, un modèle approuvé et une clé de test. Connectez-le dans un environnement hors production, vérifiez la réponse et le journal d'usage, puis étendez avec méthode.

Comment choisir l'URL de base et le point de terminaison ?

Utilisez l'URL de base New API fournie pour votre espace de travail et sélectionnez le point de terminaison compatible avec la famille de modèles. La référence de l'API liste les chemins actuels, les en-têtes requis et les champs de requête.

Où doit résider la clé d'API ?

Conservez-la sur le serveur ou dans le coffre de secrets de l'outil client, fournie par une variable d'environnement lorsque c'est possible. Ne l'exposez pas dans les bundles frontend, le contrôle de source, les captures d'écran ou les journaux.

Les formats OpenAI, Anthropic et Gemini sont-ils interchangeables ?

Ils ne sont pas interchangeables pour tous les modèles. New API prend en charge les formats compatibles lorsqu'ils s'appliquent, notamment Chat Completions, Responses, Anthropic Messages et Gemini GenerateContent. Consultez la documentation du modèle et du point de terminaison avant de changer de format.

Comment savoir quels modèles sont disponibles ?

Utilisez conjointement le catalogue de modèles et les autorisations de votre espace de travail. Un modèle peut apparaître dans le catalogue tout en exigeant qu'un administrateur l'autorise pour votre équipe ou votre clé.

Que faire des erreurs 401, 403, 404 ou 429 ?

Vérifiez la clé et l'en-tête pour un 401, les autorisations ou l'accès au modèle pour un 403, le chemin et la compatibilité du modèle pour un 404, et le quota ou les limites de débit pour un 429. Conservez l'ID de requête et consultez la référence de l'API ou le canal d'assistance en cas d'échec persistant.

Comment gérer les limites en production ?

Fixez les quotas avant la mise en service, utilisez des tentatives limitées avec temporisation pour les réponses transitoires, et surveillez l'usage et les taux d'erreur. Ne relancez pas aveuglément les échecs d'authentification ou d'autorisation.

Quand consulter la référence de l'API ?

Consultez-la dès que vous avez besoin des chemins exacts de points de terminaison, des en-têtes, des schémas de requête, du comportement de streaming, des champs média ou des contraintes propres à un fournisseur. Cette page explique le flux d'intégration ; la référence définit le contrat.