快速开始

本页教程帮助您完成第一次成功调用。客户端配置请看配置教程，完整参数请看 API 手册。

如果您不是在项目代码中接入API，而是想在 ChatBox、Claude Code、Codex 或其他 AI 编辑器里配置使用某个大模型，建议直接看 ChatBox 配置 或 Claude Code 与 Codex 配置。

第一步：准备 API Key

注册并登录

打开 zrapi.org，按页面提示注册账号。

创建令牌

进入 控制台令牌页 创建新的 API Key，格式通常为 sk-...。

确认余额

如果调用返回 402，先检查余额或前往 获取兑换码 充值。

WARNING

API Key 只应保存在本地环境变量、服务端密钥管理或私有配置中，不要写入前端代码和公开仓库。

第二步：选择接入模式

使用方式	填写地址	说明
OpenAI SDK / OpenAI 兼容 API	https://zrapi.org/v1	用于 /chat/completions、图片生成等 OpenAI 兼容接口
Claude SDK / Anthropic 兼容 API	https://zrapi.org	Claude SDK 通常会自行拼接 /v1/messages
图形客户端 Host 字段	看客户端字段说明	如果字段名是 Host 或 API 域名，可能只填 https://zrapi.org

第三步：复制最短代码

cURL

curl https://zrapi.org/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "GPT-5.5",
    "messages": [
      { "role": "user", "content": "请用一句话介绍你自己" }
    ]
  }'

OpenAI Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-YOUR_TOKEN",
    base_url="https://zrapi.org/v1",
)

response = client.chat.completions.create(
    model="GPT-5.5",
    messages=[{"role": "user", "content": "请用一句话介绍你自己"}],
)
print(response.choices[0].message.content)

OpenAI Node.js

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: 'sk-YOUR_TOKEN',
  baseURL: 'https://zrapi.org/v1',
})

const response = await client.chat.completions.create({
  model: 'GPT-5.5',
  messages: [{ role: 'user', content: '请用一句话介绍你自己' }],
})
console.log(response.choices[0].message.content)

Claude Python

import anthropic

client = anthropic.Anthropic(
    api_key="sk-YOUR_TOKEN",
    base_url="https://zrapi.org",
)

message = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=512,
    messages=[{"role": "user", "content": "请用一句话介绍你自己"}],
)
print(message.content[0].text)

第四步：按状态码排查

状态码	常见原因	下一步
401	Key 错误、没带 Authorization	检查 Bearer sk-...
402	余额不足	查看控制台余额或充值
404	URL 或模型 ID 不存在	检查 Base URL 和模型名
429	请求过快	降低并发或增加重试间隔
500 / 502	上游或中转临时异常	稍后重试或换模型

查看对话接口完整参数配置 ChatBox配置 Claude Code 与 Codex