GET /health
Service health
Liveness check. No auth. RapidAPI hubs can use GET /ping instead.
Public
Developers · REST v1
BeTuber Character API
Generate an original rigged VTuber look and draw it as SVG—the same engine BeTuber uses on stream. No image model. Versioned JSON your app can wear.
Live playground
Ping health without a key. Paste a Bearer key (bt_live_… or marketplace hub key) to generate a character and render an SVG still.
Why this API
Most “VTuber APIs” stop at chat bots or face tracking. The BeTuber Character API sells the character itself: an original Animated 2D VTube look as structured JSON, then an SVG still of that look for cards, stores, and previews.
Nothing here calls a diffusion model. Cost is CPU on the origin, so marketplace pricing can stay high relative to unit cost while quality stays locked to the BeTuber stream rig—yaw, pitch, roll, and the same body catalog creators already wear live.
Use it to stock a virtual YouTuber avatar shop, seed onboarding with a random debut look, or render bust portraits for profile pages without shipping Live2D runtime to every client.
Generate unique looks at scale and show SVG previews before a buyer opens the full rig.
Give every new player a fresh Animated 2D character without hand-authoring each file.
Wrap the same engine BeTuber uses so your editor stays compatible with the live avatar.
Documentation
Base URL is the BeTuber app origin under /api/v1. Import the OpenAPI document into RapidAPI or API.market, or call with a direct key.
GET /health
Liveness check. No auth. RapidAPI hubs can use GET /ping instead.
Public
GET /catalog
Lists what the origin can generate and the plan quotas it enforces this UTC month.
Auth required
POST /characters
Returns a JSON look the BeTuber rig can wear: face, hair, body, species, outfit, accessories. Optional body: { "gender": "female" | "male" | "other" }.
Auth required
POST /characters/render
Renders a still SVG for view full, upper, bust, or face. Pass the look from POST /characters. Optional height (256–1200) and background hex.
Auth required
GET /usage
Characters and renders spent in the current UTC month for the calling key or hub subscriber.
Auth required
Marketplace traffic arrives through the hub proxy. Direct partners use a BeTuber-minted Bearer key.
Import openapi.json, keep the Rapid Runtime on, and set X-RapidAPI-Proxy-Secret on the origin. Subscriptions BASIC, PRO, ULTRA, MEGA.
Header X-Betuber-Proxy-Secret plus plan header X-Betuber-Marketplace-Plan (basic | pro | ultra | mega).
Authorization: Bearer bt_live_…. Minted with the admin secret on POST /api/v1/keys.
Quotas reset on the first UTC day of each month. A 429 means the plan is spent until then. Pricing is what you charge on the marketplace; this origin meters the same caps.
| Plan | USD / mo | Characters | Renders | Req / min |
|---|---|---|---|---|
| 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 needs no key. Character generation and render spend quota.
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
BeTuber
Save your brief & continue
Sign in to keep chatting with the Guide about BeTuber tools and next steps.