Zyloozyloo
Справочник

Документация.

Всё необходимое для запуска с Zyloo — от первого запроса до маршрутизации и наблюдаемости промышленного уровня.

Шаг 1

Быстрый старт

Zyloo точно повторяет OpenAI API. Если ваш код обращается к api.openai.com, перенаправьте его на наш базовый URL — и готово.

Базовые URL

Агентные CLI — Claude Code, opencode и подобные — указывают на https://zyloo.io. OpenAI-клиенты и редакторы вроде Cursor используют 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"}]
  }'

Используете агентный CLI для кодинга? Задайте его базовый URL на https://zyloo.io и ваш ключ Zyloo, затем запускайте как обычно.

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
Безопасность

Аутентификация

Каждый запрос должен содержать bearer-токен в заголовке Authorization. Ключи привязаны к проекту и могут быть мгновенно отозваны из панели.

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

Для локальной разработки рекомендуем хранить ключ в файле .env и загружать его через ваш рантайм — никогда не коммитьте ключи в систему контроля версий.

Каталог

Модели

Обращайтесь к любой модели по её каноническому id Zyloo. Каждый id находится в пространстве имён zyloo/..., поэтому он однозначен между провайдерами. Полный список из 21 моделей — на странице моделей.

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"
Совет

Модели с расширенным рассуждением оканчиваются на -thinking — например zyloo/claude-opus-4-7-thinking или zyloo/gpt-5.5-xhigh.

Эндпоинт

Chat completions

Тот же формат JSON, что у OpenAI /v1/chat/completions. Инструменты, режим JSON, зрение и структурированный вывод поддерживаются на каждой совместимой модели.

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);
Реальное время

Стриминг

Передайте stream: true, чтобы получать Server-Sent Events в том же формате дельт, что и 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 ?? "");
}
Надёжность

Ошибки

Zyloo возвращает OpenAI-совместимые объекты ошибок. Частые коды:

КодЗначениеДействие
401Неверный ключСменить в панели
402Недостаточно кредитаПополнить баланс
429Превышен лимитБэкофф, мы направим к соседнему провайдеру
5xxСбой апстримаАвтоповтор с idempotency-key

Готовы запускаться?

Получите ключ и начните отправлять трафик менее чем за минуту.

Получить API-ключ