# Démarrage rapide

> Cré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.

## Avant de commencer

- Un compte Moon AI, propriétaire ou admin du workspace qui paiera les requêtes.
- Python ou Node.js, dans une version que le SDK officiel d’OpenAI prend en charge (ou `curl`).

## 1. Ouvrir le portail

Ouvrez le menu du compte › « API développeur ». Le portail s’ouvre sur l’onglet « Aperçu » ([ouvrir le portail](https://chat.realmoon.ai/settings/developer/overview)).

## 2. Approvisionner le porte-monnaie

Les requêtes sont débitées du porte-monnaie du workspace. Si votre forfait inclut un crédit API, il s’ajoute au solde à chaque période du forfait (voir [Crédit API inclus](https://realmoon.ai/documentation/api/couts/#credit-inclus)). Sinon, ou en plus :

1. Ouvrez « Facturation » ([ouvrir](https://chat.realmoon.ai/settings/developer/billing)).
2. Sous « Recharger », choisissez un « Montant à ajouter » ou saisissez un « Autre montant ».
3. Vérifiez le récapitulatif (« Vous recevez », « Total à payer HT »). La TVA est ajoutée au paiement selon votre adresse de facturation.
4. Cliquez sur « Continuer vers le paiement » et payez par carte. Le solde est crédité dès la confirmation du paiement.

Le détail des recharges, des frais et des factures est dans [Coûts et porte-monnaie](https://realmoon.ai/documentation/api/couts/).

## 3. Créer une clé

1. Ouvrez « Clés API » ([ouvrir](https://chat.realmoon.ai/settings/developer/keys)).
2. Dans « Créer une clé API », donnez un « Nom » à la clé, par exemple le nom de l’application qui l’utilisera.
3. Cliquez sur « Créer une clé ».
4. La fenêtre « Enregistrez votre clé API » affiche la clé `sk-moon-…`. Copiez-la et rangez-la dans un gestionnaire de secrets, puis cliquez sur « J’ai enregistré ma clé ».

> [!WARNING]
> **La clé n’est affichée qu’une fois**
>
> Moon AI ne garde qu’une empreinte de la clé : vous ne pourrez plus la revoir. Si vous la perdez, remplacez-la depuis « Clés API ». Les réglages facultatifs (expiration, plafond de dépense, liste d’IP) sont décrits dans [Authentification](https://realmoon.ai/documentation/api/authentification/).

## 4. Installer le SDK

L’API est compatible avec les SDK officiels d’OpenAI : aucun SDK propre à Moon AI n’est nécessaire.

```bash title="cURL"
# Rien à installer : curl suffit.
curl --version
```

```bash title="Python"
pip install openai
```

```bash title="JavaScript"
npm install openai
```

## 5. Mettre la clé dans l’environnement

Ne copiez jamais la clé dans le code ni dans un dépôt Git. Gardez-la dans une variable d’environnement ; les exemples lisent `MOONAI_API_KEY`, comme ceux du portail :

```bash title="Terminal"
export MOONAI_API_KEY="sk-moon-..."
```

> [!TIP]
> **Configurer le SDK sans argument**
>
> Les SDK d’OpenAI lisent aussi `OPENAI_API_KEY` et `OPENAI_BASE_URL`. Avec ces deux variables, `OpenAI()` (Python) ou `new OpenAI()` (JavaScript) se connecte à Moon AI sans autre réglage.
>
> ```bash title="Terminal"
> export OPENAI_API_KEY="sk-moon-..."
> export OPENAI_BASE_URL="https://api.realmoon.ai/v1"
> ```

## 6. Envoyer une première requête

L’exemple appelle `anthropic/claude-haiku-4.5`. Tout identifiant listé par `GET /v1/models` fonctionne ; la liste à jour se lit dans l’onglet « Modèles » ou par l’API (voir [Modèles](https://realmoon.ai/documentation/api/modeles/)).

```bash title="cURL"
curl https://api.realmoon.ai/v1/chat/completions \
  -H "Authorization: Bearer $MOONAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "model": "anthropic/claude-haiku-4.5",
        "messages": [{"role": "user", "content": "Bonjour"}]
      }'
```

```python title="Python"
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.realmoon.ai/v1",
    api_key=os.environ["MOONAI_API_KEY"],
)

response = client.chat.completions.create(
    model="anthropic/claude-haiku-4.5",
    messages=[{"role": "user", "content": "Bonjour"}],
)
print(response.choices[0].message.content)
```

```javascript title="JavaScript"
import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://api.realmoon.ai/v1',
  apiKey: process.env.MOONAI_API_KEY,
});

const response = await client.chat.completions.create({
  model: 'anthropic/claude-haiku-4.5',
  messages: [{ role: 'user', content: 'Bonjour' }],
});
console.log(response.choices[0].message.content);
```

## 7. Lire la réponse

La réponse a la forme d’une complétion OpenAI.

```json title="Réponse"
{
  "id": "gen-6f1c2b7e9a4d4c0e8b3a5d2f1e0c9b8a",
  "object": "chat.completion",
  "created": 1793577600,
  "model": "anthropic/claude-haiku-4.5",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Bonjour. Comment puis-je vous aider ?" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 9, "completion_tokens": 12, "total_tokens": 21 }
}
```

- `id` est l’identifiant de la requête chez Moon AI. Il sert à retrouver son coût avec `GET /v1/generation?id=…` (voir [Solde et coût d’une requête](https://realmoon.ai/documentation/api/solde/#generation)).
- `usage` donne les jetons, pas le coût.
- `model` est l’identifiant que vous avez appelé, ou le nom exact de la version servie par le fournisseur. Pour un modèle maison de Moon AI, c’est toujours l’identifiant Moon AI.

La réponse porte aussi des en-têtes propres à Moon AI :

```text title="En-têtes de réponse"
X-Moon-Request-Id: gen-6f1c2b7e9a4d4c0e8b3a5d2f1e0c9b8a
X-Moon-Prompt-Storage: none
X-Moon-Blur: on
```

`X-Moon-Blur: on` indique que Moon Blur a analysé la requête ; `X-Moon-Blur-Redactions` s’ajoute quand il a remplacé des valeurs. La liste complète est dans [Authentification](https://realmoon.ai/documentation/api/authentification/#en-tetes).

Quelques secondes après l’appel, la requête apparaît dans « Aperçu » › « Requêtes récentes » et dans « Utilisation » › « Journal des requêtes », sans son contenu.

## Voir aussi

- Recevoir la réponse au fil de l’eau, utiliser des outils ou des images : [Conversation](https://realmoon.ai/documentation/api/chat/).
- Créer des images, des vidéos, de la voix ou lire un document : [Images](https://realmoon.ai/documentation/api/images/), [Vidéos](https://realmoon.ai/documentation/api/videos/), [Audio](https://realmoon.ai/documentation/api/audio/), [OCR](https://realmoon.ai/documentation/api/ocr/).
- Gérer les erreurs et les nouvelles tentatives : [Erreurs](https://realmoon.ai/documentation/api/erreurs/) et [Limites](https://realmoon.ai/documentation/api/limites/).

---

Documentation Moon AI › API développeur › Démarrage rapide. Page : https://realmoon.ai/documentation/api/demarrage/. Modifiée le 5 novembre 2026.

© 2026 Stellarr Studio SAS. Tous droits réservés. Moon AI, Moon Blur et Stellarr Studio sont des marques déposées à l’INPI.