本文へスキップ
Black Friday

Black Friday 40%オフ·$9.99$5.99/月

月曜まで40%オフを受け取る

開発者向け · REST v1

BeTuber Character API

Animated 2D VTube Character API

オリジナルのリギング済み VTuber ルックを生成し、SVG で描画—BeTuber が配信で使うのと同じエンジン。画像モデルなし。アプリがそのまま着られるバージョン付き JSON。

ライブプレイグラウンド

ブラウザから Character API を呼ぶ

キーなしで health を確認。Bearer キーを貼るとキャラ生成と SVG レンダーができます。

レスポンス —
 

この API の理由

アプリがそのまま出荷できる同じ Animated 2D エンジン

多くの「VTuber API」はチャットボットや顔トラッキングで止まります。BeTuber Character API はキャラそのものを提供します—構造化 JSON のオリジナル Animated 2D ルックと、カードやストア向けの SVG スティル。

画像拡散モデルは呼びません。コストはオリジンの CPU なので、品質を BeTuber の配信リグに固定したままマーケット価格を維持しやすいです。

アバターショップの在庫、オンボーディングのランダム初登場ルック、クライアントに Live2D を積まずにバスト肖像を出す用途に向いています。

想定用途

  • アバターマーケット

    ユニークなルックを量産し、フルリグの前に SVG プレビューを見せる。

  • オンボーディング&ゲーム

    手作業なしで各プレイヤーに新しい Animated 2D キャラを渡す。

  • クリエイターツール

    BeTuber と同じエンジンを包み、ライブアバター互換のまま編集できる。

ドキュメント

エンドポイント・認証・プラン

ベース URL は BeTuber アプリの /api/v1 です。OpenAPI を RapidAPI や API.market に取り込むか、直接キーで呼び出します。

エンドポイント

GET /health

ヘルスチェック

生存確認。認証不要。RapidAPI は GET /ping も可。

公開

GET /catalog

種族・ボディ・ビュー・クォータ

生成可能な内容と、当 UTC 月のプラン上限を返します。

認証が必要

POST /characters

VTuber キャラクター生成

BeTuber リグが着られる JSON ルックを返します。任意: { "gender": "female" | "male" | "other" }。

認証が必要

POST /characters/render

ルックを SVG 描画

full / upper / bust / face のスティル SVG。POST /characters の look を渡します。

認証が必要

GET /usage

月次利用量

当 UTC 月のキャラ生成・レンダー消費量。

認証が必要

認証

マーケットプレイス経由はハブのプロキシ経由。直接パートナーは BeTuber 発行の Bearer キー。

  • RapidAPI

    openapi.json を取り込み、Rapid Runtime を維持し X-RapidAPI-Proxy-Secret を設定。BASIC / PRO / ULTRA / MEGA。

  • API.market

    X-Betuber-Proxy-Secret と X-Betuber-Marketplace-Plan(basic | pro | ultra | mega)。

  • 直接キー

    Authorization: Bearer bt_live_…。POST /api/v1/keys で発行。

プラン

クォータは毎月 UTC 1 日にリセット。429 はその月の上限到達です。

プランUSD / 月キャラレンダーReq / 分
Basic $0 100 50 10
Pro $19 2,000 1,000 30
Ultra $79 15,000 8,000 60
Mega $199 80,000 40,000 120

クイックスタート

health はキー不要。生成とレンダーはクォータを消費します。

cURL

curl -s https://app.betuber.com/api/v1/health
curl -s https://app.betuber.com/api/v1/characters \
  -H "Authorization: Bearer bt_live_…" \
  -H "Content-Type: application/json" \
  -d '{"gender":"female"}'

OpenAPI

https://app.betuber.com/api/v1/openapi.json

FAQ

BeTuber Character API とは?
オリジナルの Animated 2D VTuber キャラクターをリグ JSON で生成し、SVG スティルを描画するバージョン付き REST APIです。画像モデルは使いません。
Live2D や VRM の API ですか?
いいえ。BeTuber エンジンのルックと SVG を返します。Live2D ファイルや VRM メッシュではありません。
認証方法は?
直接 Bearer キー(bt_live_…)か、RapidAPI / API.market のプロキシヘッダー。health と ping は公開です。
OpenAPI はどこ?
GET https://app.betuber.com/api/v1/openapi.json
クォータ超過時は?
次の UTC 月まで HTTP 429。GET /usage でカウンタを確認できます。