Technische Spezifikationen von runwayml-image-to-video
| Spezifikation | Details |
|---|---|
| Modell-ID | runwayml-image-to-video |
| Anbieter | Runway |
| Hauptfunktion | Erzeugt aus einem Ausgangsbild mithilfe eines Textprompts und bildkonditionierter Bewegungsgenerierung ein Video. |
| API-Aufgabentyp | Asynchrone Image-to-Video-Generierungsaufgabe, die über den Image-to-Video-Endpunkt von Runway gestartet wird. |
| Unterstützte zugrunde liegende Modelle in der Runway-API | Der Image-to-Video-Endpunkt von Runway akzeptiert mehrere Videomodelle, darunter gen4_turbo, gen3a_turbo, veo3.1, veo3.1_fast und veo3. |
| Erforderliche Eingaben | Ein Eingabebild plus modellspezifische Generierungsparameter; Prompt-Text wird häufig verwendet, um gewünschte Bewegung und Verhalten der Szene zu beschreiben. |
| Authentifizierung | Bearer-API-Schlüssel im Authorization-Header. |
| Versions-Header | Die API-Referenz von Runway erfordert den Header X-Runway-Version mit dem dokumentierten Wert 2024-11-06 für den Image-to-Video-Endpunkt. |
| Ausgabeformat | Das generierte Video-Asset wird über die aufgabenbasierte API-Verarbeitung zurückgegeben. |
| Typische Bildrate | Die Runway-Dokumentation nennt 24 fps für Gen-3 Alpha Image-to-Video-Ausgaben. |
| Übliche Ausgabeauflösung | Runway dokumentiert 1280×768 für Gen-3 Alpha sowie je nach Ausrichtung 1280×768 und 768×1280 für Gen-3 Alpha Turbo. |
| Leitlinien für Bildeingaben | Runway empfiehlt, Referenzbilder kleiner als 640×640 px oder größer als 4K für Bildeingaben zu vermeiden. |
| Nutzungsmuster in CometAPI | Zugriff über CometAPI unter Verwendung des plattformspezifischen Modellbezeichners runwayml-image-to-video. |
Was ist runwayml-image-to-video?
runwayml-image-to-video ist der Modellbezeichner in CometAPI für den Zugriff auf Runways Image-to-Video-Generierungsfähigkeit. In der Praxis nimmt diese Modellkategorie ein Standbild als visuellen Ausgangspunkt und verwandelt es in ein generiertes Video, typischerweise geführt von Prompt-Text, der Bewegung, Kameraverhalten, Atmosphäre oder die Entwicklung der Szene beschreibt.
Runway positioniert Image-to-Video als Teil seines umfassenderen Video-Generierungs-Stacks. Die Dokumentation zu Gen-3 Alpha beschreibt Image-to-Video als eine Möglichkeit, ein bereitgestelltes Bild zu animieren, wobei sich das Prompting besonders auf Bewegung konzentriert, statt alles, was bereits im Bild sichtbar ist, erneut zu beschreiben.
Aus API-Sicht stellt Runway die Image-to-Video-Generierung als Endpunkt zur Aufgabenerstellung bereit. Das bedeutet, Anfragen starten typischerweise zunächst einen Job und erfordern anschließend Polling- bzw. Abrufschritte, um das endgültige Videoergebnis nach Abschluss der Verarbeitung zu erhalten.
Hauptfunktionen von runwayml-image-to-video
- Bildkonditionierte Videogenerierung: Startet mit einem Standbild und erzeugt bewegungsgetriebene Videoausgaben statt reinem Text-zu-Video.
- Prompt-gesteuerte Bewegungssteuerung: Funktioniert am besten, wenn Prompts Bewegung, Kamerabewegungen und Szenenwechsel beschreiben, um das gelieferte Bild stimmig zu animieren.
- Asynchroner Aufgaben-Workflow: Verwendet eine Start-Generierungsanfrage mit anschließender Ergebnisabfrage, passend für produktive Systeme, die langlaufende Medienjobs in der Warteschlange überwachen.
- Mehrere zugrunde liegende Modelloptionen: Der Image-to-Video-API-Endpunkt unterstützt mehrere Backend-Videomodelle und bietet Flexibilität bei Qualität, Geschwindigkeit und Kostenprofilen.
- Produktionsreife API-Authentifizierung: Nutzt Standard-Bearer-Token-Authentifizierung und explizite API-Versions-Header für kontrollierte Integrationen.
- Unterstützung von Hoch- und Querformat-Ausgaben: Runway dokumentiert Ausgabegrößen für horizontale und vertikale Generierungsmodi in unterstützten Modellfamilien.
- Kompatibel mit Referenzbild-Workflows: Die API ist auf Bildreferenzen ausgelegt; Runway gibt Empfehlungen zur Eingabebildgröße, um die Generierungsqualität zu sichern.
- Passend für erweiterbare kreative Pipelines: Runways Plattform umfasst verwandte Videogenerierungs-Workflows wie Keyframes, Erweiterung und weitere Modi, wodurch Image-to-Video als eine Stufe in größeren kreativen Pipelines sinnvoll ist.
Zugriff und Integration von runwayml-image-to-video
Schritt 1: Für einen API-Schlüssel registrieren
Registrieren Sie sich bei CometAPI und generieren Sie Ihren API-Schlüssel im Dashboard. Speichern Sie den Schlüssel sicher und verwenden Sie ihn im Authorization-Header für alle Anfragen.
Schritt 2: An die runwayml-image-to-video-API Anfragen senden
Verwenden Sie Runways offizielles API-Format über CometAPI. Der Endpunkt ist POST /runwayml/v1/image_to_video. Fügen Sie den Header X-Runway-Version hinzu.
curl https://api.cometapi.com/runwayml/v1/image_to_video \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $COMETAPI_API_KEY" \
-H "X-Runway-Version: 2024-11-06" \
-d '{
"model": "gen4_aleph",
"promptText": "Your prompt here."
}'
Schritt 3: Ergebnisse abrufen und prüfen
Die API gibt ein Task-Objekt mit einer Task-ID zurück. Rufen Sie periodisch GET /runwayml/v1/tasks/{task_id} auf, um den Generierungsstatus zu prüfen, und entnehmen Sie anschließend die Ausgabe-URL der abgeschlossenen Task-Antwort.