본문으로 건너뛰기
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 헤더.

  • 직접 키

    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로 카운터를 확인하세요.