Einführung
Was dieser Endpunkt macht
Er nimmt ein Video und liefert eine Kopie, in der bis zu drei Gesichter pro Bild, das größte zuerst, wiederhergestellt und geschärft sind. Das Ergebnis bleibt von Bild zu Bild stabil. Bewegung, Bildausschnitt, Länge und die ursprüngliche Tonspur bleiben erhalten, und die Auflösung ändert sich nicht. Es gibt keinen Prompt.
Wichtige Eingaben
video_url ist der Clip: ein MP4-Upload oder eine öffentliche URL, 3 Sekunden bis 5 Minuten lang. Clips außerhalb dieses Bereichs werden abgelehnt, bevor etwas berechnet wird. Wählen Sie ein reales, gut sichtbares Gesicht, das im Ausgangsbild genügend Raum einnimmt; die Gesichtsrestaurierung über alle Frames mit Video Face Enhancer profitiert davon stärker als von einem entfernten oder verdeckten Gesicht.
Was Sie zurückbekommen
Pro Anfrage ein Video in der Auflösung, Bildrate und Länge, die Sie gesendet haben, mit Ihrer Tonspur, nach Abschluss der Aufgabe aus dem Plattformspeicher ausgeliefert. Für mehr Pixel nutzen Sie /models/video-upscaler-v1.
| Feld | Wert |
|---|---|
| Eingabe | Video |
| Ausgabe | Video |
| Endpunkt | Videobearbeitung |
| Gesichter | Bis zu drei pro Bild, das größte zuerst |
| Einstellungen | Kein Prompt – der Clip ist die ganze Anfrage |
| Abrechnung | Pro Sekunde des Eingabeclips, Mindestabrechnung 3 Sekunden |
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
video_url | Ja | Der Clip zur Wiederherstellung: ein MP4-Upload oder ein öffentlicher Link, 3 Sekunden bis 5 Minuten lang. mindestens 1 Zeichen |
Preis
$0.012 / Ausgabesekunde
Abgerechnet wird pro Sekunde des Eingabeclips, auf die nächste volle Sekunde aufgerundet, mit einer Mindestabrechnung von 3 Sekunden. Ein Upload wird mit seiner eigenen Länge vorgemerkt, eine URL bis zum Maximum von 5 Minuten, bis das Video geliefert ist; die Differenz wird danach freigegeben. Fehlgeschlagene Anfragen werden nicht abgerechnet.
Anwendungsfälle
Podcast- und Interview-Clips
Für den Upload stark komprimierte Sprecher-Aufnahmen verlieren das Detail zuerst im Gesicht. Einmal durchlaufen lassen, um Augen, Zähne und Haaransatz zurückzuholen, während Raum, Bildausschnitt und Ton gleich bleiben.
Alte oder stark komprimierte Aufnahmen
Clips, die mehrfach gespeichert, geteilt und neu kodiert wurden, wirken um das Gesicht herum weich und blockig. Pro Bild werden bis zu drei Gesichter wiederhergestellt; ein Clip mit ein oder zwei klar erkennbaren Sprechern passt daher am besten.
Material, das Sie später vergrößern wollen
Bereinigen Sie zuerst die Gesichter und nutzen Sie dann Video Upscaler unter /models/video-upscaler-v1, wenn der Clip für einen größeren Bildschirm außerdem mehr Pixel braucht.
Prompt-Leitfaden und Praxistipps
Clip prüfen
Ein MP4 zwischen 3 Sekunden und 5 Minuten, mit echten menschlichen Gesichtern, die ausreichend groß und klar sichtbar sind. Schneiden Sie es vorher auf den benötigten Teil zu.
video_urlsendenvideo_urlist ein MP4-Upload oder ein öffentlicher Link. Es ist das einzige Feld: Es gibt keinen Prompt und nichts einzustellen.Abfragen, dann vergleichen
Der Aufruf ist asynchron: Aufgabe anlegen, bis zum Abschluss abfragen und das Video aus dem Plattformspeicher herunterladen. Vergleichen Sie es in normaler Geschwindigkeit und auf einem angehaltenen Bild mit Ihrer Quelle, und prüfen Sie, ob der Ton intakt ist.
Einführung
Video Face Enhancer stellt die Gesichter in jedem Bild eines Clips wieder her und schärft sie. Sie senden video_url; das Tool findet pro Bild bis zu drei Gesichter, das größte zuerst, baut die Details wieder auf, die starke Kompression oder Unschärfe gekostet haben, und hält das Ergebnis von einem Bild zum nächsten stabil. Bewegung, Bildausschnitt, Länge und die ursprüngliche Tonspur bleiben wie zuvor, und der Clip kommt in der Auflösung zurück, die Sie gesendet haben. Akzeptiert werden MP4-Dateien von 3 Sekunden bis 5 Minuten Länge; einen Prompt gibt es nicht.
Hauptfunktionen und Besonderheiten
Gesichter in jedem Bild bereinigt
Die Wiederherstellung läuft auf dem gesamten Clip, nicht auf einem einzelnen Standbild. In unserem Test nahmen wir einen 5 Sekunden langen Clip mit 640×360 von einer Podcast-Moderatorin und verschlechterten ihn mit starker H.264-Kompression. Er kam mit 640×360 und 24 fps zurück, weiterhin 5,0 Sekunden lang, nach rund 21 Sekunden Bearbeitungszeit. Augen, Zähne und Haaransatz waren in jedem Bild schärfer und flackerten nicht, und die Moderatorin war weiterhin eindeutig dieselbe Person.
Alles andere bleibt, wie es war
Ton, Bewegung, Bildausschnitt und Länge bleiben erhalten, und der Bereich um die Gesichter bleibt unberührt: Der Raum hinter der Moderatorin blieb unverändert. Das Tool vergrößert das Video nicht. Wenn Sie außerdem mehr Pixel brauchen, nutzen Sie Video Upscaler (/models/video-upscaler-v1).
Die Abrechnung folgt der Clip-Länge
Abgerechnet wird pro Sekunde des Eingabeclips, auf die nächste volle Sekunde aufgerundet, mit einer Mindestabrechnung von 3 Sekunden. Clips, die kürzer als 3 Sekunden oder länger als 5 Minuten sind, werden abgelehnt, bevor etwas berechnet wird. Ist der Clip ein Upload, dessen Länge sich auslesen lässt, wird genau diese Länge vorgemerkt; bei einer URL wird bis zur Lieferung das Maximum von 5 Minuten vorgemerkt, und die Differenz wird danach freigegeben. Fehlgeschlagene Anfragen werden nicht abgerechnet.
Anwendungsfälle
Podcast- und Interview-Clips
Sprecher-Aufnahmen, die für den Upload stark komprimiert wurden, verlieren das Detail zuerst im Gesicht. Lassen Sie den Clip einmal durchlaufen, um Augen, Zähne und Haaransatz zurückzuholen, während Raum, Kamerabildausschnitt und Ton gleich bleiben.
Alte oder stark komprimierte Aufnahmen
Clips, die mehrfach gespeichert, geteilt und neu kodiert wurden, wirken um das Gesicht herum weich und blockig. Pro Bild werden bis zu drei Gesichter wiederhergestellt, das größte zuerst; ein Clip mit ein oder zwei klar erkennbaren Sprechern passt daher am besten.
Material, das Sie später vergrößern wollen
Bereinigen Sie zuerst die Gesichter und nutzen Sie dann Video Upscaler (/models/video-upscaler-v1), wenn der Clip für einen größeren Bildschirm außerdem mehr Pixel braucht.
Prompt-Leitfaden und Praxistipps
Kein Prompt: den Clip wählen
Die einzige Eingabe ist video_url, ein MP4-Upload oder ein öffentlicher Link, 3 Sekunden bis 5 Minuten lang. Schneiden Sie den Clip vor dem Senden auf den benötigten Teil zu, weil sich die Abrechnung nach der Länge dessen richtet, was Sie senden.
Gesichter wählen, die sich rekonstruieren lassen
Wählen Sie ein reales, gut sichtbares Gesicht, das im Ausgangsbild genügend Raum einnimmt; die Gesichtsrestaurierung über alle Frames mit Video Face Enhancer profitiert davon stärker als von einem entfernten oder verdeckten Gesicht. Video Face Enhancer findet weniger Gesichtsdetails zum Rekonstruieren, wenn die Vorlage gezeichnet ist oder das Gesicht winzig, verdeckt oder stark unscharf ist; das begrenzt die Gesichtsrestaurierung über alle Frames mit Video Face Enhancer. Zeigt ein Clip mehr als drei Gesichter gleichzeitig, werden die drei größten wiederhergestellt, der Rest bleibt unverändert.
Das Ergebnis mit der Quelle vergleichen
Sehen Sie sich die Ausgabe in normaler Geschwindigkeit und auf einem angehaltenen Bild an, und prüfen Sie neben den Gesichtern auch Ton, Länge und Bildrate. Die Bildversion dieses Tools ließ die Haut etwas glatter wirken, als sie bei einem echten Foto wäre; achten Sie deshalb bei bewegten Gesichtern auf dieselbe Weichzeichnung. Der Hintergrund wird nicht berührt, dort bleiben also etwaige Kompressionsblöcke erhalten. Bewahren Sie die Quelldatei auf.
API-Schnellstart
# 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": "spicyapi/face-enhancer-video-v1/video-edit",
"input": {
"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"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.
