L’API développeur de Moon AI donne accès aux modèles du catalogue depuis vos propres programmes. Elle suit le format de l’API d’OpenAI : un SDK OpenAI fonctionne en changeant seulement l’URL de base et la clé.
CaractéristiquesLien vers la section Caractéristiques
| Propriété | Valeur |
|---|---|
| URL de base | https:// |
| Authentification | Authorization: ou x-api-key: |
| Format | celui de l’API d’OpenAI (JSON, flux SSE, enveloppe d’erreur {"error": ) |
| Paiement | à l’usage, sur le porte-monnaie du workspace, rechargé par carte avec facture |
| Unité | le porte-monnaie compte en crédits ; le portail affiche les montants en euros |
| Données personnelles | Moon Blur masque les données détectées dans le texte avant l’envoi au modèle et les remet dans la réponse |
| Conservation | Moon AI ne garde pas le contenu de vos requêtes, seulement leurs métadonnées de facturation |
Le porte-monnaie est indépendant de l’abonnement. Certains forfaits incluent un crédit API chaque mois : voir Coûts et porte-monnaie et les formules.
Points d’accèsLien vers la section Points d’accès
| Méthode | Chemin | Rôle | Référence |
|---|---|---|---|
POST | / | Réponse d’un modèle de conversation, avec ou sans flux | Conversation |
GET | /v1/models | Catalogue des modèles avec leurs prix en crédits | Modèles |
POST | / | Création d’images | Images |
POST | / | Retouche à partir d’une ou plusieurs images | Images |
POST | /v1/videos | Lancer une vidéo (tâche en arrière-plan) | Vidéos |
GET | / | Suivre une vidéo | Vidéos |
GET | / | Télécharger une vidéo terminée | Vidéos |
GET | /v1/videos | Lister vos vidéos | Vidéos |
POST | / | Lecture d’un texte à voix haute | Audio |
POST | / | Transcription d’un fichier audio | Audio |
POST | / | Vecteurs (embeddings) d’un ou plusieurs textes | Embeddings |
POST | /v1/ocr | Texte d’un PDF ou d’une image, lu sur nos serveurs en France | OCR |
GET | /v1/credits | Solde du porte-monnaie du workspace | Solde et coût |
GET | / | Coût et jetons d’une requête passée | Solde et coût |
Toute autre adresse répond 404 avec le code unknown_url, par exemple l’API Messages au format Anthropic, l’API Responses ou la lecture d’un seul modèle (GET /).
Le portailLien vers la section Le portail
Le portail se trouve dans le menu du compte › « API développeur » (ouvrir le portail). Il est réservé au propriétaire et aux admins du workspace ; un membre voit « Réservé aux propriétaires et aux admins ».
| Onglet | Ce que vous y faites |
|---|---|
| « Aperçu » | Solde, dépense et requêtes du mois, recharge automatique, requêtes récentes, démarrage rapide avec l’URL de base |
| « Utilisation » | Dépenses, requêtes et jetons par jour, modèles les plus utilisés, « Journal des requêtes » (métadonnées seulement) |
| « Clés API » | Créer, régler, remplacer et révoquer les clés |
| « Facturation » | Recharger, régler la recharge automatique, « Historique des crédits », « Factures » |
| « Modèles » | Catalogue filtrable par type, prix en euros, identifiant à copier |
| « Limites » | Plafonds de dépense du workspace, limite de débit par clé, plafonds par clé |
Le portail travaille sur le workspace actif. Si vous changez de workspace dans un autre onglet, il vous demande de recharger la page avant toute action.
Par où commencerLien vers la section Par où commencer
- Démarrage rapide : une clé, un SDK, un premier appel.
- Authentification : les clés, leurs réglages et les en-têtes.
- Conversation : la référence complète de
POST /.v1/ chat/ completions - Coûts et porte-monnaie, Erreurs et Limites : la réserve, les codes d’erreur, les plafonds et les nouvelles tentatives, à connaître avant de passer en production.
- Confidentialité : ce que Moon AI garde, ce que Moon Blur masque et ce que voient les fournisseurs des modèles.
Dans cette section
Prise en main
- Démarrage rapideCréer une clé, approvisionner le porte-monnaie du workspace, installer le SDK d’OpenAI et envoyer une première requête à l’API de Moon AI, étape par étape.
- Authentification et clésEnvoyer une clé sk-moon, la créer, la limiter (expiration, plafond, liste d’IP, Moon Blur), la remplacer ou la révoquer, et les en-têtes de l’API.
Référence
- Conversation (chat completions)Référence de POST /v1/chat/completions : paramètres, messages, réponse, flux SSE et format des morceaux, outils, images, longueur de sortie et erreurs.
- ModèlesRéférence de GET /v1/models : les modèles que votre clé peut appeler, avec leur type, leurs points d’accès, leurs prix en crédits et ce que chacun accepte.
- ImagesRéférence de POST /v1/images/generations et POST /v1/images/edits : créer et retoucher des images au format d’OpenAI, tailles, formats, limites et coûts.
- VidéosRéférence de POST /v1/videos et des routes GET /v1/videos : lancer une vidéo, suivre la tâche, la télécharger, lister vos vidéos, avec les délais et les coûts.
- Audio (voix et transcription)Référence de POST /v1/audio/speech, qui lit un texte à voix haute, et de POST /v1/audio/transcriptions, qui transcrit un enregistrement, au format d’OpenAI.
- EmbeddingsRéférence de POST /v1/embeddings : transformer des textes en vecteurs au format d’OpenAI, pour la recherche sémantique ou le regroupement, avec Moon Blur.
- OCR (texte d’un document)Référence de POST /v1/ocr : extraire le texte d’un PDF ou d’une image avec moon-ocr-1, qui tourne sur nos serveurs en France sans rien envoyer à un fournisseur.
- Solde et coût d’une requêteRéférence de GET /v1/credits, qui donne le solde du porte-monnaie du workspace, et de GET /v1/generation, qui donne le coût final et les jetons d’une requête.
Fonctionnement
- Coûts et porte-monnaieComment l’API se paie : porte-monnaie du workspace compté en crédits, réserve puis coût réel de chaque requête, recharges, recharge automatique et factures.
- ErreursLe format des erreurs de l’API, au format d’OpenAI, la liste complète des codes avec leur statut et la conduite à tenir, et leur lecture avec les SDK.
- LimitesDébit par clé, requêtes simultanées, tailles, durées et plafonds de dépense de l’API développeur, et la façon de réessayer une requête sans la payer deux fois.
- Confidentialité et Moon BlurCe que Moon AI garde d’une requête d’API, ce que Moon Blur masque avant l’envoi au modèle, et ce que les fournisseurs des modèles reçoivent et voient.