主题
快速开始
本指南用最短路径完成注册、创建 Key、选择协议和发送第一条请求。通常 5 分钟内即可完成。
1. 注册并进入控制台
2. 创建 API Key
进入 令牌管理，点击 添加令牌：
- 设置易识别的名称，例如
local-codex或backend-dev。 - 选择允许使用的模型分组。
- 建议设置额度、有效期、IP 白名单或 RPM/RPH 限制。
- 创建后立即复制并安全保存
sk-开头的 Key。
不要泄露 Key
API Key 等同于账号凭证。不要提交到 Git、写进前端代码、粘贴到公开 Issue，或在截图中展示完整值。不同应用建议使用不同 Key。
完整策略见 API Key 管理与安全。
3. 选择协议
| 你的客户端或代码 | 推荐协议 | Base URL |
|---|---|---|
| Codex、OpenAI SDK、支持自定义 OpenAI Base URL 的客户端 | OpenAI | https://zivv.pro/v1 |
| Claude Code、Anthropic SDK | Anthropic | https://zivv.pro |
| Google Gen AI SDK、Gemini 原生客户端 | Gemini | https://zivv.pro/v1beta |
不确定时查看 选择接入方式。更完整的端点差异见 协议与兼容性。
4. 从模型广场复制模型 ID
打开 模型广场，选择模型并复制完整 ID。
下面示例中的 YOUR_MODEL_ID 必须替换为实际模型 ID。模型可用性和价格会更新，文档不固定维护一份重复列表。
5. 发送第一条请求
选择与你的客户端一致的协议测试。
bash
curl https://zivv.pro/v1/chat/completions \
-H "Authorization: Bearer sk-你的Key" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL_ID",
"messages": [{"role": "user", "content": "只回复 pong"}]
}'bash
curl https://zivv.pro/v1/messages \
-H "x-api-key: sk-你的Key" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL_ID",
"max_tokens": 32,
"messages": [{"role": "user", "content": "只回复 pong"}]
}'bash
curl "https://zivv.pro/v1beta/models/YOUR_MODEL_ID:generateContent" \
-H "x-goog-api-key: sk-你的Key" \
-H "Content-Type: application/json" \
-d '{
"contents": [{"parts": [{"text": "只回复 pong"}]}]
}'Windows PowerShell
Windows PowerShell 中的 curl 可能映射到 Invoke-WebRequest。示例可在 Git Bash、WSL 或支持标准 cURL 的终端中运行；也可使用对应 SDK 测试。
6. 确认接入成功
满足以下条件即表示基础接入完成：
- HTTP 状态码为
200 - 响应中包含模型输出内容
- 流式请求能持续收到事件
- 用量日志 中能看到本次请求、模型、Token 和费用
如果失败，按以下顺序排查：
- Key 是否完整、有效且未过期
- Base URL 是否与协议匹配
- 模型 ID 是否准确，Key 分组是否允许访问
- 账户余额、Key 额度、RPM/RPH 或团队预算是否足够
- 查看 错误码 中的对应状态码