快速开始
按这四步，完成你的第一次 API 调用。
1. 登录控制台
打开 APIVY 控制台，登录自己的账户。新账户如需额度，请先查看余额与账单页面提供的实际选项。
2. 创建一把 API 密钥
进入 API 密钥，点击创建按钮，填写容易识别的名称，例如「我的 Chatbox」。 初次使用可保留默认选项。余额与单个密钥额度是两回事；为密钥设置的上限不会自动增加账户余额。
保存后复制密钥。复制按钮会取出完整密钥；页面上显示的掩码不能用于调用。
3. 连接应用或发送请求
不写代码，可以直接按 Cherry Studio 或 Chatbox 教程填写。
以下为 Bash 示例，适用于 macOS、Linux、Git Bash 或 WSL。先将 APIVY_API_KEY 环境变量设置为自己创建的密钥。Windows PowerShell 用户可优先使用 Python SDK 示例；Bash 的 $APIVY_API_KEY 写法不能直接照搬到 PowerShell。
curl https://apivy.xyz/v1/chat/completions -H "Authorization: Bearer $APIVY_API_KEY" -H "Content-Type: application/json" -d '{"model":"deepseek-ai/DeepSeek-V4-Flash","messages":[{"role":"user","content":"你好，请用一句话介绍自己。"}],"max_tokens":128}'示例模型在 2026-10-29 完成真实调用验证。使用前仍请在模型页确认当前是否可用；也可以替换为自己账户可用的其他模型 ID。
4. 确认成功
看到模型实际回复后，打开 使用记录，核对时间、模型与消耗。 仅“保存配置成功”还不等于调用成功。遇到报错时，按 错误排查 检查。