はじ めに — Yabanin 運用者(前払いクレジット)
Yabanin は自社運用です。ゲートウェイ、管理パネル、ユーザーとの課金関係は自分が運用します。このリポジトリにはホストされたサインアップも価格表もありません。プロバイダの価格と再販の上乗せは、自分のデータベースで設定します。このガイドは、動作する前払いの構成を運用者に案内します。
1. スタックの導入
make docker-up # postgres + redis + migrations + gateway + admin
# or a single process:
yabanin dev --migrate
管理パネルは :8086 で待ち受けます(compose のホストは :9091)。yabanin admin create-user で管理者アカ ウントを作成します(--help を参照します。CLI はインラインのパスワードを拒否します。--password-stdin または YABANIN_ADMIN_PASSWORD_FILE を使います)。
2. 価格の設定
モデルの価格は models_pricing テーブルにあり、ゲートウェイはこれに対して課金します。各プロバイダの価格表から読み込みます。
yb pricing sync --apply # sync provider prices into models_pricing
同期の後、ゲートウェイは 5 分以内にデータベース上の価格を取り込みます(DBPricer のキャッシュ)。上乗せして再販するかどうかは自分の商業判断です。Yabanin は、設定された上乗せから再販額を計算できますが、その率は自分の導入で設定するものであり、ここでは公開されません。
3. 組織と API キーの作成
管理パネルで、顧客の組織を作成し、その組織の API キーを発行します(api_keys)。キーは組織スコープです。支出はラベルとセッションキーを通じて帰属します。
4. 前払いクレジットのチャージ
Yabanin の課金は前払いです。リクエストが処理されるのは、組織がクレジットを保有している間だけです。
# Admin API (admin session auth; cross-org views are root-only):
POST /api/orgs/{org_id}/credits/topup # add credits
GET /api/orgs/{org_id}/credits/balance # current balance
GET /api/orgs/{org_id}/credits/transactions # ledger
残高がなくなると、次のチャージまで、ゲートウェイは推論リクエストを 402 Payment Required(insufficient_credits)で拒否します。GET /api/credits/low-balance は、ゼロに近づいている組織を一覧します。支払いをどう回収するか(請求書、Stripe、銀行振込)は、Yabanin の範囲外です。
5. 最初のリクエスト
export YABANIN_API_KEY="<key you minted>"
export BASE_URL="http://localhost:8082/v1"
curl "$BASE_URL/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $YABANIN_API_KEY" \
-d '{
"model": "gpt-4o",
"messages": [{"role": "user", "content": "Hello, World!"}],
"max_tokens": 50
}'
レスポンスは標準の OpenAI チャット形式です("stream": true の場合は SSE も加わります)。支出はサーバー側で記録されます。ゲートウェイはチャットレスポンスにコストのフィールドを追加しません。支出を読むには、次を使います。
- セッションごと:
GET /v1/yabanin/session-keys/{id}/usage(cost_usdを返します)。 - 組織ごと、またはラベルごと: 管理画面の利用分析とリクエストログ(
request_logs。analytics.md を参照)。
次に見る場所
- docs/quickstart.md — ローカルスタック
- docs/labels.md — 支出の帰属
- docs/agent-governance.md — エージェントキーと予算
- docs/cli.md —
ybのコマンドリファレンス