Endpoints personnalisés et Base URL

Endpoint API personnalisé : connecter une API compatible OpenAI

Endpoint personnalisé et Base URL expliqués : connectez une API compatible OpenAI, un relais, un proxy ou une passerelle avec une adresse et une clé.

Mis à jour le
  • Un endpoint d’API personnalisé (custom API endpoint) est l’adresse web, ou Base URL (URL de base), d’un service d’IA qui n’est pas intégré à votre app : une API compatible OpenAI, un relais, un proxy ou une passerelle (gateway). Dans Oriveo, il faut en général deux choses pour le connecter : cette adresse et une clé API.
  • Oriveo détermine le protocole pour vous (OpenAI Chat Completions, OpenAI Responses, Anthropic Messages ou Gemini) et ajoute le chemin de version, comme /v1, quand vous ne saisissez que l’adresse racine.
  • Les adresses publiques doivent utiliser HTTPS. Un service tiers voit tout ce que vous y faites passer : donnez-lui une clé distincte avec une limite de dépense, et ne lui confiez jamais la clé de votre compte officiel chez un fournisseur.
Oriveo sur iPhone : l’écran des fournisseurs, avec les fournisseurs que vous avez connectés et la dépense du mois.

Qu’est-ce qu’une Base URL ou un endpoint d’API ?

Chaque service d’IA a une adresse web à laquelle les apps envoient leurs requêtes. Les développeurs l’appellent Base URL, endpoint d’API ou URL de requête ; ici, ces termes désignent la même chose. Elle ressemble à une adresse web ordinaire. Celle d’OpenAI, par exemple, est https://api.openai.com/v1.

Dans Oriveo, les 15 fournisseurs intégrés ont déjà leur adresse renseignée : il suffit de coller une clé. L’endpoint personnalisé sert à tout le reste : un service qui propose une API compatible OpenAI, un relais ou une passerelle gérés par une entreprise, ou une passerelle que vous faites tourner sur votre propre serveur.

« Compatible OpenAI » signifie que le service accepte les requêtes au même format que l’API d’OpenAI : les apps conçues pour OpenAI peuvent donc dialoguer avec lui. De nombreux fournisseurs et passerelles proposent ce format.

Relais, proxy, passerelle : quelle différence ?

Ces termes sont souvent employés indifféremment, et pour connecter une app, le principe est le même : un service se place entre votre app et les fournisseurs de modèles, reçoit votre requête et la transmet. Certains regroupent plusieurs fournisseurs derrière une seule clé et une seule facture ; d’autres ajoutent des contrôles d’usage pour une équipe ; d’autres encore sont des logiciels que vous installez sur votre propre serveur.

Oriveo ne recommande ni ne classe aucun d’entre eux. Quel que soit votre choix, les étapes ci-dessous sont les mêmes.

De quoi ai-je besoin pour connecter un endpoint personnalisé ?

En général de deux choses, que vous trouverez dans le tableau de bord ou la documentation du service :

  • L’URL de requête (Base URL), par exemple https://api.example.com/v1. Elle doit commencer par https:// si le service est accessible publiquement sur Internet.
  • Une clé API délivrée par le service. Vous pouvez en ajouter d’autres avec « Ajouter une autre clé ».
  • Facultatif : un nom pour la connexion, pour la distinguer des autres.

Comment ajouter un endpoint personnalisé dans Oriveo ?

La marche à suivre est la même sur iPhone, Android et le web.

  • Ouvrez Fournisseurs et touchez le bouton + (Ajouter un fournisseur).
  • Choisissez le filtre Personnalisé, puis Relais personnalisé (« Connectez votre propre service de modèles »).
  • Sur l’écran « Connecter un relais personnalisé », collez l’URL de requête et la clé API. La ligne « Requête vers … » affiche l’adresse complète qu’Oriveo utilisera. Touchez Suivant.
  • Oriveo vérifie la connexion, lit la liste des modèles et détermine le protocole de chacun. Cette étape lit la liste sans envoyer de message de chat.
  • Cochez les modèles voulus et touchez « Enregistrer (sélection : N) ». Si le service ne publie pas la liste de ses modèles, utilisez « Ajouter un identifiant de modèle manuellement ».
  • Avant d’enregistrer, Oriveo envoie une toute petite requête au premier modèle sélectionné. La connexion est enregistrée si ce test réussit ; s’il échoue, vous restez à la même étape et pouvez corriger.
Écran Fournisseurs d’Oriveo sur iPhone, avec le bouton + en haut à droite et la liste des fournisseurs connectés
Touchez + sur l’écran Fournisseurs et choisissez Personnalisé pour ajouter un endpoint à côté de vos fournisseurs intégrés.

Vous préférez tout régler vous-même ? Passez par la configuration manuelle

