Sincronización de labios

Los trabajos de sincronización labial combinan un vídeo fuente y una pista de audio en un vídeo resultante sincronizado. El punto final es asíncrono porque el procesamiento de vídeo puede tardar más que una solicitud HTTP normal.

Crear trabajo

POST /api/open/v1/media/lip-sync/jobs
Authorization: Bearer FISHAUDIO_API_KEY
Content-Type: application/json

Pedido

{
  "videoUrl": "https://example.com/video.mp4",
  "audioUrl": "https://example.com/audio.mp3"
}

El servicio API debe poder acceder a ambas URL. Utilice URL firmadas de corta duración para medios privados y manténgalas válidas el tiempo suficiente para que el trabajador descargue los archivos.

curl https://fishaudio.org/api/open/v1/media/lip-sync/jobs \
  -H "Authorization: Bearer FISHAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"videoUrl":"https://example.com/video.mp4","audioUrl":"https://example.com/audio.mp3"}'

Respuesta

{
  "success": true,
  "message": "Job created",
  "data": {
    "id": "job_123",
    "status": "queued"
  }
}

Conserve la identificación del trabajo antes de actualizar el estado visible para el usuario. Si el navegador se cierra, su servidor aún debería poder sondear y adjuntar el resultado final al proyecto original.

Listar trabajos

GET /api/open/v1/media/lip-sync/jobs?page=1&limit=20&status=completed
Authorization: Bearer FISHAUDIO_API_KEY

Los filtros compatibles incluyen page, limit y status. Utilice la lista para la recuperación administrativa y el historial del proyecto, no como un ciclo de sondeo de alta frecuencia.

conseguir trabajo

GET /api/open/v1/media/lip-sync/jobs/{jobId}
Authorization: Bearer FISHAUDIO_API_KEY

Los trabajos completados incluyen metadatos de resultados en data. Los trabajos fallidos incluyen un código o mensaje de error. Mantenga los estados terminales inmutables en su propia base de datos para que los sondeos repetidos no reescriban los registros de resultados históricos.

Facturación y créditos

El trabajo de sincronización labial generalmente se cobra según el trabajo aceptado o la duración del procesamiento completado. Valide la duración del video y del audio antes de enviarlo y evite crear automáticamente un segundo trabajo cuando se agote el tiempo de espera de una solicitud de encuesta.

Si los usuarios pueden iniciar muchos trabajos, aplique su propia cola y límite de simultaneidad. Utilice Perfil para detectar un saldo bajo antes de aceptar lotes costosos.

Errores