# 1. the lip-sync state of a dubbed project
curl https://api.rask.ai/v3/projects/$ID/lipsync \
-H "Authorization: Bearer $RASK_API_KEY"
# "video_has_face": true, "free_trial_run_available": true
# 2. the price first - free, and it changes nothing
curl -X POST https://api.rask.ai/v3/projects/$ID/lipsync/estimate \
-H "Authorization: Bearer $RASK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "enhanced"}'
# 3. lip-sync the full video - the price you accepted is the ceiling
curl -X POST https://api.rask.ai/v3/projects/$ID/lipsync \
-H "Authorization: Bearer $RASK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "enhanced", "expected_cost_minutes": 12}'# Starting lip-sync returns a job. Wait on it instead of polling:
# one request, up to 20 seconds, and it returns the moment the task is done.
curl -s "https://api.rask.ai/v3/jobs/$JOB_ID?wait_seconds=20" \
-H "Authorization: Bearer $RASK_API_KEY" | jq .status동영상을 가져오거나 공개 URL을 전송하고, 목표 언어로 프로젝트를 생성한 뒤 작업이 완료될 때까지 기다리세요. 립싱크에는 이 프로젝트에서 생성된 더빙 영상이 필요합니다.
얼굴 확인 작업을 통해 영상에 최소 한 명의 얼굴이 있는지 확인합니다. 보통 자동으로 시작되지만, 시작되지 않았다면 프로젝트에서 직접 한 번 실행해 주세요.
립싱크 작업을 시작하고 0부터 100까지 진행 상황을 확인한 다음, 프로젝트 결과물에서 동영상을 다운로드하세요.
import os, requests
API = "https://api.rask.ai/v3"
h = {"Authorization": f"Bearer {os.environ['RASK_API_KEY']}"}
# lip-sync runs on a project that has already been dubbed
state = requests.get(f"{API}/projects/{project_id}/lipsync", headers=h).json()
assert state["video_has_face"]
# the price first - free, and it changes nothing
estimate = requests.post(f"{API}/projects/{project_id}/lipsync/estimate", headers=h,
json={"model": "enhanced"}).json()
# the price you accepted is the ceiling
job = requests.post(f"{API}/projects/{project_id}/lipsync", headers=h,
json={"model": "enhanced",
"expected_cost_minutes": estimate["total_minutes"]}).json()
requests.get(f"{API}/jobs/{job['id']}?wait_seconds=20", headers=h).json()
for o in requests.get(f"{API}/projects/{project_id}/outputs", headers=h).json()["data"]:
print(o["kind"], o["url"])# pip install rask-sdk
from rask_sdk import Rask
rask = Rask() # reads RASK_API_KEY
# the price first - free, and it changes nothing
estimate = rask.projects.estimate_project(
media_id=media_id, target_language="es-mx"
)
# dub, then lip-sync what it produced
created = rask.projects.create_project(
media_id=media_id,
target_language="es-mx",
expected_cost_minutes=estimate.total_minutes,
)
dubbed = rask.jobs.wait(created.id)
for o in rask.exports.list_project_outputs(dubbed.result.project_id).data:
print(o.kind, o.url)// no dependencies, Node 18+ global fetch
const API = 'https://api.rask.ai/v3';
const h = {
Authorization: `Bearer ${process.env.RASK_API_KEY}`,
'Content-Type': 'application/json',
};
// lip-sync runs on a project that has already been dubbed
const state = await fetch(`${API}/projects/${projectId}/lipsync`, { headers: h })
.then(r => r.json());
// the price first - free, and it changes nothing
const estimate = await fetch(`${API}/projects/${projectId}/lipsync/estimate`, {
method: 'POST', headers: h, body: JSON.stringify({ model: 'enhanced' }),
}).then(r => r.json());
// the price you accepted is the ceiling
const job = await fetch(`${API}/projects/${projectId}/lipsync`, {
method: 'POST', headers: h,
body: JSON.stringify({ model: 'enhanced', expected_cost_minutes: estimate.total_minutes }),
}).then(r => r.json());
await fetch(`${API}/jobs/${job.id}?wait_seconds=20`, { headers: h }).then(r => r.json());
const outputs = await fetch(`${API}/projects/${projectId}/outputs`, { headers: h })
.then(r => r.json());
outputs.data.forEach(o => console.log(o.kind, o.url));API=https://api.rask.ai/v3
AUTH="Authorization: Bearer $RASK_API_KEY"
JSON="Content-Type: application/json"
# 1. the dubbed video must have a usable face
curl -s $API/projects/$ID/lipsync -H "$AUTH" | jq .video_has_face
# 2. the price first - free, and it changes nothing
CAP=$(curl -s -X POST $API/projects/$ID/lipsync/estimate -H "$AUTH" -H "$JSON" \
-d '{"model": "enhanced"}' | jq -r .total_minutes)
# 3. start lip-sync - the price you accepted is the ceiling
JOB=$(curl -s -X POST $API/projects/$ID/lipsync -H "$AUTH" -H "$JSON" \
-d "{\"model\":\"enhanced\",\"expected_cost_minutes\":$CAP}" | jq -r .id)
# 4. wait on the job, then collect the lip-synced video
curl -s "$API/jobs/$JOB?wait_seconds=20" -H "$AUTH" | jq .status
curl -s $API/projects/$ID/outputs -H "$AUTH" \
| jq -r '.data[] | "\(.kind)\t\(.url)"'<?php
use GuzzleHttp\Client;
$http = new Client([
'base_uri' => 'https://api.rask.ai/v3/',
'headers' => ['Authorization' => 'Bearer ' . getenv('RASK_API_KEY')],
]);
// lip-sync runs on a project that has already been dubbed
$state = json_decode($http->get("projects/{$projectId}/lipsync")->getBody(), true);
// the price first - free, and it changes nothing
$estimate = json_decode($http->post("projects/{$projectId}/lipsync/estimate",
['json' => ['model' => 'enhanced']])->getBody(), true);
// the price you accepted is the ceiling
$job = json_decode($http->post("projects/{$projectId}/lipsync", ['json' => [
'model' => 'enhanced',
'expected_cost_minutes' => $estimate['total_minutes'],
]])->getBody(), true);
$http->get("jobs/{$job['id']}?wait_seconds=20");
$outputs = json_decode(
$http->get("projects/{$projectId}/outputs")->getBody(), true); 0s queued lip-sync task accepted
8s running face check
40s running generating
180s running merging
210s succeeded the lip-synced video is in the project outputs

