Modèles

GET /v1/models renvoie le catalogue au format de l’API d’OpenAI, avec en plus le type de chaque modèle et ses prix en crédits. La liste suit le catalogue de Moon AI : lisez-la plutôt que de figer des identifiants dans votre code.

GET https://api.realmoon.ai/v1/models
GET https://api.realmoon.ai/v1/models?type=image

• Authentification : clé sk-moon-… avec la portée inference (voir Authentification).
• Réponse : un objet list dont data contient les modèles, triés par identifiant pour la conversation, puis les modèles de médias.
• Facturation : aucune.

Paramètre#Lien vers la section Paramètre

Exemple#Lien vers la section Exemple

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

curl "https://api.realmoon.ai/v1/models?type=image" \
  -H "Authorization: Bearer $MOONAI_API_KEY"

import os
from openai import OpenAI

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

for model in client.models.list():
    info = model.model_dump()
    print(info["id"], info.get("type"), info.get("pricing"))

images = client.models.list(extra_query={"type": "image"})
print([m.id for m in images])

import OpenAI from 'openai';

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

const all = await client.models.list();
for (const model of all.data) console.log(model.id, model.type, model.pricing);

const images = await client.models.list({ query: { type: 'image' } });
console.log(images.data.map((m) => m.id));

Réponse#Lien vers la section Réponse

{
  "object": "list",
  "data": [
    {
      "id": "anthropic/claude-haiku-4.5",
      "object": "model",
      "created": 1777593600,
      "name": "Claude Haiku 4.5",
      "owned_by": "moon-ai",
      "pricing": {
        "prompt_credits_per_1m": 7000,
        "completion_credits_per_1m": 35000,
        "unit": "credits",
        "per": "1M_tokens"
      },
      "context_length": 200000,
      "type": "chat",
      "endpoints": ["/v1/chat/completions"],
      "types": ["chat"]
    },
    {
      "id": "google/gemini-3.1-flash-image",
      "object": "model",
      "created": 1793577600,
      "name": "Nano Banana 2 (Gemini 3.1 Flash Image)",
      "owned_by": "moon-ai",
      "type": "image",
      "endpoints": ["/v1/images/generations", "/v1/images/edits"],
      "hosting": "provider",
      "pricing": {
        "unit": "image",
        "credits_per_unit": 469,
        "max_credits_per_unit": 1155,
        "billing": "real_cost",
        "variants": [
          { "name": "1K", "credits_per_unit": 469, "max_credits_per_unit": 525 },
          { "name": "2K", "credits_per_unit": 707, "max_credits_per_unit": 770 },
          { "name": "4K", "credits_per_unit": 1057, "max_credits_per_unit": 1155 }
        ]
      },
      "aspect_ratios": ["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9"],
      "image_sizes": ["1K", "2K", "4K"],
      "max_input_images": 8,
      "output_format": "png",
      "types": ["image"]
    }
  ]
}

L’objet liste#Lien vers la section L’objet liste

Champs communs à tous les modèles#Lien vers la section Champs communs à tous les modèles

Modèles de conversation (chat)#Lien vers la section Modèles de conversation (chat)

Les modèles hébergés par Moon AI ont le même prix en entrée et en sortie. Un modèle qui lit les images, l’audio ou les fichiers les facture selon son propre tarif ; le coût exact de chaque requête se lit sur /v1/generation.

Modèles de médias#Lien vers la section Modèles de médias

Tous les modèles de médias portent :

Champs propres à chaque type :

Le détail de chaque type est dans Images, Vidéos, Audio, Embeddings et OCR.

Quels modèles sont servis#Lien vers la section Quels modèles sont servis

• Les modèles actifs et ouverts à tous dans Moon AI : les grands modèles du marché (OpenAI, Anthropic, Google, Mistral, Meta, DeepSeek, Qwen…) et les modèles maison de Moon AI, comme Moon 6, quand ils sont publics.
• Jamais un modèle à accès restreint, un agent ni un modèle privé d’un workspace.
• Jamais un modèle dont le prix n’est pas connu, ni un modèle qui fait des recherches web payantes à chaque requête : leur coût ne peut pas être borné à l’avance.
• Dans une organisation gérée, les modèles que ses règles refusent sont retirés de la liste.

Un identifiant qui n’est pas dans la liste répond 404 model_not_found. La lecture d’un seul modèle (GET /v1/models/{id}) n’est pas servie (404 unknown_url) : filtrez la liste.

Prix#Lien vers la section Prix

Les prix sont en crédits. Ils suivent le prix du modèle chez son fournisseur et peuvent changer avec lui ; relisez la liste plutôt que de les garder en dur. L’onglet « Modèles » du portail affiche les mêmes prix en euros, avec une recherche et un tri par prix ou par taille de contexte (ouvrir). La conversion entre crédits et euros est expliquée dans Coûts et porte-monnaie.

Erreurs#Lien vers la section Erreurs

Les erreurs de clé et de débit, communes à toute l’API, sont dans Erreurs.

Voir aussi#Lien vers la section Voir aussi

• Conversation : appeler un modèle de type chat.
• Coûts et porte-monnaie : comment les prix deviennent une facture.