Einführung
Isolieren Sie den Vordergrund eines vorhandenen Clips und wählen Sie Transparenz oder einen einfarbigen Hintergrund. Standardmäßig wird transparentes WebM VP9 mit Originalton angefordert.
| Feld | Wert |
|---|---|
| Eingabe | Video |
| Ausgabe | Video |
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
video_url | Ja | Quellclip von 1 bis 60 Sekunden. Die Ausgabe isoliert den erkannten Vordergrund; eine Steuerung des Bildausschnitts gibt es nicht. mindestens 1 Zeichen |
background | Nein | Wählen Sie Transparenz oder eine von zehn Volltonfarben. Eine transparente Ausgabe erfordert ein Format mit Alpha-Unterstützung. |
output_format | Nein | Voreinstellung für Container und Codec. Standard ist WebM VP9. |
keep_original_audio | Nein | Fordert den Originalton in der Ausgabe an; standardmäßig aktiviert. Für einen stummen Clip deaktivieren. Standardwert: |
Preis
$0.06 / Sekunde
Abgerechnet wird pro Sekunde des Eingabevideos, auf volle Sekunden aufgerundet. Dieser Endpunkt akzeptiert Clips von 1 bis 60 Sekunden. Die Auswahl von Hintergrund, Format und Ton ändert diese Dauerregel nicht.
Anwendungsfälle
Video → Videobearbeitung → Video
Videobearbeitung
Video
Asynchroner Auftrag
Prompt-Leitfaden und Praxistipps
Einführung
Der Video-Hintergrundentferner isoliert den Vordergrund eines vorhandenen Videos für Compositing oder die Platzierung auf einem einfarbigen Hintergrund. Senden Sie video_url und wählen Sie Hintergrund und Exportformat. Die Standardanfrage fordert transparentes WebM VP9 an und behält den Originalton bei. Dieser Endpunkt akzeptiert Quellclips von 1 bis 60 Sekunden; er erzeugt keine neue Szene aus einem Prompt.
Hauptfunktionen und Besonderheiten
Transparenz wird über Hintergrund und Format gewählt
Setzen Sie background auf transparent und verwenden Sie ein Format mit Alpha-Unterstützung. WebM VP9, MOV ProRes 4444, MKV VP9 und GIF sind als Alpha-Optionen dokumentiert. Die MP4-Voreinstellungen und die MKV-Voreinstellungen für H.264 oder H.265 enthalten hier keinen Alphakanal; inkompatible Anfragen für transparente Ausgaben können abgelehnt werden. Für MOV H.265 ist nur teilweise Unterstützung dokumentiert. Verwenden Sie daher WebM VP9 für den standardmäßigen transparenten Workflow und prüfen Sie die tatsächliche Ausgabe vor dem Compositing.
Volltonfarben und Originalton
Alternativ können Sie Schwarz, Weiß, Grau, Rot, Grün, Blau, Gelb, Cyan, Magenta oder Orange wählen. keep_original_audio steuert, ob der Quellton im Ergebnis angefordert wird. GIF kann keine Tonspur enthalten; deaktivieren Sie die Tonerhaltung, wenn Sie dieses Format wählen. Die Auswahl von Container, Codec und Hintergrund ändert die dauerabhängige Abrechnungsregel nicht. Für die Abrechnung werden die Eingabesekunden aufgerundet. Dieser Endpunkt bietet keine Steuerung des Bildausschnitts oder der Ausgabeauflösung.
Anwendungsfälle
Einen Vortragenden über einer Präsentation platzieren
Beginnen Sie mit einem kurzen Clip, in dem der Vortragende klar vom Hintergrund getrennt ist. Fordern Sie transparentes WebM VP9 an und platzieren Sie das Ergebnis anschließend in einem Editor, der dieses Format unterstützt, über der Folie oder Szene. Prüfen Sie Haare und durch Bewegung unscharfe Kanten vor der Veröffentlichung der Komposition sowohl vor dunklen als auch vor hellen Hintergründen.
Einen Produktclip für ein neues Layout vorbereiten
Trennen Sie ein Produkt von seiner ursprünglichen Umgebung, um das Videomaterial in einem Kataloglayout oder einem Social-Media-Schnitt wiederzuverwenden. Ein Export mit Volltonfarbe kann sinnvoll sein, wenn Transparenz nicht erforderlich ist. Reflektierende Oberflächen und feine Kanten müssen sorgfältig geprüft werden: Das Ergebnis ist eine verarbeitete Maske und sollte vor dem vorgesehenen Hintergrund beurteilt werden, nicht nur anhand einer Schachbrettvorschau.
Prompt-Leitfaden und Praxistipps
Das Ausgabeformat bewusst wählen
Behalten Sie background=transparent, output_format=webm_vp9 und keep_original_audio=true für den standardmäßigen Video-Workflow bei. Wählen Sie eine andere Voreinstellung erst, nachdem Sie geprüft haben, dass Ihr Editor sie importieren kann. Die Unterstützung für Webwiedergabe variiert je nach Browser und Codec; ein erfolgreicher Download belegt nicht, dass eine eingebettete Vorschau oder eine spätere Bearbeitung funktioniert. Bewahren Sie das transparente Master auf, wenn Sie eine separate, auf einen Hintergrund reduzierte Vorschau zum Teilen erstellen.
Transparenz und den vollständigen Clip überprüfen
Prüfen Sie den tatsächlichen Alphakanal und setzen Sie das Ergebnis vor Schwarz, Weiß und eine gesättigte Farbe. Eine Datei, die ein Schachbrettmuster oder ein schwarzes Rechteck zeigt, ist kein Nachweis funktionierender Transparenz. Prüfen Sie den gesamten Bewegungsablauf auf Veränderungen an den Kanten und vergleichen Sie Dauer, Bildabmessungen und Tonsynchronisation mit dem Original. Leiten Sie das Vorhandensein eines Alphakanals nicht aus dem Dateinamen oder den gewählten Optionen ab. Für diese Integration wurde noch kein Test der Medienqualität oder Browserkompatibilität abgeschlossen; überprüfen Sie das Ergebnis mit Ihrem vorgesehenen Workflow.
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/background-remover-video-v1/video-edit",
"input": {
"background": "transparent",
"output_format": "webm_vp9",
"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.
