mcpField
Z
zeabur-ai-hub

zeabur-ai-hub

github.com/zeabur云与 DevOps39141 次安装7 周前更新
代码仓库

关于 zeabur-ai-hub

Zeabur AI Hub 管理技能面向使用 AI Hub 的开发者,涵盖通过 Zeabur CLI 查看状态、管理 API 密钥、余额、用量和自动充值,并说明兼容 API 的调用方式。

主要功能

  1. 01查看余额、密钥与自动充值状态
  2. 02创建和删除 API 密钥
  3. 03充值并查看模型用量
  4. 04配置自动充值
  5. 05使用兼容 OpenAI 的 API 端点

适用场景

  1. 01检查 AI Hub 余额及密钥
  2. 02为应用创建或删除 API 密钥
  3. 03核对月度支出和模型费用
  4. 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