Lippensynchronisation

Lippensynchronisationsjobs kombinieren ein Quellvideo und eine Audiospur zu einem synchronisierten Ergebnisvideo. Der Endpunkt ist asynchron, da die Videoverarbeitung länger dauern kann als eine normale HTTP-Anfrage.

Job erstellen

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

Anfrage

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

Beide URLs müssen für den API-Dienst erreichbar sein. Verwenden Sie kurzlebige signierte URLs für private Medien und halten Sie diese lange genug gültig, damit der Mitarbeiter die Dateien herunterladen kann.

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"}'

Antwort

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

Behalten Sie die Job-ID bei, bevor Sie den für den Benutzer sichtbaren Status aktualisieren. Wenn der Browser geschlossen wird, sollte Ihr Backend immer noch in der Lage sein, das Endergebnis abzufragen und an das ursprüngliche Projekt anzuhängen.

Jobs auflisten

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

Zu den unterstützten Filtern gehören page, limit und status. Verwenden Sie die Auflistung für die Back-Office-Wiederherstellung und den Projektverlauf, nicht als hochfrequente Abfrageschleife.

Job bekommen

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

Abgeschlossene Jobs enthalten Ergebnismetadaten in data. Fehlgeschlagene Jobs enthalten einen Fehlercode oder eine Fehlermeldung. Halten Sie die Terminalzustände in Ihrer eigenen Datenbank unveränderlich, sodass wiederholte Abfragen historische Ergebnisdatensätze nicht neu schreiben.

Abrechnung und Gutschriften

Lippensynchronisationsarbeiten werden in der Regel nach angenommenem Auftrag oder abgeschlossener Bearbeitungsdauer abgerechnet. Überprüfen Sie die Video- und Audiolänge vor der Übermittlung und vermeiden Sie die automatische Erstellung eines zweiten Auftrags, wenn bei einer Umfrageanfrage das Zeitlimit überschritten wird.

Wenn Benutzer viele Jobs starten können, erzwingen Sie Ihre eigene Warteschlange und Ihr eigenes Parallelitätslimit. Verwenden Sie Profil, um einen niedrigen Kontostand zu erkennen, bevor Sie teure Chargen akzeptieren.

Fehler