# 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



Importez la vidéo d'origine ou envoyez une URL publique, créez un projet avec une langue cible et attendez que l'opération réussisse. La synchronisation labiale nécessite la vidéo doublée générée par ce projet.
La tâche de vérification du visage confirme qu'au moins un visage est présent dans la vidéo. Elle démarre généralement automatiquement. Si ce n'est pas le cas, lancez-la vous-même une fois pour le projet.
Lancez la tâche de synchronisation labiale, suivez sa progression de 0 à 100, puis téléchargez la vidéo depuis les fichiers de sortie du projet.
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 et es-es de même. Les enregistrements du projet glossary.version, de sorte que les modifications ultérieures ne modifient jamais le travail terminé sans que vous le sachiez.Oui. L'API de synchronisation labiale de Rask fonctionne sur n'importe quelle vidéo doublée par votre projet. Vérifiez que la vidéo contient un visage, estimez le coût de la tâche avec POST \/v3\/projects\/{project_id}\/lipsync\/estimate, lancez-la et téléchargez la vidéo synchronisée une fois l'opération terminée. L'authentification utilise une seule clé API, l'intégration suit donc le même principe que le reste de l'API Rask.
La synchronisation labiale s'applique à une vidéo traduite. Créez et dubbez votre projet d'abord, puis lancez la synchronisation une fois que l'opération a réussi et que le projet propose une vidéo doublée dans ses fichiers de sortie.
La synchronisation labiale utilise l'audio doublé du projet. Pour utiliser vos propres mots, modifiez le texte traduit ou créez la transcription à partir de votre propre fichier .srt, redoublez le projet, puis lancez la synchronisation labiale sur la nouvelle version.
Rask synchronise les mouvements des lèvres sur de véritables séquences de vrais interlocuteurs dans votre vidéo d'origine. La génération d'avatars parlants, d'humains numériques et de vidéos par IA à partir d'une image ou d'une consigne textuelle relève d'une autre catégorie de produits, pour laquelle un outil de génération de vidéo par IA est plus adapté.
Utilisez des images où le visage qui parle est bien visible, avec un bon éclairage et une bouche dégagée. Évitez les profils trop marqués et tout ce qui cache les lèvres, comme un micro, une main ou des sous-titres. La vérification du visage confirme qu'un visage est présent ; utilisez l'aperçu pour évaluer le résultat sur vos images.
La synchronisation labiale est facturée séparément du doublage pour chaque génération de vidéo complète. La création d'une nouvelle version synchronisée après des modifications entraîne des frais supplémentaires.
Oui. Chaque compte dispose d'une minute de synchronisation labiale gratuite incluse dans ses crédits gratuits. Lancez la tâche en activant free_trial_run pour synchroniser une minute de votre vidéo et la vérifier. L'endpoint des crédits l'affiche sous le nom de lipsync_free_minutes.
Oui. Définissez num_speakers sur le projet lorsque plusieurs personnes parlent à l'écran, afin d'associer chaque voix au bon interlocuteur. Si vous ne le faites pas, Rask détectera les intervenants automatiquement.
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.
Le temps de traitement varie selon la longueur de la vidéo et la file d'attente. La position dans la file d'attente et la valeur de progression vous permettent d'indiquer précisément à vos utilisateurs où en est la tâche.
La synchronisation labiale est générée une seule fois par version doublée. Si vous modifiez le texte, les repères temporels, les intervenants ou les voix, effectuez un nouveau doublage, attendez la fin de l'opération et relancez la synchronisation labiale. Le coût de cette nouvelle génération est estimé et facturé séparément. La vérification du visage n'a pas besoin d'être effectuée à nouveau.
Si le statut de la tâche indique un échec, consultez le message d'erreur et contactez [email protected] en indiquant votre project_id si vous avez besoin d'aide de notre équipe.
L'accès à l'API est disponible sur les abonnements Creator Pro, Business et Enterprise, avec des fonctionnalités qui dépendent de votre formule. Vous créez une clé API dans l'application et vous pouvez commencer immédiatement. Pour les conditions Enterprise, la tarification par volume et la prise en charge de langues personnalisées, contactez notre équipe.