Guide de l'utilisateur

Protocoles API

LMU AI prend en charge trois protocoles entrants — Anthropic, OpenAI Compatible et Gemini natif. Un seul tableau pour choisir la bonne Base URL et le bon endpoint et éviter les erreurs.

LMU AI prend en charge trois protocoles entrants : Anthropic, OpenAI Compatible et Gemini natif v1beta. Chaque endpoint utilise votre clé API LMU AI sk-, et les modèles que vous pouvez réellement appeler sont déterminés par le groupe de la clé.

Deux choses à bien distinguer d'abord

  • « Quel protocole » est décidé par le client, le SDK et le cas d'usage. Le SDK Anthropic utilise /v1/messages, le SDK OpenAI utilise /v1/chat/completions ou /v1/responses, et les appels image natifs Gemini utilisent /v1beta/models/{model}:generateContent.
  • « Quels modèles vous pouvez appeler » est décidé par le groupe de votre clé API (le compte upstream derrière votre abonnement / plan de recharge), qui est une dimension distincte du protocole entrant.

Autrement dit : le mauvais protocole donne un 401 / 404 net ; le bon protocole avec un modèle hors de la portée de votre groupe renvoie une erreur de modèle indisponible.

L'erreur la plus courante vient du mauvais protocole

  • La Base URL du protocole Anthropic ne comporte pas le suffixe /v1
  • La Base URL du SDK du protocole OpenAI comporte généralement le suffixe /v1
  • Le protocole Gemini natif utilise https://api.lmuai.com comme hôte et appelle le chemin complet /v1beta/...

Se tromper provoque des erreurs 400 / 401 / 404. Avant de configurer un outil ou d'écrire du code, confirmez quel protocole le client attend.


Choisissez votre protocole en un coup d'œil

ProtocoleBase URLOutils typiques
Protocole Anthropichttps://api.lmuai.comClaude Code (CLI / desktop / extension VS Code), le SDK officiel anthropic, Cherry Studio, Kilo Code avec Claude / modèles chinois, tout client compatible Anthropic
OpenAI Compatiblehttps://api.lmuai.com/v1Codex CLI, Codex App, Cursor / Cline / Roo Code / OpenCode, le SDK officiel openai, extensions VS Code avec GPT, tout client compatible OpenAI
Gemini natif v1betahttps://api.lmuai.comSDK / clients HTTP Gemini natif, texte-vers-image et image-vers-image Gemini, liste des modèles et generateContent

Les trois protocoles utilisent la clé LMU AI qui commence par sk- :

  • Protocole Anthropic : Authorization: Bearer <YOUR_API_KEY> ou x-api-key: <YOUR_API_KEY>
  • OpenAI Compatible : Authorization: Bearer <YOUR_API_KEY>
  • Gemini natif : x-goog-api-key: <YOUR_API_KEY> recommandé, Bearer également accepté

Protocole Anthropic

Base URL : https://api.lmuai.com (pas de /v1)

Endpoints :

  • POST /v1/messages — conversation par messages
  • POST /v1/messages/count_tokens — comptage de tokens
  • GET /v1/models — liste des modèles disponibles

Exemple SDK Python :

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.lmuai.com",
    api_key="sk-xxxxxxxx",
)

resp = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.content[0].text)

Exemple curl :

curl -X POST https://api.lmuai.com/v1/messages \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [{"role":"user","content":"Hello"}]
  }'

Pourquoi le base_url du SDK est-il sans /v1 mais le curl avec /v1 ?

La convention du base_url du SDK officiel Anthropic est d'omettre /v1 ; le SDK ajoute en interne des chemins comme /v1/messages. Lorsque vous écrivez du curl à la main, vous écrivez le chemin complet /v1/messages. Les deux pointent vers le même endpoint.


Protocole OpenAI

Base URL : https://api.lmuai.com/v1 (avec /v1)

Endpoints :

  • POST /chat/completions — API Chat Completions standard
  • POST /responses — API OpenAI Responses (y compris les sous-chemins /responses/{id})
  • POST /images/generations, POST /images/edits — génération / édition d'images

Exemple SDK Python :

from openai import OpenAI

client = OpenAI(
    base_url="https://api.lmuai.com/v1",
    api_key="sk-xxxxxxxx",
)

resp = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

Exemple curl :

curl -X POST https://api.lmuai.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role":"user","content":"Hello"}]
  }'

Protocole Gemini natif

Base URL : https://api.lmuai.com

