关于 zeabur-ai-hub
Zeabur AI Hub 管理技能面向使用 AI Hub 的开发者,涵盖通过 Zeabur CLI 查看状态、管理 API 密钥、余额、用量和自动充值,并说明兼容 API 的调用方式。
主要功能
- 01查看余额、密钥与自动充值状态
- 02创建和删除 API 密钥
- 03充值并查看模型用量
- 04配置自动充值
- 05使用兼容 OpenAI 的 API 端点
适用场景
- 01检查 AI Hub 余额及密钥
- 02为应用创建或删除 API 密钥
- 03核对月度支出和模型费用
- 04设置低余额自动充值
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ zeabur/ agent-skills --skill zeabur-ai-hub安装后在 Claude Code 中输入/zeabur-ai-hub确认已加载。
详细介绍
Zeabur AI Hub 管理
始终使用
npx zeabur@latest调用 Zeabur CLI。 切勿直接使用zeabur或采用其他安装方式。如果无法使用npx,请先安装 Node.js。
API 端点
AI Hub 兼容 OpenAI。用户可以选择距离自己最近的区域:
| 区域 | 端点 |
|---|---|
| 日本东京(HND1) | https://hnd1.aihub.zeabur.ai/ |
| 美国旧金山(SFO1) | https://sfo1.aihub.zeabur.ai/ |
快速开始(OpenAI SDK)
JavaScript / TypeScript:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://hnd1.aihub.zeabur.ai/v1", // or sfo1
apiKey: "sk-xxxxxxxxxxxxxxxx", // from AI Hub dashboard
});
const stream = await client.chat.completions.create({
model: "claude-sonnet-4-5", // any model available on AI Hub
messages: [{ role: "user", content: "Hello!" }],
stream: true,
});
Python:
from openai import OpenAI
client = OpenAI(
base_url="https://hnd1.aihub.zeabur.ai/v1", # or sfo1
api_key="sk-xxxxxxxxxxxxxxxx", # from AI Hub dashboard
)
stream = client.chat.completions.create(
model="claude-sonnet-4-5",
messages=[{"role": "user", "content": "Hello!"}],
stream=True,
)
curl:
curl https://hnd1.aihub.zeabur.ai/v1/chat/completions \
-H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"model":"claude-sonnet-4-5","messages":[{"role":"user","content":"Hello!"}]}'
其他 SDK 兼容性
- Anthropic SDK:将
baseURL/base_url设置为上方的端点 - Vercel AI SDK(
@ai-sdk/openai):将baseURL设置为上方的端点
环境变量
当用户在 Zeabur 上部署应用时,建议设置:
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx
OPENAI_BASE_URL=https://hnd1.aihub.zeabur.ai/v1
大多数兼容 OpenAI 的库都会自动读取这些变量。
检查 AI Hub 状态
npx zeabur@latest ai-hub status -i=false
npx zeabur@latest ai-hub status -i=false --json
显示租户余额、API 密钥和自动充值设置。
API 密钥管理
# List all keys
npx zeabur@latest ai-hub keys list -i=false
npx zeabur@latest ai-hub keys ls -i=false --json
# Create a new key (optional alias)
npx zeabur@latest ai-hub keys create --alias "my-app" -i=false
# Delete a key
npx zeabur@latest ai-hub keys delete --key-id <key-id> -i=false
API 密钥仅在创建时显示一次。 请确保用户立即保存。
添加余额
# Add $10 to AI Hub balance
npx zeabur@latest ai-hub add-balance --amount 10 -i=false
- 金额以整美元为单位(整数)。
- 从 Zeabur 账户余额中扣除。如果余额不足且没有关联银行卡,系统会自动在浏览器中打开结账页面。
检查用量
# Current month usage
npx zeabur@latest ai-hub usage -i=false
# Specific month
npx zeabur@latest ai-hub usage --month 2026-03 -i=false
npx zeabur@latest ai-hub usage --month 2026-03 -i=false --json
显示总支出和各模型的费用明细。--month 必须采用 YYYY-MM 格式。
自动充值设置
# Enable: recharge $20 when balance drops below $5
npx zeabur@latest ai-hub auto-recharge --threshold 5 --amount 20 -i=false
# Disable auto-recharge
npx zeabur@latest ai-hub auto-recharge --threshold 0 --amount 0 -i=false
--threshold 和 --amount 都以整美元为单位。
评论
支持 Markdown