Name: Zyloo Unified AI API
Brand: Zyloo
Availability: InStock

Шаг 1

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

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

Базовые URL

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

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

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

Интеграции

Пять главных CLI для кода

Все популярные терминальные агенты говорят на формате OpenAI или Anthropic, поэтому работают с ключом Zyloo — скопируйте блок для своего инструмента и подставьте любую модель из прайс-листа.

Claude Code · Anthropic

Терминальный агент Anthropic. Направьте его переменные формата Anthropic на шлюз.

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

Open-source CLI от OpenAI. Зарегистрируйте Zyloo как провайдера в 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

Открытый и независимый от провайдеров фаворит. Добавьте Zyloo как провайдера в 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 · open source

Парный программист с интеграцией в git. Использует стандартные OpenAI-переменные.

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

Кодинг-агент от Alibaba. Читает переменные OPENAI_* — больше ничего настраивать не нужно.

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

Безопасность

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

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

http

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

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

Каталог

Модели

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

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"

Совет

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

Эндпоинт

Chat completions

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

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

Эндпоинт

Генерация изображений

Модели изображений генерируют картинки по текстовому промпту через /v1/images/generations — тот же формат запроса и ответа, что у Images API OpenAI. Модели изображений тарифицируются за изображение, а не за токены, и отображаются на странице моделей с ценой за изображение.

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

Как работает оплата изображений

Каждый запрос оплачивается как цена за изображение × число доставленных изображений. `n` задаёт, сколько изображений сгенерировать (1–4, по умолчанию 1).
Списываются только фактически доставленные изображения: если провайдер даёт сбой, превышает тайм-аут или возвращает ошибку, резерв автоматически возвращается на ваш баланс.

Модели с поддержкой редактирования также принимают POST /v1/images/edits с телом multipart form (исходное изображение + промпт) по той же цене за изображение. Модели без этого флага возвращают 400 на этом эндпоинте.

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"

Реальное время

Стриминг

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

Надёжность

Ошибки

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

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

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

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

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

# 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"}] }'

# 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

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

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

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

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

Код

Значение

Действие

401

Неверный ключ

Сменить в панели

402

Недостаточно кредита

Пополнить баланс

429

Превышен лимит

Бэкофф, мы направим к соседнему провайдеру

5xx

Сбой апстрима

Автоповтор с idempotency-key

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

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

Пять главных CLI для кода

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

Модели

Chat completions

Генерация изображений

Стриминг

Ошибки

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

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

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

Пять главных CLI для кода

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

Модели

Chat completions

Генерация изображений

Стриминг

Ошибки

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