Endpoints principaux :

  • GET /v1beta/models — lister les modèles Gemini natifs
  • GET /v1beta/models/{model} — interroger un modèle spécifique
  • POST /v1beta/models/{model}:generateContent — génération de texte, texte-vers-image et image-vers-image
  • POST /v1beta/models/{model}:streamGenerateContent?alt=sse — génération en streaming

Authentification :

x-goog-api-key: YOUR_API_KEY

Exemple minimal texte-vers-image :

curl --request POST \
  'https://api.lmuai.com/v1beta/models/gemini-3.1-flash-image:generateContent' \
  -H 'x-goog-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "an orange cat wearing an astronaut helmet"}]
    }],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {"aspectRatio": "1:1", "imageSize": "1K"}
    }
  }'

L'endpoint image de Gemini n'est pas /v1/chat/completions

Les modèles image Gemini utilisent le generateContent natif. Pour tous les détails sur le texte-vers-image, l'image-vers-image, le 1K / 2K / 4K et le parsing Base64, consultez l'API Gemini Image.

Pour les modèles image GPT, consultez l'API GPT Image, et pour les modèles image Grok, consultez l'API Grok Image. Pour les gros travaux Gemini hors ligne, consultez l'API Gemini Batch Image.


Le protocole et les modèles disponibles sont deux choses différentes

Les modèles que votre clé peut appeler sont entièrement décidés par le compte upstream monté sur son groupe, indépendamment du protocole avec lequel vous appelez :

L'upstream de votre groupeLes modèles que vous pouvez réellement appeler
Compte OpenAI uniquementSérie GPT uniquement
Compte Claude uniquementSérie Claude uniquement (même si vous appelez avec le protocole OpenAI, le backend traduit le protocole, mais la portée des modèles reste inchangée)
Upstream de modèles chinois uniquement (par ex. GLM / Kimi)uniquement les modèles chinois correspondants
Routage des modèles configuré dans le backend (groupe multi-upstream)routé par nom de modèle vers différents upstreams, peut couvrir plusieurs marques — la portée exacte dépend de la configuration du groupe

Donc :

  • Choisir le protocole Anthropic, OpenAI Compatible ou Gemini natif détermine le format de la requête entrante ; la portée réelle des modèles est toujours décidée par le groupe de la clé API.
  • Pour voir quels modèles votre clé actuelle peut appeler, consultez la liste des modèles du groupe sur la page de détail des Clés API ou la page Modèles disponibles dans la console.

À propos du groupe Claude Max

Le groupe Claude Max prend en charge uniquement le protocole Anthropic

Le groupe Claude Max est réservé à Claude Code uniquement, il ne peut donc utiliser que le protocole Anthropic (https://api.lmuai.com).

Si vous utilisez une clé d'un groupe de plan Claude Max :

  • ✅ Elle fonctionne dans Claude Code (CLI / desktop / extension VS Code)
  • ❌ Elle ne peut pas être utilisée avec Codex CLI, Cursor, Cherry Studio ou tout outil qui utilise le protocole OpenAI
  • ❌ Elle ne peut pas être saisie comme https://api.lmuai.com/v1

Pour utiliser un outil du protocole OpenAI, passez à une clé d'un groupe à paiement à l'usage / abonnement régulier (les modèles exacts disponibles dépendent toujours du groupe de plan que vous avez acheté).


Dépannage

SymptômeCause habituelleQue faire
401 UnauthorizedLa Base URL utilise le mauvais protocole / faute de frappe dans la clé / IDE non redémarréVérifiez que la Base URL correspond au protocole de l'outil ; redémarrez l'IDE pour recharger la configuration
404 Not FoundURL du protocole OpenAI sans /v1, URL Anthropic incluant /v1 par erreur, ou chemin Gemini n'utilisant pas /v1beta/models/...Revérifiez la Base URL et l'endpoint complet par rapport au tableau ci-dessus
Modèle indisponible / No available accountsUn modèle hors de la portée de votre groupe a été appelé (par ex. appeler GPT avec un groupe Claude Max)Confirmez les modèles réellement inclus dans votre groupe sur la page Modèles disponibles, ou passez à un groupe qui inclut le modèle cible
429 Too Many RequestsQuota quotidien épuiséConsultez la FAQ

Pour plus de dépannage, consultez la FAQ.


Prochaines étapes

Une fois le protocole et la Base URL corrects, choisissez l'outil que vous voulez :

Dernière mise à jour :

Sur cette page