Une clé d'API. 126 modèles. Trois formats.
unbottled.ai parle les chat completions OpenAI, la Responses API d'OpenAI et l'Anthropic Messages API sur un seul endpoint. Votre SDK reste. Vos outils restent. Seule l'URL de base change. La même clé pilote aussi 85 modèles d'image, de voix, de vidéo et de musique.
GPT chez OpenAI, Claude chez Anthropic, Gemini chez Google. Trois SDK, trois clés, trois factures, trois tableaux de bord. Ou pire : l'outil que vous aimez ne parle qu'un format, donc il n'a accès qu'aux modèles d'un seul fournisseur.
unbottled.ai réunit 126 modèles de chat de 17 labos derrière une seule clé et un seul solde de crédits. Appelez-les au format OpenAI, au format Responses ou au format Anthropic. Les mêmes modèles sur chaque endpoint. Voici précisément comment ça marche, ce que ça coûte, et quand passer en direct ou par un routeur est le meilleur choix.
Tous les endpoints, une seule clé
Chaque endpoint prend la même clé et débite le même solde. Les trois formats de chat servent les mêmes modèles.
- POST /v1/chat/completions : OpenAI Chat Completions. Streaming SSE qui se termine par data: [DONE], stream_options.include_usage, appels d'outils. Le format que parle presque tout client compatible OpenAI.
- POST /v1/responses : la Responses API d'OpenAI, le format de Codex CLI. Streaming et outils. Sans état : store vaut false et previous_response_id est refusé avec un 400, envoyez donc l'entrée complète à chaque tour.
- POST /v1/messages : l'Anthropic Messages API. Streaming et utilisation d'outils. C'est à elle que parlent Claude Code et les SDK Anthropic.
- POST /v1/messages/count_tokens : ne coûte aucun crédit. Une estimation locale, sans appel de modèle, qui ne compte pas dans votre limite de requêtes par minute. Claude Code l'appelle en permanence pour dimensionner son contexte.
- GET /v1/models : tous les modèles que votre clé peut appeler maintenant, avec longueur de contexte, support des outils et prix. Un seul corps de réponse, lisible par les SDK OpenAI comme Anthropic.
- Les médias au format OpenAI, 85 modèles : POST /v1/images/generations et /v1/images/edits, /v1/audio/speech, /v1/audio/transcriptions et /v1/audio/translations. La vidéo (POST /v1/videos) et la musique (POST /v1/music) tournent en tâches asynchrones : lancer, suivre, télécharger. GET /v1/models indique la modality de chaque modèle.
L'authentification fonctionne de deux façons, sur chaque endpoint. Authorization: Bearer sk-unb-... pour les clients OpenAI et pour Claude Code avec ANTHROPIC_AUTH_TOKEN. x-api-key: sk-unb-... pour les SDK Anthropic. Les clés commencent par sk-unb-, s'affichent une seule fois et ne sont stockées que sous forme de hash. Créez-les dans Paramètres > Clés d'API, jusqu'à 20 clés actives par compte.
Pour les SDK OpenAI et les outils de type OpenAI. La locale fait partie du chemin. Elle ne règle que la langue des messages d'erreur, et toute locale prise en charge fonctionne, mais elle doit être présente.
URL de base Anthropic: https://unbottled.ai/api/fr-FR
Pour les SDK Anthropic et Claude Code. Même URL sans /v1 : ils ajoutent eux-mêmes /v1/messages.
Code : votre SDK, notre URL de base
Aucune nouvelle bibliothèque cliente. Les SDK officiels OpenAI et Anthropic fonctionnent tels quels. Remplacez sk-unb-YOUR_KEY par votre clé.
curl
La preuve la plus rapide que votre clé fonctionne. Une chat completion toute simple, rien à installer.
curl https://unbottled.ai/api/fr-FR/v1/chat/completions \
-H "Authorization: Bearer sk-unb-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kimi-k3.1-pro",
"messages": [
{ "role": "system", "content": "You answer in one sentence." },
{ "role": "user", "content": "Why is the sky blue?" }
]
}'SDK Python OpenAI
Définissez base_url et api_key sur le client, puis appelez chat.completions.create comme d'habitude. N'importe quel modèle de GET /v1/models va dans le champ model, Claude et Gemini compris.
from openai import OpenAI
client = OpenAI(
base_url="https://unbottled.ai/api/fr-FR/v1",
api_key="sk-unb-YOUR_KEY",
)
reply = client.chat.completions.create(
model="kimi-k3.1-pro",
messages=[{"role": "user", "content": "Why is the sky blue?"}],
)
print(reply.choices[0].message.content)Le même client parle aussi la Responses API. Appelez client.responses.create. Rappel : ici, elle est sans état. Passez toute la conversation en input à chaque tour.
reply = client.responses.create(
model="kimi-k3.1-pro",
input="Why is the sky blue?",
)
print(reply.output_text)SDK Python Anthropic
Définissez base_url sans /v1 et votre clé comme api_key, puis appelez messages.create. Les modèles de raisonnement placent d'abord un bloc thinking : l'exemple affiche donc le bloc text, pas le premier bloc.
import anthropic
client = anthropic.Anthropic(
base_url="https://unbottled.ai/api/fr-FR",
api_key="sk-unb-YOUR_KEY",
)
reply = client.messages.create(
model="kimi-k3.1-pro",
max_tokens=1024,
messages=[{"role": "user", "content": "Why is the sky blue?"}],
)
# Reasoning models put a thinking block first: print the text block.
print(next(block.text for block in reply.content if block.type == "text"))Besoin d'une taille avant d'envoyer ? count_tokens renvoie une estimation sans appeler de modèle. Aucun crédit dépensé.
curl https://unbottled.ai/api/fr-FR/v1/messages/count_tokens \
-H "x-api-key: sk-unb-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-5-20250929",
"messages": [{ "role": "user", "content": "Why is the sky blue?" }]
}'Lister les modèles
GET /v1/models fait foi. Il montre exactement quels ids votre clé peut appeler, avec longueur de contexte, support des outils et prix par token.
curl https://unbottled.ai/api/fr-FR/v1/models \
-H "Authorization: Bearer sk-unb-YOUR_KEY"Images, voix, vidéo, musique
Même clé, même URL de base, les formats média d'OpenAI. Les clients images et audio du SDK OpenAI fonctionnent tels quels. Choisissez dans GET /v1/models un modèle avec la bonne modality.
curl https://unbottled.ai/api/fr-FR/v1/images/generations \
-H "Authorization: Bearer sk-unb-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-3-klein",
"prompt": "A lighthouse on a cliff at dawn, oil painting",
"size": "1024x1024",
"n": 1
}'Vidéo et musique prennent des minutes, elles tournent donc en tâches. POST répond tout de suite avec un id. Suivez-la gratuitement, puis téléchargez le fichier. Une tâche échouée ne coûte rien.
curl https://unbottled.ai/api/fr-FR/v1/videos \
-H "Authorization: Bearer sk-unb-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan-2-7-t2v",
"prompt": "A paper boat drifting down a rainy street, cinematic",
"seconds": 5,
"size": "1280x720"
}'# Poll until status is completed or failed (free, no rate budget)
curl https://unbottled.ai/api/fr-FR/v1/videos/video_8f2c0e5a7b1d4c3e9a6f0b2d4e6a8c1f \
-H "Authorization: Bearer sk-unb-YOUR_KEY"
# Download the MP4
curl https://unbottled.ai/api/fr-FR/v1/videos/video_8f2c0e5a7b1d4c3e9a6f0b2d4e6a8c1f/content \
-H "Authorization: Bearer sk-unb-YOUR_KEY" \
-o boat.mp4Ids de modèles : les nôtres ou ceux du fournisseur
Inutile de réécrire les configs qui nomment déjà un modèle. Nous acceptons les graphies courantes.
- Nos ids, tels que GET /v1/models les liste : claude-sonnet-5.5, gpt-6.1-sol, glm-5.3. Utilisez-les si vous partez de zéro.
- Les graphies des fournisseurs marchent aussi. Les ids Anthropic datés (claude-sonnet-4-5-20250929 devient claude-sonnet-4.5), les numéros de version avec tirets, les suffixes -latest, le suffixe de contexte [1m] et les ids à points comme gpt-5.5.
- Les préfixes de fournisseur comme anthropic/... ou openai/..., pour que les ids façon OpenRouter d'une config existante continuent de fonctionner.
- Sur /v1/messages uniquement : un id Claude que votre compte ne peut pas appeler, comme les ids intégrés que Claude Code envoie pour ses appels en arrière-plan, bascule sur le Claude le plus récent de la même famille (Opus, Sonnet ou Haiku) auquel vous avez accès. Claude Code fonctionne sans variable d'environnement supplémentaire. Tout autre id inconnu renvoie 404 model_not_found.
Utiliser Claude Code et Codex CLI avec d'autres modèles
Les deux se connectent directement. Pas de proxy, pas de couche de traduction, rien à installer.
Chaque extrait utilise glm-5.3 par défaut. Il a passé de vrais tests sous Claude Code et Codex CLI, appelle les outils de façon fiable et coûte peu par token de sortie. Remplacez-le par n'importe quel id une fois que tout fonctionne.
Claude Code
ANTHROPIC_BASE_URL="https://unbottled.ai/api/fr-FR" \
ANTHROPIC_AUTH_TOKEN="sk-unb-YOUR_KEY" \
ANTHROPIC_MODEL="glm-5.3" \
ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5.3" \
ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5.3" \
ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5.3-flash" \
CLAUDE_CODE_SUBAGENT_MODEL="glm-5.3" \
CLAUDE_CODE_MAX_CONTEXT_TOKENS="1048576" \
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1" \
claudeVoilà toute la réponse pour utiliser Claude Code avec d'autres modèles. ANTHROPIC_BASE_URL le fait pointer chez nous, ANTHROPIC_AUTH_TOKEN porte votre clé, et les variables de modèle décident de ce qui tourne. Remplacez l'id du modèle par n'importe quel id de GET /v1/models : GPT, Gemini, Kimi, DeepSeek ou un modèle non censuré. CLAUDE_CODE_MAX_CONTEXT_TOKENS est réglé sur la vraie fenêtre de contexte du modèle, pour que Claude Code compacte au bon moment.
Codex CLI
UNBOTTLED_API_KEY="sk-unb-YOUR_KEY" codex \
-c 'model_providers.unbottled={name="unbottled.ai",base_url="https://unbottled.ai/api/fr-FR/v1",env_key="UNBOTTLED_API_KEY",wire_api="responses"}' \
-c model_provider=unbottled \
-m glm-5.3Codex CLI reçoit un fournisseur de modèle personnalisé avec wire_api réglé sur responses. Il nous parle en Responses API exactement comme à OpenAI. Changez de modèle avec -m.
OpenCode, Continue, Aider et Cline fonctionnent aussi, tous testés. Leurs configurations, les fichiers de config permanents et les pièges que nous avons rencontrés sont dans le guide des outils de code.
Configurer tous les outils de codeQuel modèle pour quelle tâche
Tous les modèles ci-dessous prennent en charge les appels d'outils. Cliquez sur un nom pour voir son prix et ses specs, copiez l'id dans votre code.
Frontière : le code et le raisonnement les plus durs
Gros refactorings, codebases inconnues, longues chaînes de raisonnement. Prix par token plus élevé, moins de fausses pistes.
- Claude Sonnet 5.5claude-sonnet-5.5
- GPT-6.1 Solgpt-6.1-sol
- Gemini 4 Argongemini-4-argon
- Kimi K3.1 Prokimi-k3.1-pro
- DeepSeek V4 Prodeepseek-v4-pro
Bon marché et rapides : boucles, volume, appels de fond
Boucles d'agents qui envoient de gros prompts, traitements par lots, classification, les appels de fond que les outils de code lancent toute la journée. Une fraction des prix des modèles de pointe.
- GLM-5.3glm-5.3
- GLM-5.3 Flashglm-5.3-flash
- Qwen 3.8 Flashqwen-3.8-flash
- Claude Haiku 5.5claude-haiku-5.5
Non censurés : pas de refus réflexe
GLM 5.3 Uncensored et Qwen 3.6 Plus Uncensored sont des modèles grand public dont on a retiré les refus. UncensoredLM v1.2 est différent : entraîné sur des livres et des documents bannis de l'internet grand public, pas seulement un modèle débridé. Même API, mêmes outils.
- GLM 5.3 Uncensoredglm-5.3-uncensored
- Qwen 3.6 Plus Uncensoredqwen-3.6-plus-uncensored
- UncensoredLM v1.2uncensored-lm-v1.2
Vous hésitez entre deux ? Les pages de comparaison mettent deux modèles côte à côte.
Ce que ça coûte
Des crédits, facturés au token. Aucuns frais par siège.
- La plupart des modèles sont facturés à leur prix par token affiché, plus notre marge. Les tokens d'entrée en cache sont facturés au prix cache du modèle. Les modèles servis via OpenRouter sont facturés au coût réel qu'OpenRouter a facturé pour l'appel, plus la même marge.
- Chaque réponse indique usage.credits_charged. Vous n'avez jamais à deviner ce qu'un appel a coûté.
- Avant qu'un appel ne parte, votre solde est comparé à une estimation du pire cas. S'il ne suffit pas, vous recevez HTTP 402 insufficient_credits : rien ne s'exécute, rien n'est facturé.
- Streaming : fermez la connexion et la génération s'arrête. Vous ne payez que ce qui a tourné. Pareil si le fournisseur lâche en plein stream.
- Le chat et l'API sont facturés de la même manière. OpenRouter répartit un modèle sur plusieurs hébergeurs, et certains sont plus chers que le moins cher que nous affichons. Pour ces modèles, le prix affiché est donc une estimation, et usage.credits_charged donne le vrai chiffre. Si OpenRouter ne remonte aucun coût pour un appel, il est facturé au prix affiché.
- Les médias se facturent de la même façon : le coût réel du fournisseur plus notre marge quand il le communique, sinon le prix listé du modèle. Images à l'unité, voix au caractère, transcription à la seconde d'audio, vidéo et musique une fois le fichier prêt.
- Le même solde de crédits que l'application de chat. L'API elle-même demande un compte payant : n'importe quelle formule. Les crédits gratuits ne la débloquent pas.
- Formules mensuelles : quatre tailles, dès 800 crédits pour €8.
- Packs de crédits : une recharge pour les abonnés, 500 crédits pour €5. Ils n'expirent jamais. Carte, PayPal ou crypto.
En direct, via un routeur ou chez nous ?
Trois options honnêtes. Chacune est la bonne pour quelqu'un.
En direct chez OpenAI, Anthropic ou Google
Les nouveautés maison y arrivent en premier. Pas de marge d'intermédiaire. Les conditions d'un seul fournisseur à lire. Si vous n'utilisez que les modèles d'un seul fournisseur, allez en direct.
Un agrégateur comme OpenRouter
Beaucoup de modèles, paiement à l'usage. En toute transparence : une bonne partie de nos modèles est servie via OpenRouter. Si le simple routage vous suffit, allez-y.
unbottled.ai
Une clé pour trois formats : chat completions, Responses et Anthropic Messages avec count_tokens. Claude Code et Codex CLI se connectent sans proxy. Les modèles non censurés côtoient les modèles grand public, derrière une confirmation 18+ unique. Le même solde paie l'application de chat et l'API, en crédits d'abonnement ou en packs. Et unbottled.ai est open source et auto-hébergeable.
Les limites à connaître
Pas de surprise en production. Voici les arêtes vives.
- Sans état. La Responses API tourne avec store à false et refuse previous_response_id. Envoyez l'historique complet à chaque tour. Cela vaut pour tous les endpoints.
- La sortie est plafonnée à 32768 tokens par requête.
- 60 requêtes par minute et par clé par défaut. Au-delà, vous recevez un 429 avec un en-tête Retry-After. Les agents qui multiplient les appels méritent leur propre clé.
- count_tokens est une estimation, pas le tokenizer exact du fournisseur. Parfait pour dimensionner le contexte, pas pour les calculs de facturation.
- Les appels d'outils ne fonctionnent qu'avec les modèles qui les prennent en charge. Sinon, vous recevez 400 tools_not_supported. GET /v1/models indique supports_tools pour chaque modèle.
- Les modèles non censurés demandent une confirmation 18+ unique sur la page des clés d'API. Sans elle, vous recevez 403 uncensored_consent_required, et rien n'est facturé.
Ce que deviennent vos prompts
En bref : nous gardons la facture, pas la conversation.
- L'API n'enregistre aucune conversation et ne crée aucun fil. Ce qui reste chez nous, c'est la ligne de facturation : quel modèle, combien de crédits.
- Votre prompt part chez le fournisseur qui sert le modèle. Ses conditions s'appliquent à ce qu'il reçoit.
- Dans l'application de chat, les discussions incognito vivent uniquement dans le stockage local de votre navigateur, pas sur nos serveurs.
FAQ
unbottled.ai est-il une alternative à OpenRouter ?
Pour beaucoup d'usages, oui : une clé, beaucoup de modèles, paiement au token. Les différences : unbottled.ai parle nativement l'Anthropic Messages API et la Responses API d'OpenAI, pas seulement les chat completions. Il propose des modèles non censurés. Et l'application de chat tourne sur le même solde. Une bonne partie de nos modèles passe par OpenRouter en coulisses.
Puis-je utiliser Claude Code avec des modèles autres que Claude ?
Oui. Réglez ANTHROPIC_BASE_URL sur l'URL de base Anthropic de unbottled.ai, mettez votre clé dans ANTHROPIC_AUTH_TOKEN et choisissez n'importe quel id de modèle dans GET /v1/models. GPT, Gemini, GLM, Kimi, DeepSeek et les modèles non censurés tournent tous dans Claude Code de cette façon.
Ai-je besoin d'un nouveau SDK ?
Non. Utilisez les SDK officiels OpenAI et Anthropic. Changez l'URL de base et la clé. Rien d'autre.
Existe-t-il une offre gratuite pour l'API ?
Non. L'application de chat offre des crédits gratuits, l'API non. Elle demande une formule, dès 800 crédits par mois pour €8. Les abonnés rechargent avec des packs de crédits (500 crédits pour €5) qui n'expirent jamais.
Le prix affiché est-il celui que je paie ?
Pour la plupart des modèles, oui : prix par token affiché plus notre marge. Les modèles servis via OpenRouter sont facturés au coût réel qu'OpenRouter a facturé pour l'appel, plus la même marge, dans l'application de chat comme sur l'API. Leur prix affiché est une estimation. Chaque réponse indique le montant exact dans usage.credits_charged.
Quels modèles puis-je appeler ?
126 modèles de chat à ce jour : Claude, GPT, Gemini, DeepSeek, Kimi, GLM, Qwen et des modèles non censurés. Plus 85 modèles d'image, de vidéo, de musique, de voix et de transcription. GET /v1/models liste exactement ce que votre clé peut appeler, avec les prix.
unbottled.ai stocke-t-il mes prompts ?
Pas via l'API. Aucune conversation n'est stockée, seulement la ligne de facturation : modèle et crédits débités. Le fournisseur qui sert le modèle voit bien le prompt, selon ses propres conditions.
Une clé. Tous les modèles. Lancez-vous.
Créez une clé, changez une URL de base, gardez votre SDK. La documentation de l'API couvre chaque endpoint, chaque champ et chaque code d'erreur.