AI Inference

Une seule passerelle compatible avec OpenAI, facturée à l'usage.

Ouvrez AI Inferencedans le projet courant. Il s'agit d'une API distincte de l'API HTTP de la plateforme. Les clés de plateforme (nodion_…) gèrent les ressources. Les clés d'inférence (nodion_ai_…) appellent les modèles.

Onglets

Keys : créez une clé. Elle n'est affichée qu'une seule fois. Vous pouvez définir une date d'expiration et une limite de dépenses quotidienne. Une clé utilise le solde prépayé ou est liée à une offre de codage IA ; une clé liée à une offre utilise aussi le solde pour les modèles hors de l'offre ou lorsque son palier d'usage est atteint, si l'offre l'autorise. Les admins du projet gèrent toutes les clés ; les autres membres ne créent et ne voient que les clés de l'offre qui leur est attribuée.
Playground : testez le chat (et d'autres modes quand des modèles existent). Le trafic du Playground est mesuré comme toute autre requête et débité du solde prépayé. Réservé au propriétaire et aux admins du projet.
Models : catalogue et disponibilité des modèles.
Usage et Requests.
Billing : un solde prépayé, distinct de la facture mensuelle de la plateforme. Rechargez-le par carte ou PayPal.
Coding Plans : offres prépayées facultatives Go / Pro / Max, avec 2× plus d'usage pour le chat et les outils, une offre par développeur. Le propriétaire du projet achète les offres et attribue chacune à un membre du projet ; les clés liées à une offre l'utilisent. Consultez AI Coding Plans sur le site et gérez vos offres dans AI Inference → Coding Plans.
Settings : autorisez ou excluez des fournisseurs, définissez une liste facultative de régions autorisées et des options de politique comme la zero data retention. La zero data retention est toujours active pour les modèles hébergés par Nodion ; l'option du projet s'applique aux fournisseurs routés.

Appeler l'API

bashcurl https://api.nodion.ai/v1/chat/completions \
  -H "Authorization: Bearer $NODION_AI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "<model>", "messages": [{"role": "user", "content": "Hello"}]}'

Tous les endpoints, y compris ceux des embeddings, du rerank, de System One et de l'OCR, ainsi que leurs limites et codes d'erreur, figurent dans la référence de l'API IA.

Consultez la liste des modèles facturés au token avec GET https://api.nodion.ai/v1/models ou parcourez l'onglet Models (qui inclut aussi l'OCR, la transcription audio et la synthèse vocale). Les prix y figurent aussi, pas dans la grille tarifaire de la plateforme. Les dépenses d'IA sont débitées du solde ou d'un coding plan, pas de la facture de la plateforme. Les modèles vocaux et OCR ne sont pas listés sur /v1/models : utilisez le catalogue du dashboard ou la liste publique /v2/public/ai/models. Les modèles marqués Preview peuvent être retirés du catalogue à court préavis. Aucune date de retrait n'est annoncée ; vous pouvez les appeler jusqu'à leur retrait.

Transcription audio (speech-to-text)

POST /v1/audio/transcriptions est une requête multipart au format OpenAI. Le corps complet de la requête doit rester sous 25 MiB (fichier plus champs du formulaire). Les fichiers eux-mêmes sont limités à 20 MiB. La durée est facturée à la seconde.

bashcurl https://api.nodion.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $NODION_AI_KEY" \
  -F model="mistral/voxtral-mini-transcribe" \
  -F file="@speech.wav"

Synthèse vocale (text-to-speech)

POST /v1/audio/speech renvoie les octets audio. L'entrée est facturée par caractère UTF-8 (point de code Unicode).

bashcurl https://api.nodion.ai/v1/audio/speech \
  -H "Authorization: Bearer $NODION_AI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "mistral/voxtral-mini-tts", "input": "Hello from Nodion", "voice": "en-US"}' \
  --output speech.mp3

Clonage de voix

Les modèles avec supports_voice_cloning acceptent dans voice, sur POST /v1/audio/speech, l'identifiant d'une voix clonée dans le projet. Créez un échantillon avec POST /v1/audio/voices (multipart name, consent=true et un file de 3 à 30 secondes). Dix voix par projet. Dix tentatives de création par heure. Les échantillons sont stockés chiffrés jusqu'à la suppression de la voix ou du projet ; une courte référence est envoyée à Mistral à chaque synthèse. Vous devez confirmer que l'échantillon est votre propre voix ou que la personne enregistrée a consenti au clonage.

bashcurl https://api.nodion.ai/v1/audio/voices \
  -H "Authorization: Bearer $NODION_AI_KEY" \
  -F name="Studio" \
  -F consent="true" \
  -F file="@clip.wav"

curl https://api.nodion.ai/v1/audio/speech \
  -H "Authorization: Bearer $NODION_AI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "mistral/voxtral-mini-tts", "input": "Hello from Nodion", "voice": "<voice-id>"}' \
  --output cloned.mp3

Transcription en temps réel

Les modèles temps réel utilisent wss://api.nodion.ai/v1/audio/transcriptions/realtime?model=… avec la même clé Bearer. Le format des messages est celui des trames JSON de Mistral (session.update, input_audio.append avec du PCM en base64), pas l'API realtime pour agents d'OpenAI.

Génération d'images

Les modèles d'image utilisent l'API Images d'OpenAI : POST https://api.nodion.ai/v1/images/generations. La réponse est uniquement en b64_json : url et le téléchargement d'images distantes sont refusés. n est réservé à l'avance, puis facturé par image renvoyée. Les modèles d'image figurent dans l'onglet Models, pas sur GET /v1/models.

bashcurl https://api.nodion.ai/v1/images/generations \
  -H "Authorization: Bearer $NODION_AI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "<image-model>", "prompt": "a red cube", "n": 1, "size": "1024x1024"}'

Outils

La recherche web, les actualités, le fetch, les images, les vidéos, les lieux, les cartes, le shopping et la recherche d'image inversée sont facturés à l'appel : sur le même solde, ou sur l'usage inclus si la clé est liée à une offre de codage IA. Ils figurent dans le catalogue AI Inference et s'appellent avec une clé d'inférence :

bashcurl https://api.nodion.ai/v1/tools/web_news \
  -H "Authorization: Bearer $NODION_AI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "EU cloud regulation", "limit": 5}'

POST /v1/tools/web_search accepte le même corps avec query et peut, en option, charger les pages des résultats (fetch hydration). POST /v1/tools/web_images, web_videos, web_places, web_maps et web_shopping utilisent le même format avec query. web_maps accepte aussi un ll facultatif (@lat,lng,zoomz). POST /v1/tools/web_lens prend comme url l'adresse d'une image. POST /v1/tools/web_fetch prend une url et renvoie du Markdown par défaut. Les paramètres facultatifs location, language et freshness (day, week, month, year) filtrent la recherche, les actualités, les images et les vidéos.

Les chargements de pages (web_fetch et le chargement des résultats de web_search) s'exécutent en tant que NodionBot et respectent robots.txt, Content-Signal: ai-input=no et tdm-reservation. Sur web_fetch, seuls les en-têtes de requête Accept et Accept-Language sont transmis ; les autres en-têtes sont ignorés et signalés dans warnings, et les URL contenant des identifiants sont refusées.

Un web_fetch refusé renvoie 403 avec blocked_by_robots, blocked_by_content_signal, blocked_by_tdm_reservation ou blocked_domain, ou 503 avec robots_unavailable (le robots.txt du site n'a pas pu être lu) ou fetch_unavailable ; les appels refusés ne sont pas facturés, et vous pouvez réessayer plus tard après un 503. Pendant le chargement des résultats de web_search, un résultat refusé laisse la recherche en 200 : il figure dans warnings avec son code et n'est pas facturé, alors que la recherche elle-même l'est.

Confidentialité

Le DPA d'AI Inference (accord de traitement des données) couvre les prompts et les sorties uniquement pour les modèles hébergés par Nodion (catalogue serving: hosted). Les fournisseurs routés, les AI Tools (recherche web, actualités, fetch) et le clonage de voix sont hors du champ de ce DPA. Les échantillons de voix restent chiffrés jusqu'à ce que vous supprimiez la voix ou le projet ; une courte référence est envoyée à Mistral à chaque synthèse.

Agents qui gèrent le cloud

Pour que Cursor ou Claude créent des apps et des bases de données, utilisez MCPavec une clé personnelle de plateforme, pas avec une clé d'inférence.