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

Bước 1

Bắt đầu nhanh

Zyloo tương thích hoàn toàn với OpenAI API. Nếu code của bạn đang gọi api.openai.com, chỉ cần trỏ nó sang base URL của chúng tôi là xong.

Base URL

Các CLI agentic — Claude Code, opencode và tương tự — trỏ tới https://api.zyloo.io. Các client kiểu OpenAI và trình soạn thảo như Cursor dùng 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"}]
  }'

Dùng CLI lập trình agentic? Đặt base URL của nó thành https://api.zyloo.io cùng Zyloo key của bạn, rồi chạy như bình thường.

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

Bảo mật

Xác thực

Mọi request phải kèm bearer token trong header Authorization. Key được cấp theo từng dự án và có thể thu hồi ngay lập tức từ dashboard.

http

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

Khi phát triển cục bộ, chúng tôi khuyến nghị lưu key trong file .env và nạp qua runtime của bạn — tuyệt đối không commit key vào mã nguồn.

Danh mục

Model

Tham chiếu bất kỳ model nào bằng id Zyloo chuẩn của nó. Mọi id đều nằm trong namespace zyloo/... nên không bị nhầm lẫn giữa các nhà cung cấp. Danh sách đầy đủ 52 model có tại trang 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"

Mẹo

Các model có suy luận mở rộng kết thúc bằng -thinking — ví dụ zyloo/claude-opus-4-7-thinking hoặc zyloo/gpt-5.5-xhigh.

Endpoint

Chat completions

Cùng cấu trúc JSON như /v1/chat/completions của OpenAI. Tools, JSON mode, vision và structured outputs được hỗ trợ trên mọi model tương thích.

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

Tạo ảnh

Các model tạo ảnh sinh hình ảnh từ prompt văn bản tại /v1/images/generations — cùng cấu trúc request và response như Images API của OpenAI. Model tạo ảnh được tính phí theo ảnh, không theo token, và hiển thị trên trang Model với giá mỗi ảnh.

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

Cách tính phí tạo ảnh

Mỗi request được tính phí bằng giá-mỗi-ảnh × số ảnh được trả về. `n` chọn số ảnh cần tạo (1–4, mặc định 1).
Bạn chỉ bị tính phí cho những ảnh thực sự được trả về: nếu nhà cung cấp thất bại, hết thời gian chờ hoặc trả về lỗi, khoản tạm giữ sẽ được hoàn lại vào số dư của bạn tự động.
Model tạo ảnh yêu cầu tín dụng trả phí — tín dụng chào mừng và tín dụng thưởng không dùng được cho chúng.

Các model được gắn cờ hỗ trợ chỉnh sửa cũng chấp nhận POST /v1/images/edits với body dạng multipart form (ảnh gốc + prompt) ở cùng mức giá mỗi ảnh. Model không có cờ này sẽ trả về 400 trên endpoint đó.

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"

Thời gian thực

Streaming

Truyền stream: true để nhận Server-Sent Events với cùng định dạng delta như 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 ?? "");
}

Độ tin cậy

Lỗi

Zyloo trả về các đối tượng lỗi tương thích OpenAI. Các mã phổ biến:

Mã	Ý nghĩa	Hành động
401	Key không hợp lệ	Tạo key mới từ dashboard
402	Không đủ tín dụng	Nạp thêm vào ví
429	Bị giới hạn tốc độ	Backoff, chúng tôi định tuyến sang nhà cung cấp thay thế
5xx	Lỗi upstream	Tự động thử lại với idempotency-key

Sẵn sàng triển khai?

Lấy key và bắt đầu gửi traffic trong chưa đầy một phút.

Lấy API key

# 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

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

Mã

Ý nghĩa

Hành động

401

Key không hợp lệ

Tạo key mới từ dashboard

402

Không đủ tín dụng

Nạp thêm vào ví

429

Bị giới hạn tốc độ

Backoff, chúng tôi định tuyến sang nhà cung cấp thay thế

5xx

Lỗi upstream

Tự động thử lại với idempotency-key

Tài liệu.

Bắt đầu nhanh

Xác thực

Model

Chat completions

Tạo ảnh

Streaming

Lỗi

Sẵn sàng triển khai?

Tài liệu.

Bắt đầu nhanh

Xác thực

Model

Chat completions

Tạo ảnh

Streaming

Lỗi

Sẵn sàng triển khai?