Einführung
Vidu Q3 Spicy Videoverlängerung setzt einen Clip fort, den Sie bereits haben. Senden Sie ihn als video_url, mit oder ohne Prompt dafür, was als Nächstes passiert. Das letzte Bild Ihres Clips wird zum Startbild einer neuen Vidu Q3 Spicy-Bild-zu-Video-Einstellung von 1 bis 16 Sekunden, und beide werden zu einer MP4 verbunden: zuerst Ihr Original, dann die Fortsetzung, das doppelte Bild an der Naht entfällt. Das neue Segment kommt zusätzlich als eigene Datei zurück, sodass Sie weiter verlängern oder die Teile getrennt bearbeiten können.
Wichtige Funktionen und Highlights
Die Kontinuität kommt vom letzten Bild. Kleidung, Szenerie, Licht und die Position aller Personen bleiben erhalten, weil das neue Segment buchstäblich auf Ihrem letzten Bild beginnt. Die Bewegung geht nicht auf dieselbe Weise über: Das Modell sieht ein Standbild, nicht den ganzen Clip. Beschreiben Sie daher die Bewegung, die weiterlaufen soll, statt anzunehmen, dass Tempo oder Richtung erhalten bleiben.
Eine Datei zurück, dazu das neue Stück allein. Die verbundene MP4 behält Bildrate und Bildausschnitt Ihres Clips, ohne schwarze Balken. Damit die Naht sauber sitzt, kann das Bild an den Rändern um einige Prozent beschnitten oder angepasst werden. Liefert das Modell ein deutlich anderes Seitenverhältnis, wird das neue Segment so skaliert, dass es Ihr Bild ausfüllt, mittig ausgerichtet und an den überstehenden Rändern beschnitten. Die Datei wird als H.264-MP4 mit AAC-Ton kodiert. Der Ton Ihrer Quelle bleibt erhalten, der für das neue Segment generierte Ton schließt sich an, und eine stumme Seite wird mit Stille aufgefüllt, damit Bild und Ton an der Naht im Takt bleiben. Das zweite Asset der Ausgabe ist das neue Segment allein, bereit für eine weitere Verlängerung oder für einen Editor.
Alles andere ist Vidu Q3 Spicy Bild-zu-Video. Das neue Segment läuft über dieselben Routen, mit demselben Inhaltsrahmen und demselben Sekundenpreis wie der Bild-zu-Video-Endpunkt, und eine fehlgeschlagene Generierung wird genauso erstattet. Gelingt die Generierung, aber die Verbindung selbst kann nicht erstellt werden, schlägt die Aufgabe fehl und die Gebühr wird erstattet.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
video_url | Ja | Der Clip, der fortgesetzt werden soll: MP4, MOV oder WebM, bis zu 60 Sekunden. mindestens 1 Zeichen |
prompt | Nein | Optional. Was als Nächstes passiert: die folgende Handlung, die Kamerabewegung und der Ton. |
duration_seconds | Nein | Länge des neuen Segments: eine ganze Zahl von 1 bis 16. Standard ist 5. |
resolution | Nein | Schärfe des erzeugten neuen Segments: 540p, 720p oder 1080p, Standard 720p. |
movement_amplitude | Nein | Wie stark sich Dinge im neuen Segment bewegen: |
generate_audio | Nein | Standardmäßig an, das neue Segment erhält also generierten Ton. Standardwert: |
bgm | Nein | Legt einen Musikteppich unter das neue Segment. Standardmäßig an; schalten Sie ihn aus, wenn nur der Ton der Szene bleiben soll. Standardwert: |
Preis
Berechnet wird jede Sekunde des neuen Segments in der gewählten Auflösung; der gesendete Originalclip wird nicht berechnet.
| Spezifikation | Preis |
|---|---|
| $0.0665 / Sekunde |
| $0.1425 / Sekunde |
| $0.152 / Sekunde |
Anwendungsfälle
Verlängern Sie eine Einstellung, die zu früh endete: einen Produktdrehteller, der anhält, bevor das Etikett zur Kamera zeigt, oder einen Gang, der schneidet, bevor die Person die Tür erreicht. Verlängern Sie um ein paar Sekunden und beschreiben Sie nur die verbleibende Bewegung.
Bauen Sie eine längere Sequenz Schritt für Schritt auf. Erzeugen Sie eine erste Einstellung, verlängern Sie sie und verlängern Sie das verbundene Ergebnis erneut, solange es innerhalb der Quellgrenze von 60 Sekunden bleibt; jeder Schritt berechnet nur die Sekunden, die er hinzufügt. Da jeder Schritt von einem einzelnen Bild ausgeht, prüfen Sie jede Naht, bevor Sie die nächste aufsetzen.
Prompt-Leitfaden und Praxistipps
Schreiben Sie nur dann einen Prompt, wenn Sie die Fortsetzung lenken möchten; eine kurze Zeile zum nächsten Takt genügt. Das Bild legt bereits fest, wer und wo, also nutzen Sie den Prompt für die folgende Handlung, die Kamerabewegung und den Ton. Wiederholen Sie die Kamerasprache, mit der Ihr Clip endete, etwa einen langsamen Zoom nach vorn oder eine feste Einstellung, damit die Naht wie eine einzige Einstellung wirkt.
Schneiden Sie vor dem Verlängern zu. Das letzte Bild ist das Einzige, was das Modell sieht, ein unscharfes, mitten im Schnitt liegendes oder stark komprimiertes Ende setzt sich daher direkt in der Fortsetzung fort. Schneiden Sie Ihre Quelle zuerst auf einem sauberen, scharfen Bild. Quellen bis 60 Sekunden werden als MP4, MOV oder WebM akzeptiert.
Halten Sie die Auflösung konsistent. Die Auflösung bestimmt nur, wie scharf das neue Segment erzeugt wird; eine niedrigere Stufe lässt den neuen Teil daher weicher wirken als das Original. Passen Sie die Auflösung an Ihr Original an und setzen Sie duration_seconds auf die Länge, die Sie wirklich brauchen: Berechnet wird nur das neue Segment.
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": "vidu/q3-spicy/video-extend",
"input": {
"duration_seconds": 5,
"movement_amplitude": "auto",
"resolution": "720p",
"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.
