Bytedance · 비디오

Hermes Agent x Volcengine Lip Sync

Volcengine Lip Sync는 RunAPI에서 동영상-동영상 립싱크에 집중한 엔드포인트를 API, SDK, CLI, Bruno, 문서까지 통합된 형태로 제공합니다.

1 variants 최저 $0.08 / 초 상업적 사용 지원

Prerequisite: npx runapi mcp install

Prompt

프롬프트 모델

작업에 맞는 경우 volcengine-lip-sync를 사용하세요: 소스 동영상과 오디오로 수행하는 오디오 기반 동영상-동영상 립싱크.

You have access to RunAPI task tools for Volcengine Lip Sync.

Available Volcengine Lip Sync models:
- volcengine-lip-sync: 소스 동영상과 오디오로 수행하는 오디오 기반 동영상-동영상 립싱크
  endpoints: /api/v1/volcengine_lip_sync/lip_sync_video
  request fields: model, mode, source_video_url, source_audio_url

Use the model ID and endpoint that match the user's request.
Example prompt: 이 발표자 동영상을 업로드한 내레이션에 맞춰 립싱크하고 원래 프레이밍과 움직임은 유지하세요.
/api/v1/volcengine_lip_sync/lip_sync_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/volcengine_lip_sync/lip_sync_video를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/volcengine_lip_sync/lip_sync_video/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.

공개 버전 및 엔드포인트

모델 ID 엔드포인트 시작 가격 모델 카탈로그
volcengine-lip-sync
/api/v1/volcengine_lip_sync/lip_sync_video
$0.08 / 초 모델 상세

검증

Task가 최종 상태에 도달할 때까지 폴링합니다

POST /api/v1/volcengine_lip_sync/lip_sync_video를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/volcengine_lip_sync/lip_sync_video/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.

설정

가이드 엔드포인트: /api/v1/volcengine_lip_sync/lip_sync_video

export RUNAPI_API_KEY=your_api_key

curl -X POST https://runapi.ai/api/v1/volcengine_lip_sync/lip_sync_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "volcengine-lip-sync",
  "mode": "lite",
  "source_video_url": "https://file.runapi.ai/source-video.mp4",
  "source_audio_url": "https://file.runapi.ai/narration.mp3"
}'
사용 절차

3단계로 시작하기

  1. 모델 ID 선택

    공개 모델 ID를 선택하고 엔드포인트와 현재 시작 가격을 확인합니다.

  2. RunAPI 설정

    엔드포인트 요청 전에 RUNAPI_API_KEY를 설정합니다.

  3. 결과 검증

    비동기 엔드포인트는 Task가 최종 상태가 될 때까지 같은 엔드포인트를 폴링합니다.

Hermes Agent + Volcengine Lip Sync로 만들 수 있는 것

  • 제품 및 마케팅 클립

    작성한 브리프를 바탕으로 제품 페이지, 광고, 랜딩 페이지용 짧은 홍보 영상을 만듭니다.

  • 소셜 미디어 숏폼

    소셜 피드용 짧은 클립을 만들고, 같은 아이디어로 여러 버전을 시도한 뒤 고릅니다.

  • 이미지 애니메이션과 영상 편집

    모델이 이미지-영상 변환이나 영상 편집 엔드포인트를 제공하는 경우 정지 이미지를 움직이게 하거나 기존 영상을 수정합니다.

Volcengine Lip Sync을(를) RunAPI + Hermes Agent로 사용하는 이유

  • 1개 변형 모델, 하나의 API 키

    하나의 RunAPI 연결에서 사용 가능한 모델 변형을 선택할 수 있어 통합 방식을 바꿀 필요가 없습니다.

  • 명확한 사용 요금

    요청을 보내기 전에 현재 카탈로그 요금을 확인하세요. 구독이나 최소 사용 금액이 없습니다.

  • 자동화된 작업 워크플로

    수동 폴링 코드를 작성하지 않고 일관된 작업 흐름으로 비동기 결과를 제출하고 확인하고 수집하세요.

Hermes Agent + Volcengine Lip Sync 자주 묻는 질문

Volcengine Lip Sync에는 어떤 입력이 필요한가요?

공개 소스 동영상 URL과 공개 소스 오디오 URL이 필요합니다.

어떤 mode를 선택해야 하나요?

정면 단일 인물 동영상과 더 빠른 처리에는 `lite`를 사용하세요. 장면이 더 복잡하고 장면 감지가 필요하면 `basic`을 사용하세요.

`enable_vocal_separation`은 무엇을 하나요?

입 모양 움직임을 구동하기 전에 보컬을 분리해 배경 소음을 줄입니다.

`align_audio`는 언제 사용할 수 있나요?

`align_audio`, `align_audio_reverse`, `template_start_seconds`는 `lite` 모드에서만 사용할 수 있습니다.

완료 응답은 무엇을 반환하나요?

완료 응답은 생성된 동영상 URL을 `videos`에 반환합니다.

어떤 모델 ID를 사용해야 하나요?

버전 표에서 공개 모델 ID를 선택하세요. 각 ID가 제공하는 엔드포인트는 해당 행에 표시됩니다.

이 가이드는 채팅 모델을 설정하나요?

아니요. 이 Model Line은 여기에 표시된 엔드포인트 절차를 사용하며 Agent 채팅 모델로 제공되지 않습니다.

Hermes Agent에서 Volcengine Lip Sync 사용 시작하기

팀과 함께 구축하고 계신가요?

엔터프라이즈 설정, 통합, 기술 문의를 도와드립니다.

문의하기