Référence

Documentation.

Tout ce qu'il vous faut pour livrer avec Zyloo — de votre première requête au routage et à l'observabilité de niveau production.

Étape 1

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é.

URL de base

Les CLI agentiques — Claude Code, opencode et compagnie — pointent vers https://zyloo.io. Les clients de style OpenAI et les éditeurs comme Cursor utilisent https://zyloo.io/v1.

bash
# 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://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://zyloo.io et votre clé Zyloo, puis lancez comme d'habitude.

bash
# Claude Code, opencode, and other agentic CLIs
export ANTHROPIC_BASE_URL=https://zyloo.io
export ANTHROPIC_API_KEY=$ZYLOO_KEY

# Cursor and other OpenAI-compatible editors
#   Base URL:  https://zyloo.io/v1
#   API key:   $ZYLOO_KEY
Sécurité

Authentification

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.

http
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.

Catalogue

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 21 modèles se trouve sur la page Modèles.

bash
# 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.3
bash
curl https://zyloo.io/v1/models \
  -H "Authorization: Bearer $ZYLOO_KEY"
Astuce

Les modèles à raisonnement étendu se terminent par -thinking — par exemple zyloo/claude-opus-4-7-thinking ou zyloo/gpt-5.5-xhigh.

Point d'accès

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.

ts
import OpenAI from "openai";

const zyloo = new OpenAI({
  apiKey: process.env.ZYLOO_KEY,
  baseURL: "https://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);
Temps réel

Streaming

Passez stream: true pour recevoir des Server-Sent Events au même format delta qu'OpenAI.

ts
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 ?? "");
}
Fiabilité

Erreurs

Zyloo renvoie des objets d'erreur compatibles OpenAI. Codes courants :

CodeSignificationAction
401Clé invalideFaites-la tourner depuis le tableau de bord
402Crédit insuffisantRechargez le portefeuille
429Débit limitéBackoff, nous routons vers un fournisseur frère
5xxÉchec amontRé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