快速开始

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

安全

身份验证

每个请求都必须在 Authorization 头中包含 bearer 令牌。密钥按项目划分范围，可从控制台即时吊销。

http

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

本地开发我们建议把密钥存放在 .env 文件中并通过运行时加载——切勿将密钥提交到源码管理。

模型

用任意模型的规范 Zyloo id 引用它。每个 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。

端点

聊天补全

与 OpenAI 的 /v1/chat/completions 相同的 JSON 结构。每个兼容模型都支持工具、JSON 模式、视觉和结构化输出。

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 即可接收与 OpenAI 相同 delta 格式的 Server-Sent Events。

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

文档。

快速开始

身份验证

模型

聊天补全

流式传输

错误

准备上线了？