Saltar al contenido
Black Friday

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

Hasta el lunesReclamar 40% off

Desarrolladores · REST v1

BeTuber Character API

API de personajes VTuber 2D animados

Genera un look VTuber riggeado original y dibújalo en SVG—el mismo motor que BeTuber usa en directo. Sin modelo de imagen. JSON versionado que tu app puede vestir.

Playground en vivo

Llama a la Character API desde el navegador

Haz ping a health sin clave. Pega una clave Bearer (bt_live_… o del marketplace) para generar un personaje y renderizar un still SVG.

Respuesta —
 

Por qué esta API

El mismo motor 2D animado que pueden enviar las apps

La mayoría de “APIs VTuber” se quedan en bots de chat o tracking facial. La BeTuber Character API vende el personaje: un look Animated 2D original en JSON estructurado y un still SVG para cards, tiendas y previews.

Aquí no se llama a un modelo de difusión. El coste es CPU en el origen, así que el precio en el marketplace puede quedar alto frente al coste unitario mientras la calidad queda atada al rig de stream de BeTuber.

Úsala para stockear una tienda de avatares, sembrar el onboarding con un debut aleatorio o renderizar bustos para perfiles sin mandar Live2D a cada cliente.

Pensada para

  • Marketplaces de avatares

    Genera looks únicos a escala y muestra previews SVG antes de abrir el rig completo.

  • Onboarding y juegos

    Dale a cada jugador un personaje 2D animado nuevo sin autorar cada archivo a mano.

  • Herramientas para creators

    Envuelve el mismo motor que usa BeTuber para que tu editor siga compatible con el avatar en vivo.

Documentación

Endpoints, auth y planes

La URL base es el origen de la app BeTuber bajo /api/v1. Importa el OpenAPI en RapidAPI o API.market, o llama con una clave directa.

Endpoints

GET /health

Salud del servicio

Comprobación de vida. Sin auth. Los hubs RapidAPI pueden usar GET /ping.

Público

GET /catalog

Especies, cuerpos, vistas, cuotas

Lista lo que el origen puede generar y las cuotas del plan en el mes UTC actual.

Auth requerida

POST /characters

Generar un personaje VTuber

Devuelve un look JSON que el rig BeTuber puede vestir. Cuerpo opcional: { "gender": "female" | "male" | "other" }.

Auth requerida

POST /characters/render

Dibujar un look en SVG

Renderiza un still SVG (full, upper, bust o face). Pasa el look de POST /characters.

Auth requerida

GET /usage

Uso mensual

Personajes y renders gastados en el mes UTC actual.

Auth requerida

Autenticación

El tráfico del marketplace llega por el proxy del hub. Los partners directos usan una clave Bearer de BeTuber.

  • RapidAPI

    Importa openapi.json, mantén el Rapid Runtime y configura X-RapidAPI-Proxy-Secret. Suscripciones BASIC, PRO, ULTRA, MEGA.

  • API.market

    Header X-Betuber-Proxy-Secret más X-Betuber-Marketplace-Plan (basic | pro | ultra | mega).

  • Clave directa

    Authorization: Bearer bt_live_…. Se crea con el secreto admin en POST /api/v1/keys.

Planes

Las cuotas se reinician el primer día UTC de cada mes. Un 429 significa que el plan está agotado hasta entonces.

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

Inicio rápido

Health no necesita clave. Generar y renderizar consumen cuota.

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

¿Qué es la BeTuber Character API?
Una API REST versionada que genera personajes VTuber 2D animados originales como JSON de rig y dibuja stills SVG—sin llamar a un modelo de imagen.
¿Es una API Live2D o VRM?
No. Devuelve looks del motor BeTuber y renders SVG. No es un archivo Live2D ni una malla VRM.
¿Cómo me autentico?
Con una clave Bearer directa (bt_live_…) o a través de RapidAPI / API.market con los headers del proxy. Health y ping son públicos.
¿Dónde está el OpenAPI?
GET https://app.betuber.com/api/v1/openapi.json
¿Qué pasa si agoto la cuota?
La API responde HTTP 429 hasta el siguiente mes UTC. Consulta GET /usage para los contadores.