Einführung
Einen festen Bereich über das gesamte Video hinweg mit einer Bildmaske entfernen, bei der Weiß den zu löschenden und Schwarz den zu erhaltenden Bereich markiert. Eine optionale Anweisung beschreibt die lokale Entfernung; dieselbe Maske gilt für den gesamten Clip.
| Feld | Wert |
|---|---|
| Eingabe | Video |
| Ausgabe | Video |
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
video_url | Ja | Das vollständig zu verarbeitende Video mit einer Länge von 1 bis 600 Sekunden. Der ausgewählte Bereich wird über den gesamten Clip verarbeitet. mindestens 1 Zeichen |
mask_url | Ja | Ein statisches PNG-Bild, das am Videobild ausgerichtet ist. Färben Sie den zu entfernenden Bereich weiß und den restlichen Bereich schwarz. mindestens 1 Zeichen |
prompt | Nein | Optionale Anweisung zur lokalen Entfernung. Sie wählt keinen Zeitraum aus und aktiviert keine Verfolgung. |
Preis
$0.024 / Sekunde
Die Abrechnung erfolgt nach dem gesamten Eingabeclip, auf ganze Sekunden aufgerundet und mit einer Mindestabrechnungsdauer von 3 Sekunden. Dieser Endpunkt akzeptiert Clips von 1 bis 600 Sekunden; die Maskengröße verkürzt die Dauer nicht.
Anwendungsfälle
Video → Videobearbeitung → Video
Videobearbeitung
Video
Asynchroner Auftrag
Prompt-Leitfaden und Praxistipps
Einführung
Video Eraser entfernt Inhalte innerhalb einer statischen Bildmaske über einen gesamten Videoclip hinweg. Senden Sie video_url und mask_url, optional zusammen mit einem kurzen prompt, der die Entfernung beschreibt. Das eignet sich für ein festes Untertitelband oder ein anderes unerwünschtes Element, das im selben Bildschirmbereich bleibt. Der resultierende Hintergrund ist eine erschlossene Füllung und keine Wiederherstellung verdeckter Originalpixel.
Hauptfunktionen und Besonderheiten
Ein fester Bereich für den gesamten Clip
Die Maske ist ein Standbild: Weiß markiert den zu löschenden Bereich, Schwarz den zu erhaltenden. Derselbe Bildschirmbereich gilt für das gesamte übergebene Video. Es gibt weder ein Startzeitfeld noch ein Endzeitfeld oder eine Steuerung zur Verfolgung bewegter Objekte. Ein Untertitel, der sich außerhalb des weißen Bereichs bewegt, wird von dieser Maske nicht erfasst. Auch Inhalte, die den ausgewählten Bereich durchqueren, können durch die Füllung verändert werden.
Eine optionale Beschreibung zur Maske
Eine kurze Beschreibung kann verdeutlichen, was entfernt werden soll und was es umgibt. Bei diesem Endpunkt bleibt die Maske erforderlich, damit der Bereich eindeutig festgelegt ist. Die Verarbeitung wird nach dem vollständigen Eingabeclip abgerechnet, auf ganze Sekunden aufgerundet und mit einer Mindestabrechnungsdauer von 3 Sekunden. Akzeptierte Quellclips sind 1 bis 600 Sekunden lang. Eine kleinere Maske verkürzt die abgerechnete Videodauer nicht.
Anwendungsfälle
Ein festes Untertitelband entfernen
Markieren Sie bei bereits in Ihr eigenes Filmmaterial eingebrannten Untertiteln das Untertitelband und prüfen Sie jeden Abschnitt, in dem Text erscheint. Ein statischer Hintergrund ist ein guter Ausgangspunkt zur Prüfung des Ergebnisses. Sind die Untertitel im Projekt noch bearbeitbare Textebenen, entfernen Sie diese Ebenen direkt, bevor Sie sich für eine Pixelrekonstruktion entscheiden.
Eine unbewegte Einblendung entfernen
Verwenden Sie eine eng anliegende Maske für eine unerwünschte Einblendung in der Ecke des Materials, das Sie bearbeiten. Prüfen Sie Bilder, in denen eine Person oder ein Produkt hinter dem ausgewählten Bereich vorbeizieht oder eine Kamerabewegung den Hintergrund dort verändert. In solchen Momenten muss die Füllung wechselnde Inhalte erschließen; dabei können Flimmern oder verzerrte Kanten sichtbar werden, die in einem einzelnen Vorschaubild nicht auffallen.
Prompt-Leitfaden und Praxistipps
Eine eindeutige Maske erstellen
Erstellen Sie eine am Quellbild ausgerichtete PNG-Maske: innerhalb des zu entfernenden Bereichs weiß, außerhalb schwarz. Prüfen Sie die Position vor dem Absenden am ersten, mittleren und letzten Bild. Vermeiden Sie unnötig große weiße Bereiche, besonders wenn sie ein Gesicht oder ein wichtiges Produktdetail überlagern. Die Maske ist statisch und wirkt auf den gesamten Clip; sie kann weder bewegten Untertiteln folgen noch die Bearbeitung auf einen ausgewählten Zeitraum begrenzen.
Die lokale Bearbeitung beschreiben und das Ergebnis vergleichen
Eine optionale Anweisung wie „Das feste Untertitelband entfernen und mit dem umgebenden Hintergrund füllen“ beschreibt die gewünschte Änderung, ohne eine neue Szene zu erfinden. Vergleichen Sie die Ausgabe mit dem Original bei normaler Wiedergabegeschwindigkeit und rund um schwierige Bewegungen auch Bild für Bild. Prüfen Sie neben dem gelöschten Bereich auch nicht maskierte Bereiche, Cliplänge, Bildrate und Ton. Der Erhalt des Originaltons und der pixelgenaue Erhalt außerhalb der Maske wurden nicht verifiziert. Bewahren Sie deshalb 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/video-eraser-v1/video-edit",
"input": {
"mask_url": "https://example.com/reference.png",
"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.