开始使用

Zurelay API 文档

Zurelay 通过一个 API 提供你常用的 AI 模型,价格仅为各实验室官方价格的一小部分。使用 Zurelay, Anthropic, OpenAI, xAI, Meta, Xiaomi, DeepSeek, Google, Z.ai, Moonshot AI, Alibaba, MiniMax, Tencent, StepFun, Mistral AI 和 Abliteration AI 的模型对话,用 Nano Banana 和 GPT Image 生成和编辑图片,用 Seedance、Kling、Wan、Grok Imagine、Vidu 和 PixVerse 生成视频,只需一个密钥,共用一个余额。

兼容 OpenAI 和 Anthropic 的 API,现有 SDK、框架和工具都能直接使用:只需更换基础 URL 和密钥,无需修改代码。

基础 URL

适用场景基础 URL
OpenAI SDK 及所有兼容 OpenAI 的工具https://api.zurelay.com/v1
Anthropic SDK 和 Claude Codehttps://api.zurelay.com

通过 Authorization: Bearer zr_live_… 传入密钥(也可像 Anthropic SDK 一样使用 x-api-key)。在控制台的 API 密钥页面创建密钥。

发起第一个请求

import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.zurelay.com/v1",
api_key=os.environ["ZURELAY_API_KEY"],
)
response = client.chat.completions.create(
model="claude-sonnet-5-5",
messages=[
{
"role": "user",
"content": "Explain what an API gateway does in one paragraph."
}
],
)
print(response.choices[0].message.content)

功能概览

端点

方法路径功能介绍
POST/v1/chat/completions与任意文本模型对话(OpenAI 格式)
POST/v1/messages与 Claude 模型对话(Anthropic 格式)
POST/v1/messages/count_tokens统计 Messages 请求的输入 token 数
POST/v1/images/generations生成图片,可选用参考图
POST/v1/images/edits编辑图片(使用 OpenAI 的 multipart 表单或 JSON)
POST/v1/videos创建视频生成任务
GET/v1/videos/{id}查询视频状态,完成后获取链接
GET/v1/videos/{id}/content下载已生成的视频
GET/v1/videos你最近的视频
GET/v1/models所有模型及其支持的输入类型

工作原理

每个请求都由你指定的模型处理,保持该模型公布的质量水平,并通过具备自动恢复能力的服务集群提供服务:如果某条模型访问线路卡住或出错,系统会在向你返回结果前自动换一条线路重试,让短暂故障只带来片刻等待,而不是报错。当某个模型完全不可用时,智能路由可以使用最接近的替代模型作答。

费用按用量从预付余额中扣除,token、图片或秒的单价见模型页面。失败的请求不收费。

面向 AI 助手和智能体

在用 ChatGPT、Claude、Cursor 或智能体开发?每个页面顶部都有复制页面按钮,可将页面复制为 Markdown,粘贴给任何 AI。文档还提供智能体可读取的格式:

  • llms.txt:介绍 Zurelay、调用方式,并提供所有页面的链接。
  • llms-full.txt:将全部文档汇总为一个 Markdown 文件,包含当天的模型和价格。
  • 以 Markdown 格式读取任意页面:在地址后加上 .md,例如 /docs/quickstart.md。

有疑问,或发现内容缺失?联系我们的支持团队,我们会通过邮件回复,通常只需一分钟。