La « Configuration manuelle » réunit tout sur une seule page : l’adresse, la clé, un identifiant de modèle, un nom de connexion facultatif et le protocole par défaut, réglé au départ sur automatique. Touchez « Vérifier et enregistrer ». Si la vérification échoue, rien n’est encore enregistré, et la carte d’erreur propose « Enregistrer quand même (non vérifié) » si vous voulez garder la connexion et la tester plus tard.

Oriveo détecte-t-il le protocole automatiquement ?

Dans la plupart des cas, oui. Les services d’IA utilisent l’un de quelques formats de requête, appelés protocoles. Oriveo en prend en charge quatre : OpenAI Chat Completions, OpenAI Responses, Anthropic Messages et Gemini generateContent.

Il décide modèle par modèle. Il s’appuie sur ce que le service indique pour chaque modèle quand cette information existe ; sinon, il retient les candidats probables d’après la famille du modèle. À l’enregistrement, le premier modèle sélectionné est testé avec une vraie requête ; les autres sont vérifiés plus tard, quand vous commencez à les utiliser.

En général, l’adresse et la clé suffisent donc. Si la documentation du service indique un protocole précis, ou si un modèle échoue à sa vérification, choisissez vous-même le protocole dans la configuration manuelle.

Faut-il ajouter /v1 à l’adresse ?

En général, non. Si vous ne saisissez que l’adresse racine, comme https://api.example.com, Oriveo ajoute le chemin de version standard du protocole : /v1 pour les formats OpenAI et Anthropic, /v1beta pour Gemini.

Si l’adresse contient déjà une version, comme /api/paas/v4, Oriveo la conserve. Si vous collez un endpoint complet se terminant par /chat/completions, /responses, /messages ou :generateContent, Oriveo retire cette fin et s’en sert pour savoir quel protocole parle le service.

Vérifiez la ligne « Requête vers … » avant de toucher Suivant. Si la vérification indique « L’adresse pointe peut-être vers une page web. Vérifiez s’il manque /v1. », comparez votre adresse avec la documentation du service.

Faut-il ajouter /v1 à l’adresse ?
Vous saisissezOriveo appelle (format OpenAI)
https://api.example.comhttps://api.example.com/v1
https://api.example.com/v1https://api.example.com/v1
https://api.example.com/v1/chat/completionshttps://api.example.com/v1, avec Chat Completions
https://api.example.com/api/paas/v4https://api.example.com/api/paas/v4

Quelles adresses sont acceptées ?

Oriveo applique quelques règles pour protéger votre clé :

  • Les adresses publiques doivent commencer par https://. Une adresse http:// accessible sur Internet ne peut être ni testée ni enregistrée.
  • Les adresses qui contiennent un nom d’utilisateur et un mot de passe, ou des paramètres de requête (tout ce qui suit un « ? »), ne sont pas acceptées. Oriveo n’essaie jamais de lire une clé API dans des paramètres de requête.
  • Les adresses en http:// simple sur votre réseau domestique ou un VPN privé, comme un serveur de modèles sur votre propre ordinateur, passent par l’entrée distincte « Calcul local » (« Calcul local et réseau local » sur iPhone) et non par Relais personnalisé.
  • Sur iPhone et Android, l’app se connecte directement à l’adresse.
  • Dans l’app web, les URL de requête publiques passent par le serveur Oriveo pour contourner les limites CORS du navigateur (une règle de sécurité des navigateurs qui bloque de nombreuses requêtes directes). Votre clé API est conservée en mémoire uniquement pour cette requête, sans jamais être stockée ni journalisée. Les adresses du réseau local sont appelées directement depuis votre appareil, et HTTPS est requis dans les deux cas ; une adresse en http:// simple sur votre réseau domestique nécessite l’app iPhone ou Android et son entrée « Calcul local ».
  • Les clés restent sur cet appareil et ne sont pas envoyées par la synchronisation cloud.

Base URL des fournisseurs intégrés

Vous n’en avez pas besoin dans Oriveo : choisissez simplement le fournisseur par son nom. Elles figurent ici parce qu’on les cherche souvent pour d’autres outils. Chacune est l’adresse officielle compatible OpenAI indiquée dans la documentation du fournisseur, au 18 novembre 2026.

  • Anthropic présente sa couche compatible OpenAI comme destinée aux tests et aux comparaisons, et le guide de démarrage de Mistral ne décrit pas son API comme compatible OpenAI. Ajoutez plutôt ces deux-là comme fournisseurs intégrés.
