Docs | Zyloo

Schritt 1

Schnellstart

Zyloo spricht die OpenAI-API wortwörtlich. Wenn Ihr Code mit api.openai.com kommuniziert, leiten Sie ihn auf unsere Basis-URL um — fertig.

Basis-URLs

Agentische CLIs — Claude Code, opencode und Co. — zeigen auf https://api.zyloo.io. Clients im OpenAI-Stil und Editoren wie Cursor verwenden https://api.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://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"}]
  }'

Sie nutzen ein agentisches Coding-CLI? Setzen Sie dessen Basis-URL auf https://api.zyloo.io und Ihren Zyloo-Schlüssel, dann starten Sie wie gewohnt.

bash

# 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_KEY

Integrationen

Die fünf großen Coding-CLIs

Alle populären Terminal-Agents sprechen das OpenAI- oder Anthropic-Format und laufen daher mit einem Zyloo-Key — kopiere den Block für dein Tool und setze ein beliebiges Modell aus dem Preisindex ein.

Claude Code · Anthropic

Anthropics Terminal-Agent. Richte seine Anthropic-Variablen auf das Gateway.

bash

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

claude

Codex CLI · OpenAI

OpenAIs Open-Source-CLI. Registriere Zyloo als Provider in der config.toml.

bash

npm install -g @openai/codex
export ZYLOO_KEY=sk-zy-...

toml

# ~/.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"

opencode · open source

Der modellagnostische Open-Source-Favorit. Füge Zyloo als eigenen Provider in opencode.json hinzu.

bash

npm install -g opencode-ai
export ZYLOO_KEY=sk-zy-...

json

// 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": {}
      }
    }
  }
}

Aider · open source

Der git-native Pair-Programmer. Nutzt die üblichen OpenAI-kompatiblen Variablen.

bash

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

Qwen Code · Alibaba

Alibabas Coding-Agent. Liest OPENAI_*-Variablen — mehr ist nicht nötig.

bash

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

qwen

Sicherheit

Authentifizierung

Jede Anfrage muss ein Bearer-Token im Header Authorization enthalten. Schlüssel sind pro Projekt gescopet und können sofort im Dashboard widerrufen werden.

http

Authorization: Bearer sk-zy-9f3a0e5b...

Für die lokale Entwicklung empfehlen wir, den Schlüssel in einer .env-Datei zu speichern und über Ihre Laufzeitumgebung zu laden — committen Sie Schlüssel niemals in die Versionsverwaltung.

Katalog

Modelle

Referenzieren Sie jedes Modell über seine kanonische Zyloo-ID. Jede ID steht im Namensraum zyloo/..., damit sie über Anbieter hinweg eindeutig ist. Die vollständige Liste der 103 Modelle finden Sie auf der Modelle-Seite.

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://api.zyloo.io/v1/models \
  -H "Authorization: Bearer $ZYLOO_KEY"

Tipp

Modelle mit erweitertem Reasoning enden auf -thinking — zum Beispiel zyloo/claude-opus-4-7-thinking oder zyloo/gpt-5.5-xhigh.

Endpunkt

Chat-Completions

Dieselbe JSON-Struktur wie OpenAIs /v1/chat/completions. Tools, JSON-Modus, Vision und strukturierte Ausgaben werden auf jedem kompatiblen Modell unterstützt.

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);

Endpunkt

Bildgenerierung

Bildmodelle generieren Bilder aus einem Text-Prompt unter /v1/images/generations — dieselbe Anfrage- und Antwortstruktur wie bei OpenAIs Images API. Bildmodelle werden pro Bild abgerechnet, nicht pro Token, und erscheinen auf der Modelle-Seite mit einem Preis pro Bild.

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);

bash

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
  }'

So funktioniert die Bild-Abrechnung

Jede Anfrage wird mit Preis pro Bild × Anzahl gelieferter Bilder berechnet. `n` legt fest, wie viele Bilder generiert werden (1–4, Standard 1).
Berechnet werden nur tatsächlich gelieferte Bilder: Wenn der Anbieter fehlschlägt, das Zeitlimit überschreitet oder einen Fehler zurückgibt, wird die Reservierung automatisch wieder Ihrem Guthaben gutgeschrieben.

Modelle, die als bearbeitungsfähig gekennzeichnet sind, akzeptieren außerdem POST /v1/images/edits mit einem multipart-Formular-Body (Ausgangsbild + Prompt) zum selben Preis pro Bild. Modelle ohne diese Kennzeichnung geben auf diesem Endpunkt einen 400 zurück.

bash

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"

Echtzeit

Streaming

Übergeben Sie stream: true, um Server-Sent Events im selben Delta-Format wie bei OpenAI zu erhalten.

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

Zuverlässigkeit

Fehler

Zyloo gibt OpenAI-kompatible Fehlerobjekte zurück. Häufige Codes:

Code	Bedeutung	Maßnahme
401	Ungültiger Schlüssel	Im Dashboard rotieren
402	Unzureichendes Guthaben	Wallet aufladen
429	Rate-Limit erreicht	Backoff — wir routen zu einem Schwester-Anbieter
5xx	Upstream-Fehler	Automatischer Retry mit Idempotency-Key

Bereit zum Ausliefern?

Holen Sie sich einen Schlüssel und senden Sie in unter einer Minute Traffic.

API-Schlüssel holen

Dokumentation.

Schnellstart

Die fünf großen Coding-CLIs

Authentifizierung

Modelle

Chat-Completions

Bildgenerierung

Streaming

Fehler

Bereit zum Ausliefern?