zeabur-ai-hub

Zeabur AI Hub の管理

Zeabur CLI の実行には、必ず npx zeabur@latest を使用してください。 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 は、どちらも整数のドル単位で指定します。