Runway Video API Konfiguration
Runway ist eine Plattform zur Videogenerierung. Sie dient in der Regel nicht als Base-URL für Chatboxen. Erstellen Sie stattdessen einen API-Key auf der Runway-Plattform und nutzen Sie das offizielle SDK oder HTTP-Anfragen, um Video-Tasks zu erstellen.
Offizielle Informationen Downloads und Dokumentation richten sich nach der offiziellen Website.
Für welche Szenarien geeignet
Text-to-VideoImage-to-VideoAsynchrone TasksOffizielles SDK
Zuerst den Video-Task-Workflow verstehen
- Erstellen Sie einen API-Key und stellen Sie sicher, dass Ihr Konto über Berechtigungen für die Video-API sowie über Guthaben verfügt.
- Wählen Sie den Task-Typ: Text-to-Video, Image-to-Video oder andere Video-Tasks, die derzeit von der offiziellen Dokumentation unterstützt werden.
- Sie erhalten die Videodatei nicht sofort nach dem Absenden eines Tasks; in der Regel erhalten Sie zuerst ein Task-Objekt oder eine Task-ID.
- Warten Sie, bis der Task abgeschlossen ist, und rufen Sie dann die Ausgabe-URL ab oder laden Sie die Ergebnisse herunter.
- Überprüfen Sie im Fehlerfall zuerst den Task-Status und die Fehlerdetails, anstatt nur den Key zu prüfen.
Parameter vorbereiten
| Konfigurationselement | Ausfüllmethode |
|---|---|
| API Key | Erstellung im Runway-Backend; das offizielle SDK liest standardmäßig <code>RUNWAYML_API_SECRET</code> aus |
| Task | text-to-video / image-to-video |
| Prompt | Beschreibung des Videoinhalts |
| Ratio / Size | Querformat, Hochformat oder benutzerdefinierte Größe |
| Duration | Videodauer |
| Status | Den Task bis zum Abschluss abfragen (Polling) |
| Einstellung | Beschreibung | Tipps für Einsteiger |
|---|---|---|
| API Key | Anmeldedaten für die Runway-API | Nur in lokalen oder Server-Umgebungsvariablen unter dem Namen RUNWAYML_API_SECRET speichern |
| Prompt | Beschreibung des Videoinhalts | Zuerst kürzer formulieren und nach Bestätigung des Stils verfeinern |
| Image | Das Ausgangsbild für Image-to-Video | Laden Sie klare Bilder mit einem eindeutigen Hauptmotiv hoch |
| Duration | Videodauer in Sekunden | Testen Sie Kosten und Wirkung zunächst mit einer kürzeren Dauer |
| Status | Task-Status | Die Videogenerierung erfolgt asynchron und erfordert das Warten auf den Abschluss. |
SDK-Beispiel
Runway-Umgebungsvariablenname
RUNWAYML_API_SECRET=YOUR_RUNWAY_API_KEYRunway Node.js-Task-Beispiel
import RunwayML, { TaskFailedError } from "@runwayml/sdk"; const client = new RunwayML(); try { const task = await client.imageToVideo.create({ model: "gen4.5", promptText: "A product introduction video on a white background with a slow camera push-in", ratio: "1280:720", duration: 5 }).waitForTaskOutput(); console.log(task.output[0]); } catch (error) { if (error instanceof TaskFailedError) { console.error(error.taskDetails); } }Die Felder der Videoplattform werden mit den Modellversionen aktualisiert. Das Seitenbeispiel dient zum Verständnis der Konfigurationsstruktur; die tatsächlichen Felder sollten auf der aktuellen Version der offiziellen Dokumentation basieren.
| Phänomen | Vorrangige Prüfung | Vorgehensweise |
|---|---|---|
| Das Video wird nach dem Absenden nicht sofort zurückgegeben | Befindet sich der Task noch in der Warteschlange oder wird er generiert? | Die Videogenerierung ist ein asynchroner Task; warten Sie, bis der Status abgeschlossen ist, bevor Sie das Ergebnis abrufen. |
| Task fehlgeschlagen | Modellname, Seitenverhältnis, Dauer, ob das Eingabebild den aktuellen Modellanforderungen entspricht | Passen Sie die Parameter anhand der zurückgegebenen Fehlerdetails an und ändern Sie nicht zu viele Elemente auf einmal. |
| Die Kosten sind höher als erwartet | Dauer, Auflösung, Modellversion | Testen Sie zuerst mit kurzer Dauer und kostengünstigen Parametern, bevor Sie größere Mengen generieren |