GET /health
서비스 헬스
생존 확인. 인증 없음. RapidAPI는 GET /ping 가능.
공개
개발자 · REST v1
BeTuber Character API
오리지널 리깅 VTuber 룩을 생성하고 SVG로 그립니다—BeTuber가 방송에서 쓰는 같은 엔진. 이미지 모델 없음. 앱이 입을 수 있는 버전 JSON.
라이브 플레이그라운드
키 없이 health를 확인하세요. Bearer 키를 붙여 캐릭터를 생성하고 SVG를 렌더할 수 있습니다.
이 API가 필요한 이유
대부분 “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
BeTuber 릭이 입을 수 있는 JSON 룩을 반환. 선택: { "gender": "female" | "male" | "other" }.
인증 필요
POST /characters/render
full / upper / bust / face 스틸 SVG. POST /characters의 look을 전달하세요.
인증 필요
GET /usage
이번 UTC 월 캐릭터·렌더 사용량.
인증 필요
마켓플레이스 트래픽은 허브 프록시를 통합니다. 직접 파트너는 BeTuber Bearer 키를 사용합니다.
openapi.json 가져오기, Rapid Runtime 유지, X-RapidAPI-Proxy-Secret 설정. BASIC, PRO, ULTRA, MEGA.
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