Zyloozyloo.
Referensi

Dokumentasi.

Semua yang Anda butuhkan untuk merilis dengan Zyloo — dari permintaan pertama hingga perutean dan observabilitas tingkat produksi.

Langkah 1

Mulai cepat

Zyloo berbicara dengan API OpenAI persis sama. Jika kode Anda berkomunikasi dengan api.openai.com, alihkan ke base URL kami dan selesai.

Base URL

CLI agentik — Claude Code, opencode, dan sejenisnya — arahkan ke https://api.zyloo.io. Klien gaya OpenAI dan editor seperti Cursor menggunakan 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"}]
  }'

Menggunakan CLI coding agentik? Atur base URL-nya ke https://api.zyloo.io dan kunci Zyloo Anda, lalu jalankan seperti biasa.

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
Integrasi

5 CLI coding terpopuler

Semua agent terminal populer memakai format OpenAI atau Anthropic, jadi semuanya jalan dengan satu key Zyloo — salin blok untuk tool kamu dan pakai model apa pun dari indeks harga.

Claude Code · Anthropic

Agent terminal dari Anthropic. Arahkan variabel format Anthropic ke 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

CLI open source dari OpenAI. Daftarkan Zyloo sebagai provider di 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

Favorit open source yang model-agnostic. Tambahkan Zyloo sebagai provider kustom di opencode.json.

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
Aider · open source

Pair programmer berbasis git. Memakai variabel OpenAI-compatible standar.

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

Agent coding dari Alibaba. Membaca variabel OPENAI_* — tanpa konfigurasi tambahan.

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
Keamanan

Autentikasi

Setiap permintaan harus menyertakan bearer token di header Authorization. Kunci dicakup per proyek dan dapat dicabut secara instan dari dasbor.

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

Untuk pengembangan lokal kami sarankan menyimpan kunci di file .env dan memuatnya melalui runtime Anda — jangan pernah commit kunci ke kontrol sumber.

Katalog

Model

Rujuk model mana pun dengan id kanonik Zyloo-nya. Setiap id diberi namespace di bawah zyloo/... sehingga tidak ambigu antar penyedia. Daftar lengkap 93 model ada di halaman Model.

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

Model dengan penalaran lanjutan diakhiri dengan -thinking — misalnya zyloo/claude-opus-4-7-thinking atau zyloo/gpt-5.5-xhigh.

Endpoint

Chat completion

Bentuk JSON yang sama dengan /v1/chat/completions milik OpenAI. Alat, mode JSON, visi, dan output terstruktur didukung di setiap model yang kompatibel.

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

Pembuatan gambar

Model gambar menghasilkan gambar dari prompt teks di /v1/images/generations — bentuk permintaan dan respons yang sama dengan Images API milik OpenAI. Model gambar ditagih per gambar, bukan per token, dan muncul di halaman Model dengan harga per-gambar.

ts
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
  }'
Cara kerja penagihan gambar
  • Setiap permintaan ditagih harga-per-gambar × jumlah gambar yang terkirim. `n` menentukan berapa banyak gambar yang dihasilkan (1–4, default 1).
  • Anda hanya ditagih untuk gambar yang benar-benar terkirim: jika penyedia gagal, kehabisan waktu, atau mengembalikan error, dana yang ditahan dilepaskan kembali ke saldo Anda secara otomatis.

Model yang ditandai mendukung edit juga menerima POST /v1/images/edits dengan body form multipart (gambar sumber + prompt) dengan harga per-gambar yang sama. Model tanpa penanda tersebut mengembalikan 400 pada endpoint itu.

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"
Real-time

Streaming

Tambahkan stream: true untuk menerima Server-Sent Events dengan format delta yang sama seperti 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 ?? "");
}
Keandalan

Error

Zyloo mengembalikan objek error yang kompatibel-OpenAI. Kode umum:

KodeArtiTindakan
401Kunci tidak validRotasi dari dasbor
402Kredit tidak cukupIsi ulang dompet
429Dibatasi lajuBackoff, kami rutekan ke penyedia serupa
5xxKegagalan upstreamCoba ulang otomatis dengan idempotency-key

Siap merilis?

Ambil kunci dan mulai mengirim traffic dalam waktu kurang dari semenit.

Dapatkan kunci API