Skip to content
Black Friday

Black Friday 40% off·$9.99$5.99/ month

Ends MondayClaim 40% off

Developers · REST v1

BeTuber Character API

Animated 2D VTube 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

Call the Character API from the browser

Ping health without a key. Paste a Bearer key (bt_live_… or marketplace hub key) to generate a character and render an SVG still.

Response —
 

Why this API

Same Animated 2D engine apps can ship

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.

Built for

  • Avatar marketplaces

    Generate unique looks at scale and show SVG previews before a buyer opens the full rig.

  • Onboarding & games

    Give every new player a fresh Animated 2D character without hand-authoring each file.

  • Creator tools

    Wrap the same engine BeTuber uses so your editor stays compatible with the live avatar.

Documentation

Endpoints, auth, and plans

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.

Endpoints

GET /health

Service health

Liveness check. No auth. RapidAPI hubs can use GET /ping instead.

Public

GET /catalog

Species, bodies, views, quotas

Lists what the origin can generate and the plan quotas it enforces this UTC month.

Auth required

POST /characters

Generate a VTuber character

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

Draw a look as SVG

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

Monthly usage

Characters and renders spent in the current UTC month for the calling key or hub subscriber.

Auth required

Authentication

Marketplace traffic arrives through the hub proxy. Direct partners use a BeTuber-minted Bearer key.

  • RapidAPI

    Import openapi.json, keep the Rapid Runtime on, and set X-RapidAPI-Proxy-Secret on the origin. Subscriptions BASIC, PRO, ULTRA, MEGA.

  • API.market

    Header X-Betuber-Proxy-Secret plus plan header X-Betuber-Marketplace-Plan (basic | pro | ultra | mega).

  • Direct key

    Authorization: Bearer bt_live_…. Minted with the admin secret on POST /api/v1/keys.

Plans

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.

PlanUSD / moCharactersRendersReq / 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

Quick start

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

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

FAQ

What is the BeTuber Character API?
A versioned REST API that generates original Animated 2D VTuber characters as rig JSON and draws SVG stills of those looks—without calling an image model.
Is this a Live2D or VRM API?
No. It returns BeTuber engine looks and SVG renders. The JSON is what the BeTuber Animated 2D rig wears on stream, not a Live2D model file or VRM mesh.
How do I authenticate?
Use a direct Bearer key (bt_live_…), or call through RapidAPI / API.market with the hub’s proxy headers. Health and ping stay public.
Where is the OpenAPI spec?
GET https://app.betuber.com/api/v1/openapi.json — import it into RapidAPI, API.market, or any OpenAPI client.
What happens when I hit the quota?
The API returns HTTP 429 until the next UTC month. Per-minute rate limits also return 429. Check GET /usage for the current counters.