Solde et coût d’une requête

Deux points d’accès en lecture servent à suivre la dépense : GET /v1/credits lit le solde du workspace de la clé, GET /v1/generation lit ce qu’une requête précise a coûté. Ni l’un ni l’autre n’est facturé.

Lire le solde#Lien vers la section Lire le solde

GET https://api.realmoon.ai/v1/credits

Renvoie le solde du porte-monnaie API du workspace auquel appartient la clé.

• Authentification : clé sk-moon-… avec la portée inference (voir Authentification).
• Paramètres : aucun.
• Réponse : un objet credits.

Exemple#Lien vers la section Exemple

curl https://api.realmoon.ai/v1/credits \
  -H "Authorization: Bearer $MOONAI_API_KEY"

import os
import httpx
from openai import OpenAI

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

credits = client.get("/credits", cast_to=httpx.Response).json()
print(credits["balance"])

import OpenAI from 'openai';

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

const credits = await client.get('/credits');
console.log(credits.balance);

Réponse#Lien vers la section Réponse

{ "object": "credits", "balance": 1250000, "currency": "credits" }

Le solde remonte quand les requêtes en cours sont réglées à leur coût réel (voir Réserve puis coût réel). Un solde négatif bloque les nouvelles requêtes jusqu’à la prochaine recharge (402 insufficient_credits).

Erreurs#Lien vers la section Erreurs

Seules les erreurs communes à toute l’API s’appliquent : 401 invalid_api_key, 403 ip_not_allowed, 403 missing_scope, 429 rate_limit_exceeded, 503 service_unavailable. Voir Erreurs.

Lire le coût d’une requête#Lien vers la section Lire le coût d’une requête

GET https://api.realmoon.ai/v1/generation?id=gen-…

Renvoie le coût final et les jetons comptés d’une requête du workspace de la clé.

• Authentification : clé sk-moon-… avec la portée inference, du même workspace que la requête.
• Paramètre : id, dans l’adresse.
• Réponse : un objet generation.

Paramètre#Lien vers la section Paramètre

Où trouver l’identifiant :

Exemple#Lien vers la section Exemple

curl "https://api.realmoon.ai/v1/generation?id=gen-0123456789abcdef0123456789abcdef" \
  -H "Authorization: Bearer $MOONAI_API_KEY"

import os
import httpx
from openai import OpenAI

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

raw = client.chat.completions.with_raw_response.create(
    model="anthropic/claude-haiku-4.5",
    messages=[{"role": "user", "content": "Bonjour"}],
)
request_id = raw.headers.get("x-moon-request-id")

cost = client.get(
    "/generation",
    cast_to=httpx.Response,
    options={"params": {"id": request_id}},
).json()
print(cost["credits_charged"])

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' }] })
  .withResponse();
const requestId = response.headers.get('x-moon-request-id');

const cost = await client.get('/generation', { query: { id: requestId } });
console.log(cost.credits_charged);

Réponse#Lien vers la section Réponse

{
  "object": "generation",
  "id": "gen-0123456789abcdef0123456789abcdef",
  "model": "anthropic/claude-haiku-4.5",
  "tokens_prompt": 12,
  "tokens_completion": 41,
  "credits_charged": 0,
  "created_at": 1793836800
}

La valeur de credits_charged est fictive.

Quand relire le coût#Lien vers la section Quand relire le coût

• Une requête réglée tout de suite (réponse complète avec son compte de jetons, média terminé) a son coût définitif dès la réponse.
• Une réponse interrompue, ou dont le compte de jetons manquait, peut encore être réglée au coût réel annoncé par le fournisseur pendant une vingtaine de minutes : relisez /v1/generation plus tard.
• Une vidéo est réglée à la fin de la tâche : son coût se lit aussi dans usage.credits de l’objet vidéo (voir Vidéos).
• Le détail d’une requête peut être supprimé après 90 jours : /v1/generation répond alors 404. Les totaux par jour restent dans l’onglet « Utilisation » du portail.

Erreurs#Lien vers la section Erreurs

Les erreurs communes (clé, débit) sont dans Erreurs.

Voir aussi#Lien vers la section Voir aussi

• Coûts et porte-monnaie : réserve, règlement, recharges et factures.
• Limites : plafonds de dépense du workspace et des clés.
• Authentification : les en-têtes de réponse, dont X-Moon-Request-Id.