Синхронизация губ

Задания синхронизации губ объединяют исходное видео и аудиодорожку в синхронизированное итоговое видео. Конечная точка является асинхронной, поскольку обработка видео может занять больше времени, чем обычный запрос HTTP.

Создать задание

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

Запрос

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

Оба URL-адреса должны быть доступны службе API. Используйте недолговечные подписанные URL-адреса для частных носителей и сохраняйте их действительными достаточно долго, чтобы работник мог загрузить файлы.

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

Ответ

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

Сохраните идентификатор задания перед обновлением состояния, видимого пользователю. Если браузер закроется, ваша серверная часть все равно сможет опросить и прикрепить окончательный результат к исходному проекту.

Список вакансий

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

Поддерживаемые фильтры: page, limit и status. Используйте листинг для восстановления бэк-офиса и истории проекта, а не как высокочастотный цикл опроса.

Получить работу

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

Завершенные задания включают метаданные результатов в data. Невыполненные задания содержат код ошибки или сообщение. Сохраняйте неизменяемые состояния терминалов в вашей собственной базе данных, чтобы повторный опрос не перезаписывал записи исторических результатов.

Выставление счетов и кредиты

За работу с синхронизацией губ обычно взимается плата в зависимости от принятого задания или продолжительности завершенной обработки. Проверяйте длину видео и аудио перед отправкой и избегайте автоматического создания второго задания по истечении времени запроса на опрос.

Если пользователи могут запускать множество заданий, установите собственную очередь и ограничение параллелизма. Используйте Профиль, чтобы обнаружить низкий баланс, прежде чем принимать дорогостоящие партии.

Ошибки