Base URL des fournisseurs intégrés
FournisseurBase URL compatible OpenAI
OpenAIhttps://api.openai.com/v1
Google Geminihttps://generativelanguage.googleapis.com/v1beta/openai/
OpenRouterhttps://openrouter.ai/api/v1
DeepSeekhttps://api.deepseek.com
xAI (Grok)https://api.x.ai/v1
Groqhttps://api.groq.com/openai/v1
Together AIhttps://api.together.ai/v1
Fireworks AIhttps://api.fireworks.ai/inference/v1
MiniMax (international)https://api.minimax.io/v1
Z.ai (international)https://api.z.ai/api/paas/v4/
Qwen (région Singapour)https://dashscope-intl.aliyuncs.com/compatible-mode/v1
Kimi (international)https://api.moonshot.ai/v1
SiliconFlow (international)https://api.siliconflow.com/v1

Un relais ou une API tierce, est-ce sûr ?

Prudence. Tout service placé entre vous et le modèle peut lire vos prompts, les fichiers que vous joignez et les réponses, et il fixe ses propres prix. Oriveo n’a aucune visibilité sur ce qui s’y passe et ne peut pas s’en porter garant.

  • Ne donnez jamais à un service tiers la clé API de votre compte officiel chez un fournisseur. Utilisez la clé que ce service vous délivre.
  • Créez une clé distincte pour Oriveo, et fixez une limite de dépense ou gardez un petit solde dessus si le service le permet.
  • N’envoyez pas de mots de passe, de numéros de pièce d’identité ou de documents de travail confidentiels via un service en qui vous n’avez pas confiance.
  • Contrôlez votre consommation dans le tableau de bord du service. Les coûts affichés par Oriveo sont des estimations ; les relevés du service font foi.
  • En cas de fuite d’une clé, supprimez-la dans le tableau de bord du service et créez-en une nouvelle.

Pourquoi mon endpoint personnalisé ne se connecte-t-il pas ?

Oriveo vous indique en une ligne ce qui ne va pas. Voici les messages, tels qu’ils s’affichent en français :

  • Pour les codes comme 401, 402 et 429, notre guide des erreurs de clé API explique ce que chacun signifie.
Pourquoi mon endpoint personnalisé ne se connecte-t-il pas ?
Message dans OriveoCe qu’il faut vérifier
L’adresse pointe peut-être vers une page web. Vérifiez s’il manque /v1.Comparez l’adresse avec la documentation du service ; ajoutez ou retirez le chemin de version
La clé n’est pas valide.Recopiez la clé depuis le tableau de bord du service
Cette clé ne permet pas de lister les modèles. Vous pouvez ajouter des modèles manuellement.Ajoutez vous-même l’identifiant du modèle à l’étape suivante
Connexion impossible. Vérifiez votre réseau ou votre proxy.Vérifiez votre connexion Internet et que l’adresse est joignable
Le service à cette adresse limite actuellement les requêtes.Patientez un instant et réessayez
Cette connexion n’a pas pu joindre son fournisseur en amont.Le compte du service auprès de son fournisseur est peut-être invalide, à court de crédits ou limité en débit ; contactez la personne qui le gère

Questions fréquentes sur l’app

Qu’est-ce qu’un endpoint d’API personnalisé ?
C’est l’adresse web d’un service d’IA qui n’est pas intégré à votre app, comme une API compatible OpenAI, un relais ou une passerelle. Vous le connectez en saisissant cette adresse (la Base URL) et une clé API fournie par le service.
Qu’est-ce qu’une API compatible OpenAI ?
Une API qui accepte les requêtes au même format que celle d’OpenAI, ce qui permet aux apps conçues pour OpenAI de l’utiliser. De nombreux fournisseurs et passerelles en proposent une, en général à une adresse qui se termine par /v1.
Quelle Base URL dois-je saisir ?
Celle indiquée dans la documentation du service. Si elle ne donne qu’un domaine, saisissez-le : Oriveo ajoute /v1 (ou /v1beta pour le format Gemini). Vérifiez la ligne « Requête vers … » avant de continuer.
Peut-on utiliser un endpoint personnalisé sur iPhone et Android ?
Oui. L’option Relais personnalisé est disponible dans les apps Oriveo pour iPhone et Android ainsi que dans l’app web. Sur iPhone et Android, l’app se connecte directement à l’adresse.
Pourquoi Oriveo exige-t-il HTTPS ?
HTTPS chiffre la connexion : votre clé et vos messages ne circulent pas en clair sur Internet. Pour un serveur de modèles sur votre réseau domestique, utilisez l’entrée « Calcul local ».
Un relais ou un proxy d’API, est-ce sûr ?
Il peut lire tout ce que vous y faites passer : la confiance est donc essentielle. Utilisez une clé délivrée par le service, jamais la clé officielle de votre fournisseur, fixez une limite de dépense et n’y faites pas passer d’informations sensibles.

À lire aussi

Sur le blog

Connectez votre propre service de modèles

Ouvrez l’app web ou téléchargez Oriveo pour iPhone ou Android, choisissez Relais personnalisé et collez l’adresse et la clé de votre service.

Vous n’avez pas encore de clé API ? Commencez avec Oriveo Free.