跳至內容
Black Friday

Black Friday 40% 折扣·$9.99$5.99/ 月

至週一領取 40% 折扣

開發者 · REST v1

BeTuber Character API

Animated 2D VTube Character API

生成原創綁定好的 VTuber 造型並以 SVG 繪製——與 BeTuber 直播相同的引擎。不呼叫影像模型。應用可直接穿戴的版本化 JSON。

即時 Playground

在瀏覽器呼叫 Character API

無需金鑰即可 ping health。貼上 Bearer 金鑰即可生成角色並渲染 SVG。

回應 —
 

為什麼需要這支 API

應用能直接出貨的同一套 Animated 2D 引擎

多數「VTuber API」停在聊天機器人或臉部追蹤。BeTuber Character API 賣的是角色本身:結構化 JSON 的原創 Animated 2D 造型,以及給卡片與商店用的 SVG 靜態圖。

這裡不呼叫擴散模型。成本是來源端的 CPU,因此市集定價可相對單位成本維持較高,品質則鎖定 BeTuber 直播骨架。

適合虛擬 YouTuber 頭像商店、隨機出道造型 onboarding,或在客戶端不帶 Live2D 的情況下渲染半身肖像。

適用於

  • 頭像市集

    大規模生成獨特造型,並在完整骨架前顯示 SVG 預覽。

  • Onboarding 與遊戲

    為每位玩家提供全新 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 月已用角色與渲染次數。

需要驗證

驗證

市集流量經 hub 代理。直接合作夥伴使用 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。

  • 直接金鑰

    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

常見問題

什麼是 BeTuber Character API?
一支版本化 REST API,以 rig JSON 生成原創 Animated 2D VTuber 角色,並繪製 SVG 靜態圖——不呼叫影像模型。
這是 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
配額用完會怎樣?
回傳 HTTP 429 直到下一個 UTC 月。可用 GET /usage 查看計數。