Ir al contenido principal

ByteDance Lip Sync es el servicio de sincronización labial de video de ByteDance, incluido en sus herramientas de traducción de video. Lite trabaja con tomas frontales de una sola persona y Basic con escenas complejas de un único hablante. Entrega MP4 a 25 fps con duración según el audio.

Desde $0.048/s

Playground

Enviar una solicitud

Inicio rápido

Los ejemplos usan las definiciones públicas de parámetros del endpoint seleccionado. Sustituye la clave de API y los medios de ejemplo, y envía la solicitud desde tu servidor.

SDK e integraciones
POSThttps://api.spicyapi.ai/api/v1/jobs/createTask

Autenticación de API

Guarda la clave de API en la variable de entorno del servidor SPICY_API_KEY. Usa autenticación Bearer y Content-Type: application/json en las solicitudes JSON.

Authorization: Bearer $SPICY_API_KEY
Resultado de ejemploUsar este ejemplo
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "bytedance/lip-sync/lip-sync",
  "input": {
    "audio_url": "https://example.com/reference.mp3",
    "generation_mode": "lite",
    "video_url": "https://example.com/reference.mp4"
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Generado a partir del esquema de entrada de este modelo: el mismo con el que la API valida cada solicitud.

Parámetros de entrada

Incluye estos campos en el objeto input del cuerpo de la solicitud. Los nombres y tipos coinciden con la API. No supongas un valor predeterminado si no está indicado.

audio_urlstringObligatorioAfecta al precio

Obligatorio para ambos perfiles, sin valor predeterminado: voz humana limpia en MP3, WAV, AAC, M4A u OGG, hasta 10 MB. Debe durar más de 1 segundo y como máximo 240 segundos en Lite o 210 en Basic. Esta duración determina los segundos facturados tras redondear hacia arriba y la duración prevista del resultado.

Valor predeterminado
Sin especificar
Restricciones
minLength:1
format:"uri"
contentMediaType:["audio/mpeg","audio/wav"]
video_urlstringObligatorio

Obligatorio en Lite y Basic, sin valor predeterminado: proporciona MOV, MP4 o MKV de 360p–1080p, 24–60 fps y 1–30 Mbps. Se recomienda H.264. Los videos superiores a 1080p se reducen a 1080p y se rechazan las entradas inferiores a 360p. Su duración no determina los segundos facturados.

Valor predeterminado
Sin especificar
Restricciones
minLength:1
format:"uri"
contentMediaType:["video/mp4","video/webm","video/quicktime"]
video_start_secondsnumberOpcional

Posición numérica inicial opcional del original en Lite; predeterminado: 0 segundos. Elige un punto de inicio dentro del video proporcionado y omite el campo en Basic. Empezar más adelante cambia la selección de imagen, pero la grabación cargada completa sigue determinando los segundos de audio facturados.

Valor predeterminado
0
Restricciones
minimum:0
maximum:3600
loop_reversebooleanOpcional

Booleano opcional de Lite; predeterminado: false. Tiene efecto con loop_video activado. El video repetido alterna entre reproducción normal y en reversa. Omítelo en Basic. Los cambios de sentido no modifican la duración del audio facturable.

Valor predeterminado
false
loop_videobooleanOpcional

Booleano opcional de Lite; predeterminado: true. Repite el video para cubrir una voz que dura más que la imagen. Omite este campo al usar Basic, incluso si trasladas ajustes de una solicitud de Lite; el audio cargado sigue siendo la base del cobro.

Valor predeterminado
true
scene_detectionbooleanOpcional

Booleano opcional de Basic; predeterminado: false. Activa la detección de escenas y el reconocimiento del hablante en su flujo para una sola persona. No lo actives en Lite: esa combinación se rechaza antes del procesamiento. No modifica la tarifa por segundo de audio.

Valor predeterminado
false
remove_background_noisebooleanOpcional

Booleano opcional de Lite; predeterminado: false. Separa el sonido de fondo de la grabación antes de sincronizar la boca. Omite el campo en Basic: esa combinación se rechaza al recibir la solicitud, una restricción basada en tres intentos fallidos de prueba en Basic. El cobro por segundos de audio no cambia.

Valor predeterminado
false
generation_modestringOpcional

Selector opcional que acepta lite o basic; predeterminado: lite. Lite trabaja con video frontal de una sola persona y Basic con escenas complejas de un único hablante. Elegir Basic cambia los controles compatibles y el límite de audio, sin diferencia de tarifa.

Valor predeterminado
"lite"
Valores permitidos
"lite""basic"

Seguir la tarea

HTTP 202 significa que la tarea se aceptó, no que haya terminado. Guarda el taskId devuelto y consulta esa tarea. No crees otra mientras esperas el resultado.

Solicitud aceptada
HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_create",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued",
    "estimatedCost": "0.750000"
  }
}

