Démarrage rapide
Zyloo parle l'API OpenAI mot pour mot. Si votre code dialogue avec api.openai.com, redirigez-le vers notre URL de base et c'est terminé.
Les CLI agentiques — Claude Code, opencode et compagnie — pointent vers https://api.zyloo.io. Les clients de style OpenAI et les éditeurs comme Cursor utilisent https://api.zyloo.io/v1.
# 1. Install the official SDK (any language)
npm install openai
# 2. Get your key from https://zyloo.io/dashboard
export ZYLOO_KEY=sk-zy-...
# 3. Make your first call
curl https://api.zyloo.io/v1/chat/completions \
-H "Authorization: Bearer $ZYLOO_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "zyloo/claude-opus-4-7",
"messages": [{"role": "user", "content": "Hello"}]
}'Vous utilisez un CLI de codage agentique ? Réglez son URL de base sur https://api.zyloo.io et votre clé Zyloo, puis lancez comme d'habitude.
# Claude Code, opencode, and other agentic CLIs
export ANTHROPIC_BASE_URL=https://api.zyloo.io
export ANTHROPIC_API_KEY=$ZYLOO_KEY
# Cursor and other OpenAI-compatible editors
# Base URL: https://api.zyloo.io/v1
# API key: $ZYLOO_KEYLes cinq grands CLI de code
Tous les agents de terminal populaires parlent le format OpenAI ou Anthropic : ils fonctionnent donc avec une clé Zyloo — copiez le bloc de votre outil et insérez n'importe quel modèle de l'index des prix.
L'agent terminal d'Anthropic. Pointez ses variables au format Anthropic vers la passerelle.
npm install -g @anthropic-ai/claude-code
export ANTHROPIC_BASE_URL=https://api.zyloo.io
export ANTHROPIC_API_KEY=$ZYLOO_KEY
export ANTHROPIC_MODEL=zyloo/claude-opus-4-7-thinking
claudeLe CLI open source d'OpenAI. Déclarez Zyloo comme provider dans config.toml.
npm install -g @openai/codex
export ZYLOO_KEY=sk-zy-...# ~/.codex/config.toml
model = "zyloo/gpt-5.5"
model_provider = "zyloo"
[model_providers.zyloo]
name = "Zyloo"
base_url = "https://api.zyloo.io/v1"
env_key = "ZYLOO_KEY"
wire_api = "chat"Le favori open source agnostique. Ajoutez Zyloo comme provider personnalisé dans opencode.json.
npm install -g opencode-ai
export ZYLOO_KEY=sk-zy-...// opencode.json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"zyloo": {
"npm": "@ai-sdk/openai-compatible",
"name": "Zyloo",
"options": {
"baseURL": "https://api.zyloo.io/v1",
"apiKey": "{env:ZYLOO_KEY}"
},
"models": {
"zyloo/claude-opus-4-7": {},
"zyloo/gpt-5.5": {}
}
}
}
}Le binôme de programmation natif git. Utilise les variables OpenAI compatibles standard.
python -m pip install aider-install && aider-install
export OPENAI_API_BASE=https://api.zyloo.io/v1
export OPENAI_API_KEY=$ZYLOO_KEY
aider --model openai/zyloo/claude-opus-4-7L'agent de code d'Alibaba. Lit les variables OPENAI_* — rien d'autre à configurer.
npm install -g @qwen-code/qwen-code
export OPENAI_BASE_URL=https://api.zyloo.io/v1
export OPENAI_API_KEY=$ZYLOO_KEY
export OPENAI_MODEL=zyloo/deepseek-v4-pro
qwenAuthentification
Chaque requête doit inclure un jeton bearer dans l'en-tête Authorization. Les clés sont délimitées par projet et peuvent être révoquées instantanément depuis le tableau de bord.
Authorization: Bearer sk-zy-9f3a0e5b...Pour le développement local, nous recommandons de stocker la clé dans un fichier .env et de la charger via votre runtime — ne committez jamais les clés dans le contrôle de version.
Modèles
Référencez n'importe quel modèle par son id Zyloo canonique. Chaque id est sous l'espace de noms zyloo/... pour qu'il soit sans ambiguïté entre fournisseurs. La liste complète des 97 modèles se trouve sur la page Modèles.
# A few examples — see /dashboard/models for the full list
zyloo/claude-opus-4-7-thinking
zyloo/claude-opus-4-7
zyloo/gpt-5.5
zyloo/gemini-3.5-flash
zyloo/deepseek-v4-pro
zyloo/grok-4.3curl https://api.zyloo.io/v1/models \
-H "Authorization: Bearer $ZYLOO_KEY"Les modèles à raisonnement étendu se terminent par -thinking — par exemple zyloo/claude-opus-4-7-thinking ou zyloo/gpt-5.5-xhigh.
Complétions de chat
La même structure JSON que le /v1/chat/completions d'OpenAI. Outils, mode JSON, vision et sorties structurées sont pris en charge sur chaque modèle compatible.
import OpenAI from "openai";
const zyloo = new OpenAI({
apiKey: process.env.ZYLOO_KEY,
baseURL: "https://api.zyloo.io/v1",
});
const res = await zyloo.chat.completions.create({
model: "zyloo/gemini-3.5-flash",
messages: [
{ role: "system", content: "You are concise." },
{ role: "user", content: "Summarize this PR..." },
],
temperature: 0.2,
max_tokens: 512,
});
console.log(res.choices[0].message.content);Génération d'images
Les modèles d'image génèrent des visuels à partir d'un prompt texte via /v1/images/generations — la même structure de requête et de réponse que l'API Images d'OpenAI. Les modèles d'image sont facturés par image, et non par token, et apparaissent sur la page Modèles avec un prix par image.
const image = await zyloo.images.generate({
model: "zyloo/your-image-model", // any model marked "Image" on /models
prompt: "A watercolor lighthouse at dawn",
n: 1, // 1–4 images per request
size: "1024x1024",
});
console.log(image.data[0].url ?? image.data[0].b64_json);curl https://api.zyloo.io/v1/images/generations \
-H "Authorization: Bearer $ZYLOO_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "zyloo/your-image-model",
"prompt": "A watercolor lighthouse at dawn",
"n": 1
}'- Chaque requête est facturée prix par image × nombre d'images livrées. `n` définit combien d'images générer (1–4, 1 par défaut).
- Vous n'êtes facturé que pour les images réellement livrées : si le fournisseur échoue, expire ou renvoie une erreur, le montant réservé est automatiquement recrédité sur votre solde.
Les modèles marqués comme prenant en charge l'édition acceptent aussi POST /v1/images/edits avec un corps multipart (image source + prompt) au même prix par image. Les modèles sans ce marqueur renvoient une erreur 400 sur ce point d'accès.
curl https://api.zyloo.io/v1/images/edits \
-H "Authorization: Bearer $ZYLOO_KEY" \
-F "model=zyloo/your-image-model" \
-F "image=@photo.png" \
-F "prompt=Add a red scarf" \
-F "n=1"Streaming
Passez stream: true pour recevoir des Server-Sent Events au même format delta qu'OpenAI.
const stream = await zyloo.chat.completions.create({
model: "zyloo/claude-opus-4-7",
stream: true,
messages: [{ role: "user", content: "Tell me a story" }],
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}Erreurs
Zyloo renvoie des objets d'erreur compatibles OpenAI. Codes courants :
| Code | Signification | Action |
|---|---|---|
| 401 | Clé invalide | Faites-la tourner depuis le tableau de bord |
| 402 | Crédit insuffisant | Rechargez le portefeuille |
| 429 | Débit limité | Backoff, nous routons vers un fournisseur frère |
| 5xx | Échec amont | Réessai auto avec idempotency-key |
Prêt à livrer ?
Prenez une clé et commencez à envoyer du trafic en moins d'une minute.
Obtenir une clé API