Référence API et configuration
Une seule clé API ck_ fonctionne avec Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor et HTTP direct. Tarifs publics officiels des fournisseurs sur une seule facture — paiement à l'usage, sans abonnement requis.
1. Démarrage
Zenn.Engineering est une passerelle API prête à l'emploi pour les modèles Anthropic, OpenAI et Google AI, ainsi que la génération d'images. Vous utilisez une seule clé préfixée ck_ partout — aucune modification de code, il suffit de pointer votre outil vers notre URL de base.
Choisissez un forfait sur /pricing, puis créez une clé sur /manage-api-keys.
Pointez votre outil vers https://zenn.engineering/api/v1.
Fonctionne avec Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor et tout client compatible OpenAI/Anthropic.
2. URLs de base
Une clé, trois URLs de base compatibles avec différents protocoles (Anthropic / OpenAI / Gemini), plus un endpoint de génération d'images.
| Surface | URL de base | À utiliser avec |
|---|---|---|
| Compatible Anthropic | https://zenn.engineering/api/v1 | Claude Code, SDK Anthropic, OpenCode (fournisseur anthropic) |
| Compatible OpenAI (Codex) | https://zenn.engineering/api/v1/codex | Codex CLI, SDK OpenAI, Cursor |
| Compatible Gemini | https://zenn.engineering/api/v1/gemini | Gemini CLI, SDK Google AI |
| Génération d'images | https://zenn.engineering/api/v1/images/generations | gpt-image-2 (charge utile compatible OpenAI) |
3. Claude Code
Le CLI officiel d'Anthropic pour Claude. Définissez deux variables d'environnement et il fonctionne en remplacement direct.
Étape 1 — Définir l'environnement
Ajoutez à votre profil shell (~/.zshrc ou ~/.bashrc) :
export ANTHROPIC_BASE_URL=https://zenn.engineering/api/v1 export ANTHROPIC_API_KEY=ck_YOUR_API_KEY
Étape 2 — Redémarrer et exécuter
# Default model (Sonnet 4.6) claude # Pick a different model claude --model claude-opus-4-7 claude --model claude-haiku-4-5
Comment ça fonctionne
Claude Code envoie la clé API via l'en-tête x-api-key (natif au SDK Anthropic) et ajoute /messages à l'URL de base. Les en-têtes anthropic-version et anthropic-beta sont transmis en amont. Le streaming est pris en charge via SSE.
4. OpenCode
Agent de codage IA multi-fournisseurs. Une seule configuration JSON vous donne accès à Claude, GPT-5 et Gemini via une clé unique.
Étape 1 — Installer
npm i -g opencode-ai
Étape 2 — Créer la configuration
Modifiez ~/.config/opencode/opencode.json :
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"anthropic": {
"options": {
"baseURL": "https://zenn.engineering/api/v1",
"apiKey": "ck_YOUR_API_KEY"
},
"models": {
"claude-opus-4-7": { "name": "Claude Opus 4.7" },
"claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" },
"claude-haiku-4-5": { "name": "Claude Haiku 4.5" }
}
},
"zenn-codex": {
"npm": "@ai-sdk/openai-compatible",
"name": "Zenn Codex",
"options": {
"baseURL": "https://zenn.engineering/api/v1/codex",
"apiKey": "ck_YOUR_API_KEY"
},
"models": {
"gpt-5.5": { "name": "GPT-5.5" },
"gpt-5.5-pro": { "name": "GPT-5.5 Pro" },
"gpt-5.5-instant": { "name": "GPT-5.5 Instant" },
"gpt-5.4": { "name": "GPT-5.4" },
"gpt-5.3-codex": { "name": "GPT-5.3 Codex" }
}
},
"zenn-gemini": {
"npm": "@ai-sdk/openai-compatible",
"name": "Zenn Gemini",
"options": {
"baseURL": "https://zenn.engineering/api/v1/gemini",
"apiKey": "ck_YOUR_API_KEY"
},
"models": {
"gemini-3.1-pro-preview": { "name": "Gemini 3.1 Pro" },
"gemini-3-pro-preview": { "name": "Gemini 3 Pro" },
"gemini-3-flash-preview": { "name": "Gemini 3 Flash" }
}
},
"zenn-chinese": {
"npm": "@ai-sdk/openai-compatible",
"name": "Zenn Chinese (DeepSeek / Moonshot / Zhipu)",
"options": {
"baseURL": "https://zenn.engineering/api/v1/codex",
"apiKey": "ck_YOUR_API_KEY"
},
"models": {
"deepseek-v4-pro": { "name": "DeepSeek V4 Pro" },
"deepseek-v4-flash": { "name": "DeepSeek V4 Flash" },
"kimi-k2.6": { "name": "Kimi K2.6" },
"glm-5.1": { "name": "GLM-5.1" }
}
}
}
}Étape 3 — Exécuter
opencode
5. Codex CLI
Le CLI officiel d'OpenAI pour la famille GPT-5 / Codex. Définissez deux variables d'environnement et pointez vers notre URL de base Codex.
Définir l'environnement
export OPENAI_BASE_URL=https://zenn.engineering/api/v1/codex export OPENAI_API_KEY=ck_YOUR_API_KEY
Exécuter
# Default codex # Pick a model codex --model gpt-5.5 codex --model gpt-5.5-pro codex --model gpt-5.5-instant codex --model gpt-5.3-codex # Chinese coding models (via OpenAI-compatible /v1/codex) codex --model deepseek-v4-pro codex --model kimi-k2.6 codex --model glm-5.1
Codex CLI utilise Authorization: Bearer et la forme OpenAI /chat/completions + /responses — les deux sont prises en charge.
6. Gemini CLI
Le Gemini CLI de Google envoie la clé via x-goog-api-key. Le proxy accepte cet en-tête de manière transparente.
Définir l'environnement
export GEMINI_BASE_URL=https://zenn.engineering/api/v1/gemini export GEMINI_API_KEY=ck_YOUR_API_KEY
Exécuter
gemini --model gemini-3.1-pro-preview gemini --model gemini-3-flash-preview
7. IDE Cursor
Dans Cursor → Paramètres → Modèles → « Modèle OpenAI personnalisé » :
| Champ | Valeur |
|---|---|
| Remplacer l'URL de base OpenAI | https://zenn.engineering/api/v1/codex |
| Clé API OpenAI | ck_YOUR_API_KEY |
| Ajouter des modèles personnalisés | gpt-5.5, gpt-5.5-pro, gpt-5.5-instant, gpt-5.4, gpt-5.3-codex, deepseek-v4-pro, kimi-k2.6, glm-5.1 |
Cliquez sur Vérifier après avoir enregistré — Cursor appellera /models sur l'URL de base pour confirmer que la clé fonctionne.
8. API directe (cURL)
Trois formes de protocole, une seule clé. Choisissez celle que votre client utilise déjà.
Compatible Anthropic — /v1/messages
curl -X POST https://zenn.engineering/api/v1/messages \
-H "x-api-key: ck_YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello, Claude"}]
}'Compatible OpenAI — /v1/codex/chat/completions
curl -X POST https://zenn.engineering/api/v1/codex/chat/completions \
-H "Authorization: Bearer ck_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [{"role": "user", "content": "Hello, GPT-5.5"}],
"stream": true
}'Gemini — /v1/gemini/chat/completions
curl -X POST https://zenn.engineering/api/v1/gemini/chat/completions \
-H "Authorization: Bearer ck_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.1-pro-preview",
"messages": [{"role": "user", "content": "Hello, Gemini"}]
}'9. Génération d'images
gpt-image-2 est actuellement le seul modèle d'image accessible via l'API. Les paliers de résolution (1K / 2K / 4K) sont facturés à un tarif unique — voir Modèles pour plus de détails. D'autres modèles d'image, vidéo et audio sont indiqués comme Bientôt disponibles.
Endpoint
POST https://zenn.engineering/api/v1/images/generations GET https://zenn.engineering/api/v1/images/generations (list models)
Générer une image
curl -X POST https://zenn.engineering/api/v1/images/generations \
-H "Authorization: Bearer ck_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "A cinematic photo of a small red apple on a marble countertop",
"n": 1
}'Comportement asynchrone
DocsPage.imageGen.asyncBody
Dans le chat du navigateur
Ouvrez /chat, sélectionnez « GPT Image 2 — Image Generation » dans le sélecteur de modèle, envoyez une invite et l'image s'affiche en ligne. Le serveur interroge l'amont pour vous et facture 6 crédits (0,06 $) par image.
10. Modèles et tarifs
Facturation par crédits (1 000 000 crédits = 1,00 $). Les prix LLM sont ceux du tarif officiel des fournisseurs par million de tokens ; les images sont facturées à la génération. Les modèles marqués Bientôt disponible sont listés mais l'API les refuse jusqu'à activation. Chaque modèle est facturé au tarif officiel — la valeur vient du multiplicateur de crédits appliqué à la recharge (Pro 1×, Max 4×, Enterprise 6×). Voir la section 12 pour les détails des plans.
Claude (Anthropic)
| ID du modèle | Entrée / MTok | Sortie / MTok | Lecture cache | Statut |
|---|---|---|---|---|
| claude-opus-4-7 | $15.00 | $75.00 | $1.50 | En ligne |
| claude-opus-4-6 | $15.00 | $75.00 | $1.50 | En ligne |
| claude-sonnet-4-6 | $3.00 | $15.00 | $0.30 | En ligne |
| claude-haiku-4-5 | $1.00 | $5.00 | $0.10 | En ligne |
OpenAI / GPT
| ID du modèle | Entrée / MTok | Sortie / MTok | Lecture cache | Statut |
|---|---|---|---|---|
| gpt-5.5 | $5.00 | $30.00 | $0.50 | En ligne |
| gpt-5.5-instant | $5.00 | $30.00 | $0.50 | En ligne |
| gpt-5.5-pro | $30.00 | $180.00 | $30.00 | En ligne |
| gpt-5.4 | $5.00 | $22.50 | $0.50 | En ligne |
| gpt-5.3-codex | $1.75 | $14.00 | $0.17 | En ligne |
| gpt-5.2 | $1.75 | $14.00 | $0.17 | En ligne |
Gemini (Google)
| ID du modèle | Entrée / MTok | Sortie / MTok | Lecture cache | Statut |
|---|---|---|---|---|
| gemini-3.1-pro-preview | $4.00 | $18.00 | $0.40 | En ligne |
| gemini-3-pro-preview | $4.00 | $18.00 | $0.40 | En ligne |
| gemini-3-flash-preview | $0.50 | $3.00 | $0.05 | En ligne |
DeepSeek / Moonshot / Zhipu
| ID du modèle | Entrée / MTok | Sortie / MTok | Lecture cache | Statut |
|---|---|---|---|---|
| deepseek-v4-pro | $1.74 | $3.48 | $0.01 | En ligne |
| deepseek-v4-flash | $0.14 | $0.28 | $0.0028 | En ligne |
| kimi-k2.6 | $0.95 | $4.00 | $0.16 | En ligne |
| glm-5.1 | $1.40 | $4.40 | $0.26 | En ligne |
Image (en ligne)
| ID du modèle | Crédits / image | Prix / image | Statut |
|---|---|---|---|
| gpt-image-2 | 60000 | $0.06 | En ligne |
Tous les modèles d'image, vidéo et audio sont consommés au tarif public officiel. D'autres modèles d'image (famille Nano Banana, Gemini 3 Pro Image, Seedream) figurent au catalogue mais sont actuellement Bientôt disponibles — l'API les rejette tant qu'ils ne sont pas activés. Voir /models pour le catalogue complet.
11. Authentification
Toutes les clés API utilisent le préfixe ck_. Le proxy accepte tous les formats d'en-tête SDK standard, afin que les clients fonctionnent sans modification.
| En-tête | Format | Utilisé par |
|---|---|---|
| x-api-key | ck_... | Claude Code, SDK Anthropic |
| Authorization | Bearer ck_... | OpenCode, Codex CLI, SDK OpenAI, cURL |
| anthropic-api-key | ck_... | En-tête Anthropic alternatif |
| x-goog-api-key | ck_... | Gemini CLI |
En-têtes transmis
anthropic-version (par défaut 2023-06-01) et anthropic-beta sont transmis. Le streaming SSE est entièrement pris en charge.
12. Forfaits
Recharge unique — sans abonnement. Chaque recharge fixe un multiplicateur de crédits (Pro 1×, Max 4×, Enterprise 6×) — vos crédits conservent cette valeur jusqu'à dépense. Les recharges suivantes peuvent être de n'importe quel palier.
Tarif standard. Paiement à l'usage.
- · Tous les LLM de pointe au tarif public officiel
- · API compatible OpenAI / Anthropic / Gemini
- · Limites de dépense par clé, analyses en temps réel
4× crédits — 200 $ vous donnent 800 $ d'utilisation au tarif public.
- · Tout ce qui est inclus dans Pro
- · 4× crédits par dollar au moment de la recharge
- · Même tarif public sur chaque modèle
- · File prioritaire + routage plus rapide
6× crédits — 2 000 $ vous donnent 12 000 $ d'utilisation + canal prioritaire Anthropic Max.
- · Tout ce qui est inclus dans Max
- · 6× crédits par dollar au moment de la recharge
- · Même tarif public sur chaque modèle
- · Canal prioritaire Anthropic Max
- · Support dédié, facturation adaptée aux audits
Une règle tarifaire, tous les modèles
- · Chaque modèle LLM, image, vidéo et audio est consommé au tarif public officiel indiqué sur /models.
- · La valeur de Max (200 $ → 4×) et Enterprise (2 000 $ → 6×) provient des crédits supplémentaires accordés au moment de la recharge, et non de paliers de remise par modèle.
- · Pas d'éligibilité par palier, pas de petites lignes par modèle — vos crédits fonctionnent de la même façon sur Claude Opus, GPT-5.5 et Gemini Flash.
Les multiplicateurs s'appliquent par recharge. Les crédits Max existants conservent leur valeur 4× jusqu'à ce qu'ils soient dépensés — rechargez Pro ensuite et ces 20 $ donneront 20 M de crédits à 1×. Voir /pricing pour le détail complet.
13. Limites de débit et erreurs
Limites de débit par utilisateur
| Endpoint | Requêtes / heure |
|---|---|
| /v1/messages, /v1/chat/completions, /v1/gemini | 1,000 |
| /v1/images/generations | 500 |
| /v1/responses, /v1/codex/* | 1,000 |
Le statut de la limite de débit est retourné dans les en-têtes de réponse : x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset.
Codes d'erreur
| Statut | Signification |
|---|---|
| 401 | Clé API manquante / invalide |
| 402 | Crédits insuffisants — rechargez sur /checkout |
| 403 | Le palier ne débloque pas le modèle demandé (par ex. Opus 4.7) |
| 429 | Limite de débit par utilisateur atteinte |
| 503 | Modèle listé mais Bientôt disponible |
| 504 | Délai dépassé pour la génération d'image (réessayer) |
14. Bientôt disponible
Listés publiquement mais l'API les refuse jusqu'à ce que la marge sous le modèle de multiplicateur de crédits se stabilise :
Famille Nano Banana, Gemini 3 Pro Image, Seedream, GPT-4o Image, Imagen.
Veo 3.1, Kling 3.0, Seedance 2.0, HappyHorse 1.0, MiniMax Hailuo, Vidu Q3, WAN 2.6.
Fish Audio TTS, Voice Clone, ASR.
Voir la liste complète sur /models. Les entrées « bientôt disponibles » retournent HTTP 503 depuis l'API ; les appeler aujourd'hui est sans effet et ne facture aucun crédit.
Prêt à commencer ?
Une clé fonctionne avec Claude Code, OpenCode, Codex CLI, Gemini CLI et Cursor. Rechargez vos crédits et créez votre clé API.