La respuesta de aceptación incluye la estimación para que tu aplicación pueda mostrar el mismo importe en el historial de tareas y en la facturación.

Consultar la tarea
curl --get "https://api.spicyapi.ai/api/v1/jobs/recordInfo" \
  --data-urlencode "taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Empieza consultando cada 2 segundos aproximadamente y ve espaciando los intentos. Párate en un estado final. Si se cae la conexión, consulta el taskId original. Vuelve a crear la tarea solo con la clave de idempotencia y el cuerpo originales.

O recibe el resultado por callback
import { verifyWebhook } from "@spicyapi/sdk";

// express.raw keeps the bytes we signed; express.json never matches.
app.post("/hooks/spicy", express.raw({ type: "application/json" }), (req, res) => {
  const { payload } = verifyWebhook({
    rawBody: req.body,
    timestamp: req.header("X-Webhook-Timestamp"),
    signature: req.header("X-Webhook-Signature"),
    payloadVersion: Number(req.header("X-Webhook-Payload-Version")),
    secret: process.env.SPICY_WEBHOOK_SECRET,
  });
  res.status(200).end();
  void handleFinishedTask(payload);
});

Pasa callBackUrl al crear la tarea y recibirás el registro terminado por POST, sin un bucle de consultas de estado. Cada entrega lleva X-Webhook-Timestamp, X-Webhook-Signature y X-Webhook-Payload-Version. La firma es un HMAC-SHA256 en base64 sobre taskId.timestamp.sha256(body), así que debes verificarla con los bytes originales: si analizas el JSON y vuelves a serializarlo, los bytes cambian y la verificación falla. Las entregas fallidas se reintentan, de modo que el mismo taskId puede llegar dos veces; haz que tu manejador sea idempotente. Responde 2xx primero y haz el trabajo después: un manejador lento se trata como una entrega fallida.

Leer el resultado

Procesa output solo cuando state sea succeeded. Si falla, consulta errorCode, errorMessage y request_id. Los costos y estados de ejemplo no representan una factura real.

Ejemplo de respuesta completada
{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_record",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "bytedance/lip-sync/lip-sync",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "key": "tasks/2026/08/28/job_01k3m8x9q2z4v7n5p6r8s0t1w3/3f7a1c9e5b2d48f0a6c1e3d5b7f9a1c3.mp4",
          "mime": "video/mp4",
          "url": "https://example.r2.cloudflarestorage.com/results/job_01k3m8x9q2z4v7n5p6r8s0t1w3/result.mp4?X-Amz-Signature=SIGNATURE_FROM_RESPONSE",
          "expiresAt": "2026-08-28T12:20:08.000Z"
        }
      ]
    },
    "cost": "0.750000",
    "settled": true,
    "createdAt": "2026-08-28T12:00:00Z",
    "completedAt": "2026-08-28T12:00:30Z"
  }
}

Para cada archivo disponible, abre o descarga assets[].url directamente, sin la cabecera Authorization de la API. El enlace firmado expira en expiresAt: vuelve a consultar la tarea para renovarlo mientras el archivo siga dentro del periodo de conservación. Un archivo pendiente o no disponible no trae URL. Trata los enlaces firmados como datos privados.

SDK e integraciones

Usa SpicyAPI en tu app, terminal, asistente de IA o flujo visual. Elige una guía de configuración.

Úsalo en ComfyUI

Instala los nodos de SpicyAPI desde ComfyUI Manager o con el comando de abajo y busca ByteDance Lip Sync · Lip Sync a Video to New Audio en el lienzo. El nodo tiene las mismas opciones que esta página y muestra su precio antes de ejecutarse.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi