01
Ein falsches Seitenverhältnis kostet still Geld
Ist die Referenz 1:1 und der Clip 16:9, muss der Endpunkt Balken setzen, beschneiden oder strecken. Passen Sie die Referenz vor dem Absenden an aspect_ratio oder resolution an.
Integrationsleitfaden
Bringen Sie ein Standbild in Bewegung, dem Sie schon vertrauen.
Bild-zu-Video nimmt die schwierigste Variable heraus – wie die Szene aussieht – und ersetzt sie durch eine engere: wie sie sich bewegen soll. Das Referenzbild leistet den größten Teil der Arbeit, deshalb rettet der Prompt eine schwache Referenz nicht.
Die Herausforderung
Das Referenzbild entscheidet den größten Teil
Bewegungs-Endpunkte erben alles aus dem ersten Bild: Bildaufbau, Licht, Seitenverhältnis, Artefakte. Eine unscharfe oder schlecht beschnittene Referenz ergibt einen unscharfen, schlecht beschnittenen Clip – zum Videotarif.
02
Manche Endpunkte nehmen auch ein Schlussbild
Wo last_image_url deklariert ist, ergeben beide Enden einen definierten Anfang und ein definiertes Ende statt eines offenen Driftens. Wo es fehlt, ergibt das Feld einen 400.
03
Bewegungsfelder gibt es nur, wo sie deklariert sind
movement_amplitude, camera_fixed, fps und duration_seconds erscheinen je Endpunkt, und das Schema markiert, welche davon den Tarif verändern. Ein gemeinsames Bewegungsvokabular darunter existiert nicht.
Der Ansatz
Erst das Bild festzurren, dann einmal für Bewegung zahlen
Erledigen Sie die Standbildarbeit auf einem Bild-Endpunkt, wo eine Iteration Cent kostet, zurren Sie das Bild fest und zahlen Sie erst dann für Bewegung. Ein bestätigter spicy://-Upload hält die Referenz über Wiederholungen byte-identisch, sodass ein neuer Lauf von genau denselben Pixeln startet.
Der Körper ist ein Erstellungsaufruf mit Bildfeld. Die Verfolgung ist identisch mit jedem anderen Medienauftrag.
POST /api/v1/jobs/createTask
POST /api/v1/jobs/createTask
Authorization: Bearer $SPICY_API_KEY
Idempotency-Key: 7b1f0c2e-9a4d-4f31-8c67-2b5e0d9a1c44
Content-Type: application/json
{
"model": "<publisher>/<model>/image-to-video",
"input": {
"prompt": "Slow push-in, fabric moving in a light breeze",
"image_url": "https://example.com/reference.png",
"duration_seconds": 5,
"resolution": "720p"
},
"callBackUrl": "https://example.com/hooks/spicyapi"
}202 Accepted
HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3
{
"code": 200,
"msg": "success",
"request_id": "req_example_create",
"data": {
"taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
"state": "queued",
"estimatedCost": "0.750000"
}
}Vertrag
Was Sie früh festhalten sollten
| Feld oder Header | Wert oder Grenze |
|---|---|
| image_url · last_image_url | declared per endpoint |
| POST /api/v1/jobs/retry | new task · source record untouched |
| state | queued · running · succeeded · failed · expired |
| audio / video upload | ≤ 100 MiB · ≤ 600 s |
Horizontal wischen, um alle Spalten zu sehen.
Integration
Vom ersten Aufruf bis in die Produktion
- 01Referenzbild im gewünschten Seitenverhältnis erzeugen oder hochladen.
- 02Im Endpunktschema image_url, duration_seconds, resolution und die deklarierten Bewegungsfelder nachlesen.
- 03Schätzen, dann mit Idempotency-Key und Callback-URL senden und die taskId mit der Referenz speichern.
- 04Beim Endzustand output.assets herunterladen und die Referenz neben dem Clip behalten, damit ein neuer Lauf möglich bleibt.
Passung
Wann dieser Weg der richtige ist
Dafür geeignet
- Die Bildsprache steht bereits in einem Standbild fest und soll Bewegung bekommen, ohne die Szene neu zu würfeln.
- Dieselbe Figur oder dasselbe Produkt muss in jedem Clip identisch aussehen.
Dafür nicht geeignet
- Die Szene existiert noch nicht. Iterationen am Standbild sind eine Größenordnung billiger als am Clip.
- Sie brauchen Kontinuität über viele Einstellungen. Diese Endpunkte liefern kurze Clips, eine Einstellung nach der anderen.
Belege
Was Sie selbst prüfen können
Referenzen verhalten sich überall gleich
HTTPS-URLs, bestätigte spicy://-Uploads und eingebettete Data-URIs funktionieren bei Bild- und Video-Endpunkten identisch, unter denselben Grenzen und denselben Annahmeprüfungen.
Ein neuer Versuch erzeugt einen neuen Auftrag
POST /api/v1/jobs/retry baut aus einem fehlgeschlagenen oder abgelaufenen Auftrag einen frischen und prüft Schema, Preis, Rechte und Verfügbarkeit neu. Der Ausgangsdatensatz bleibt unverändert.
Ein Zustandsautomat für die ganze Integration
queued, running, succeeded, failed, expired. Dieselben fünf Wörter beschreiben jeden Medien-Endpunkt, die Übergangslogik schreiben Sie einmal.
Vor dem Start
Plattformverhalten zum Bestätigen
- Seitenverhältnis der Referenz vor dem Start an die Ausgabe angleichen, nicht erst im Support.
- Die Referenz über die gesamte Auftragsdauer erreichbar halten, nicht nur beim Absenden.
- Wiederholungen einen eigenen Idempotenzbereich geben; eine Wiederholung ist ein neuer Auftrag, keine Kopie.
- Videotarife im verpflichtenden Tageslimit des Schlüssels einplanen.
Häufige Fragen
Was auf dieser Seite gefragt wird
Das ist Ihre Entscheidung und Ihre rechtliche Verantwortung. Die Plattform prüft Uploads nicht auf Identität, und die Bedingungen legen Einwilligung und Rechte beim Kunden.
Das erste Bild verankert das Ergebnis, aber Endpunkte halten unterschiedlich streng daran fest. Jede Modellseite beschreibt das Verhalten und die verfügbaren Regler.
duration_seconds erhöhen, soweit der Endpunkt es zulässt, oder Einstellungen getrennt erzeugen und selbst schneiden. Die Länge ist je Endpunkt begrenzt und wird pro Sekunde abgerechnet.
Sie erhalten einen Endzustand mit stabilem errorCode, die Reservierung wird vollständig freigegeben, und eine Wiederholung erzeugt aus derselben Quelle einen neuen Auftrag, ohne den alten anzufassen.
Modelle
Modelle, die Sie dafür aufrufen können
Jeder Link führt auf die Seite der jeweiligen Modellfamilie: Eingaben, Grenzen, Inhaltsrichtlinie und der aktuelle Preis je Einheit.
AlibabaWan 3.0Bild zu VideoInhaltsrichtlinie: UnzensiertByteDanceSeedance 2.5Referenz zu VideoInhaltsrichtlinie: UnzensiertKlingKling 3.0CharakteranimationInhaltsrichtlinie: GefiltertByteDanceSeedance 2.5 SpicyBild zu VideoInhaltsrichtlinie: UnzensiertAlibabaWan 3.0 PrimeReferenz zu VideoInhaltsrichtlinie: UnzensiertKlingKling 2.6CharakteranimationInhaltsrichtlinie: Gefiltert
Weiter
Einen Bild-zu-Video-Endpunkt testen
Aus einem Referenzbild wird ein Clip. Was Bildqualität, falsches Seitenverhältnis, Bewegungsfelder und Länge mit Ergebnis und Preis machen.