runway_video

Technische Spezifikationen von runway-video

Was ist runway-video?

runway-video ist der Plattformbezeichner von CometAPI für den Zugriff auf Runways videobasierte Generierungsfunktionen über eine einheitliche API. Basierend auf der offiziellen API-Dokumentation von Runway bietet Runway mehrere Videomodelle zur Generierung von Clips aus Texteingaben oder aus Bildern, mit auf Aufgaben basierenden Endpunkten zum Starten von Generierungen und zum späteren Abrufen der Ergebnisse.

In der Praxis lässt sich runway-video eher als ein Gateway zu von Runway unterstützten Videoerstellungs-Workflows verstehen als als einzelner, eigenständiger Foundation-Model-Name. Der aktuelle API-Katalog von Runway umfasst mehrere Videomodelle mit unterschiedlichen Eingabemodi und Preisklassen, etwa gen4.5 für Text-oder-Bild-zu-Video, gen4_turbo für Bild-zu-Video sowie weitere Optionen wie gen4_aleph, veo3, veo3.1, veo3.1_fast und gen3a_turbo.

Damit eignet sich runway-video für Anwendungen wie kreatives Prototyping, Erstellung von Marketinginhalten, Produktion von Social-Media-Clips, Konzeptvisualisierung und Produkterlebnisse, die automatisierte Kurzvideo-Synthese benötigen. Da die zugrunde liegende Runway-API asynchrone Jobs verwendet, senden Integrationen typischerweise zunächst eine Generierungsanfrage und pollen oder rufen die Aufgabenergebnisse ab, sobald die Verarbeitung abgeschlossen ist.

Hauptfunktionen von runway-video

• Text-zu-Video-Generierung: Runway unterstützt die Videoproduktion aus natürlichsprachigen Prompts auf unterstützten Modellen und ermöglicht es Entwicklerinnen und Entwicklern, Clips direkt aus beschreibendem Text zu erzeugen.
• Bild-zu-Video-Workflows: Mehrere Runway-Videomodelle akzeptieren Bildeingaben, wodurch sich runway-video für die Animation von Standbildern oder referenzgetriebene Videogenerierungs-Pipelines eignet.
• Mehrere zugrunde liegende Modelloptionen: Die Runway-API stellt verschiedene Videomodelle mit unterschiedlichen Fähigkeiten und Kostenprofilen bereit, sodass sich Qualität, Geschwindigkeit oder Budget optimieren lassen.
• Asynchrone Aufgabenverarbeitung: Generierungsanfragen erzeugen Aufgaben, anstatt sofort finale Medien zurückzugeben; dies ist ideal für produktive Systeme mit Warteschlangenverwaltung, Wiederholungen und Statusprüfungen.
• Temporäre Asset-Uploads: Runway bietet Upload-Endpunkte, die runwayUri-Referenzen zurückgeben und das Einbinden von Bild-, Video- oder Audio-Assets in nachfolgende Generierungsanfragen erleichtern.
• Offizieller SDK-Support: Runway stellt Node.js- und Python-SDKs bereit, die Authentifizierung, Anfrageerstellung und Ergebniserfassung vereinfachen können.
• Versionierte API-Integration: Anfragen erfordern einen expliziten X-Runway-Version-Header, was hilft, gegen einen definierten API-Vertrag zu entwickeln.
• Kreditbasiertes Preismodell: Runway rechnet Videogenerierung nach Credits pro Sekunde ab; die Preise variieren je nach ausgewähltem zugrunde liegendem Modell.

Zugriff auf und Integration von runway-video

Schritt 1: Für einen API-Schlüssel registrieren

Um auf runway-video zuzugreifen, erstellen Sie zunächst ein Konto und generieren Sie einen API-Schlüssel über Ihr CometAPI-Dashboard. Nach dem Anmelden kopieren Sie Ihren API-Schlüssel und speichern ihn für den Produktionseinsatz sicher in einer Umgebungsvariablen oder einem Secrets-Manager.

Schritt 2: An die runway-video-API Anfragen senden

Verwenden Sie Ihren API-Schlüssel zur Authentifizierung von Anfragen an den CometAPI-Endpunkt für runway-video. Übergeben Sie Ihren Prompt und alle unterstützten Eingabeparameter im Anfrage-Body und geben Sie das Modell als runway-video an.

curl -X POST "https://api.cometapi.com/v1/responses" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "runway-video",
    "input": "Create a cinematic video of a futuristic city at sunrise with slow camera movement."
  }'

Schritt 3: Ergebnisse abrufen und verifizieren

Prüfen Sie nach dem Absenden die API-Antwort auf die generierte Ausgabe, eine Aufgaben-ID oder das für runway-video zurückgegebene Ergebnispaket. Falls die Generierung asynchron abläuft, pollen Sie den entsprechenden CometAPI-Endpunkt, bis die Verarbeitung abgeschlossen ist, und validieren Sie anschließend die zurückgegebene Video-URL, Metadaten und Inhalte, bevor Sie diese in Ihrer Anwendung nutzen.