es-mx 및 es-es 지원합니다. 프로젝트는 용어집 버전을 기록하므로, 나중에 수정해도 완료된 작업이 예기치 않게 변경되지 않습니다.네, Rask 립싱크 API는 프로젝트에서 더빙된 모든 동영상에서 작동합니다. 동영상에 얼굴이 포함되어 있는지 확인하고, POST /v3/projects/{project_id}/lipsync/estimate를 통해 작업을 예상한 다음, 작업을 시작하고 완료되면 립싱크된 동영상을 다운로드하세요. 인증은 하나의 API 키로 처리되므로 다른 Rask API와 동일한 방식으로 연동할 수 있습니다.
립싱크는 번역된 영상에서 실행됩니다. 먼저 프로젝트를 생성하여 더빙한 후, 해당 작업이 성공하고 프로젝트 결과물에 더빙된 영상이 표시되면 립싱크를 시작하세요.
립싱크에는 프로젝트의 더빙된 오디오가 사용됩니다. 원하는 문구를 사용하려면 번역된 텍스트를 수정하거나 내 .srt 파일로 자막을 만든 후 프로젝트를 다시 더빙하고, 새 버전에서 립싱크를 실행하세요.
Rask는 입력한 영상에 등장하는 실제 인물의 실제 촬영본을 립싱크합니다. 이미지나 텍스트 프롬프트로 말하는 아바타, 디지털 휴먼, AI 영상을 생성하는 것은 다른 제품 카테고리이므로, 해당 기능에는 AI 영상 제작 툴이 더 적합합니다.
말하는 사람의 얼굴이 선명하게 보이고, 조명이 좋으며, 입 모양이 가려지지 않은 영상을 사용하세요. 마이크, 손, 자막 등으로 입술을 가리거나 얼굴이 측면을 향하는 것은 피하세요. 얼굴 감지 기능을 통해 얼굴이 있는지 확인할 수 있으며, 미리보기를 통해 내 영상에 적용된 결과를 확인해 볼 수 있습니다.
립싱크는 더빙과 별개로 전체 영상 생성 시마다 건별로 청구됩니다. 수정 후 새로운 립싱크 버전을 생성하는 경우 립싱크 요금이 다시 청구됩니다.
네. 모든 계정의 무료 크레딧에는 1분의 립싱크 시간이 포함되어 있습니다. 체험 실행 옵션을 켜서 영상 1분을 먼저 동기화하고 결과를 확인해 보세요. 크레딧 조회 메뉴에서 남은 무료 립싱크 시간을 확인할 수 있습니다.
네. 영상에 두 명 이상의 출연자가 나온다면 프로젝트에서 화자 수(num_speakers)를 설정하여 각 목소리가 올바른 사람에게 연결되도록 하세요. 설정하지 않아도 Rask AI가 자동으로 화자를 찾아냅니다.
GET /v3/projects/{project_id}/lipsync returns the state: video_has_face, whether a free trial run is available, and the latest job. Starting lip-sync returns a job that reports its stage, progress and queue position, and GET /v3/jobs/{job_id}?wait_seconds=20 returns the moment it is done.
처리 시간은 동영상의 길이와 입모양 맞춤 대기열 상태에 따라 다릅니다. 대기열 순서와 진행률 값을 통해 사용자에게 작업이 어디쯤 진행되었는지 정확하게 보여줄 수 있습니다.
립싱크는 더빙 버전마다 한 번씩 생성됩니다. 텍스트, 타임스탬프, 화자 또는 목소리를 변경한 후 프로젝트를 재더빙하고 작업이 완료될 때까지 기다린 후 립싱크를 다시 실행하세요. 새로운 립싱크 생성 비용은 별도로 계산되어 청구됩니다. 한 번 완료된 얼굴 확인은 다시 실행할 필요가 없습니다.
작업 상태가 실패로 표시되면 오류 내용을 확인하시고, 지원이 필요하신 경우 project_id와 함께 [email protected]로 문의해 주세요.
API 접근 권한은 Creator Pro, Business, Enterprise 요금제에서 이용할 수 있으며, 기능은 요금제에 따라 다릅니다. 앱에서 API 키를 생성하고 즉시 사용을 시작할 수 있습니다. Enterprise 계약 조건, 대량 할인 및 맞춤형 언어 지원은 저희 팀으로 문의해 주세요.