Vidu S1 API — 보고, 듣고, 반응하는 실시간 AI 디지털 휴먼 구축하기

캐릭터의 페르소나, 아바타 이미지, 보이스를 담아 POST 한 번만 호출하면 세션 ID와 RTC 인증 정보가 반환됩니다.

POST https://api.vidu.com/live/v1/lives
Authorization: Token vda_xxx

{ "call_mode": "video",
  "avatar": {
    "persona": "A friendly agent...",
    "image_uri": "https://your-avatar.png",
    "name": "Mia", "voice": "Tina" } }

반환된 token으로 AliRTC 채널에 참여해 사용자 마이크(비디오 모드에서는 카메라 포함)를 퍼블리시하고, 캐릭터의 스트림을 구독합니다.

await aliRtc.joinChannel(rtc.token, rtc.user_id);
await aliRtc.publishLocalAudioStream(true);
await aliRtc.publishLocalVideoStream(true);
// subscribe: live-bot-{creatorID}-{liveID}

지속 연결되는 제어 채널을 엽니다. 인증은 쿼리 스트링으로 전달합니다 — 브라우저는 WebSocket에 커스텀 헤더를 설정할 수 없기 때문입니다.

wss://api.vidu.com/live/ws/live/connect
  ?live_id={live_id}&authorization=Token%20vda_xxx

{ "type": 1, "seq_id": 1,
  "payload": { "conn_init": { "version": 1 } } }

성공 ack를 받으면 캐릭터가 라이브 상태입니다. 비디오 모드에서 NOT_READY는 정상입니다 — 지수 백오프(2s → 4s → 8s)로 재연결하세요.

{ "type": 2, "payload": {
    "conn_init_ack": { "success": true } } }

// NOT_READY? retry with backoff: 2s -> 4s -> 8s

서버가 5초마다 ping을 보내며, 15초 안에 응답해야 합니다. 강제 종료 메시지(type 6)를 수신 대기하고, 각 종료 사유를 개별 처리하세요.

// server pings every 5s — respond within 15s
{ "type": 6, "payload": { "hangup":
    { "hangup_reason": "credit_insufficient" } } }

종료 메시지를 보내고 WebSocket을 닫은 뒤 RTC 채널에서 나가면 — 이후 언제든 최종 상태와 과금 시간을 조회할 수 있습니다.

{ "type": 5, "seq_id": 2,
  "payload": { "hangup":
    { "hangup_reason": "user_end" } } }

GET /live/v1/lives/{live_id} → "billed_seconds": "87"