Lip Sync 소개
이미 있는 영상의 목소리를 바꿉니다. 영상과 새 음성을 보내면 화면 속 인물의 입이 그 말에 맞게 다시 그려지고, 나머지는 촬영한 그대로입니다.
POST /jobs/createTask에서 모델 이름을 popnow/lip-sync-v1/lip-sync(으)로 지정하면 호출할 수 있습니다. 1.8크레딧/초부터(US$0.018). 새 계정에는 30크레딧이 지급되니 Playground에서 먼저 무료로 써 보세요.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
audio_url | 예 | 사용할 목소리나 음악. |
video_url | 예 | 작업할 영상. |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /초 | ≈ USD |
|---|---|---|
| 기본 | 1.8 | US$0.018 |
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Lip Sync API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 popnow/lip-sync-v1/lip-sync, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
- 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/lip-sync-v1/lip-sync",
"input": {
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"audio_url": "https://media.popnow.ai/shortfilm/voices/Aoede-46e4c427.mp3"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.
Lip Sync API 질문
Lip Sync API 요금은 얼마인가요?
Lip Sync 가격은 1.8크레딧(US$0.018) /초입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Lip Sync의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 립싱크: popnow/lip-sync-v1/lip-sync을(를) 넣으세요.
원래 소리는 어떻게 되나요?
교체됩니다. 반환되는 영상에는 보낸 음성이 들어 있습니다.
영상이 음성만큼 길어야 하나요?
그렇지 않습니다. 짧은 영상은 반복 재생으로 음성 길이를 채우고, 결과는 음성 길이를 따릅니다.
Lip Sync API의 제한은 무엇인가요?
최대 업로드 크기: 90 MB. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 Lip Sync을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Lip Sync을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.