Wie verwende ich die Runway Gen-4.5 API? In 5 Minuten zum ersten Video

TL;DR

• Runway Gen-4.5 ist das Videomodell von Runway. Auf HiAPI gibt es zwei Einstiegspunkte: Text-zu-Video und Bild-zu-Video. Modellseite öffnen und direkt online testen. Neue Nutzer erhalten bei der Registrierung 200 Credits.
• Beide Einstiegspunkte kosten $0.1715 pro Sekunde: 5 Sekunden $0.8575, 8 Sekunden $1.372, 10 Sekunden $1.715.
• Aufruf: Mit POST /v1/tasks absenden, mit der taskId das Ergebnis abfragen, das fertige Video liegt unter output[0].url.

Was Runway Gen-4.5 kann

• Drei Stufen: 5, 8, 10 Sekunden: 8 Sekunden reichen genau für eine Push-in-, Orbit- oder langsame Aufwärtsbewegung.
• Fest 720p: Querformat 1280×720, Hochformat 720×1280, keine Auflösungswahl nötig.
• Bild-zu-Video mit 5 Seitenverhältnissen: 16:9, 9:16, 4:3, 3:4, 1:1 – dasselbe Bild lässt sich für verschiedene Plattformen ausgeben.
• Fertige Videos ohne Tonspur: Das Bild übernimmt das Modell, der Ton wird beim Schnitt hinzugefügt.

She turns her head toward the camera and smiles, hair moves in a light breeze, slow push-in

Mit diesem Prompt generieren → (Porträt als erstes Frame hochladen, 5 Sekunden, 3:4 wählen)

runway-gen-4.5/image-to-video, 3:4, 832×1104, 5 Sekunden, $0.8575. Erstes Frame: .

Sie dreht ihr Gesicht vom Profil zur Kamera und lächelt, die Haarspitzen bewegen sich leicht, die Kamera fährt bis zur Nahaufnahme des Gesichts heran. Der Prompt beschreibt nur Bewegung und Kameraführung; Aussehen der Person und das Licht am Fenster stammen vollständig aus dem ersten Frame.

Wie man zwischen den beiden Einstiegspunkten wählt

Modell-ID	Eingabe	Dauer	Seitenverhältnis	Geeignet für
runway-gen-4.5/text-to-video	Prompt	5 / 8 / 10 Sekunden (9:16 nur 5 / 10)	16:9, 9:16	Kein Material, Beginn mit Text
runway-gen-4.5/image-to-video	1 erstes Frame + Prompt	5 / 8 / 10 Sekunden	16:9, 9:16, 4:3, 3:4, 1:1	Motiv muss dem Originalbild entsprechen, oder quadratisch, 4:3, 3:4 benötigt

Beide Einstiegspunkte kosten gleich, jeweils $0.1715 pro Sekunde.

Zwei Wege zum Einstieg

Im Browser testen (3 Schritte)

1. Die Modellseite Text-zu-Video oder Bild-zu-Video öffnen und anmelden.
2. Prompt schreiben; bei Bild-zu-Video zuerst ein erstes Frame hochladen.
3. 5 Sekunden und Seitenverhältnis wählen, auf Ausführen klicken.

Über die API aufrufen (3 Schritte)

1. Auf der API-Key-Seite der Konsole einen Schlüssel erstellen und in die Umgebungsvariable HIAPI_KEY eintragen.
2. POST https://api.hiapi.ai/v1/tasks absenden, Rückgabe data.taskId.
3. Mit GET /v1/tasks/{taskId} prüfen, bis status success ist, dann output[0].url herunterladen.

curl: Das erste Video

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "runway-gen-4.5/text-to-video",
    "input": {
      "prompt": "A lone stone lighthouse on a rugged sea cliff at dusk, heavy waves crashing against the rocks, the lamp beam sweeping across dark storm clouds, slow cinematic push-in, drifting sea mist, dramatic lighting",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

5 Sekunden, 16:9, $0.8575. Das fertige Video sieht so aus:

A lone stone lighthouse on a rugged sea cliff at dusk, heavy waves crashing against the rocks, the lamp beam sweeping across dark storm clouds, slow cinematic push-in, drifting sea mist, dramatic lighting

Mit diesem Prompt generieren → (5 Sekunden, 16:9 wählen)

runway-gen-4.5/text-to-video, 16:9, 1280×720, 5 Sekunden, $0.8575.

Python: Absenden, Polling, Herunterladen

# pip install requests；先 export HIAPI_KEY=你的 Key
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, timeout_s=900, **inp):
    # 重试同一个任务时带同一个 Idempotency-Key，避免重复扣费
    r = requests.post(API, json={"model": model, "input": inp},
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# 图生视频：同一张图出 1:1 版本，8 秒（$1.372）
url = generate(
    "runway-gen-4.5/image-to-video",
    prompt="The scene slowly comes alive: clouds drift, light shifts across the mountain lake, gentle forward camera move",
    image_urls=["https://你的图床/lake.jpg"],
    duration=8, aspect_ratio="1:1",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Parametertabelle

Feld	Pflicht	Werte	Beschreibung
prompt	Ja	1–1000 Zeichen	Motiv, Bewegung und Kameraführung beschreiben; bei Bild-zu-Video nur Bewegung und Kamera
duration	Nein	5 (Standard) / 8 / 10	Text-zu-Video 9:16 nur 5 / 10
aspect_ratio	Nein	Text-zu-Video: 16:9 (Standard) 9:16; Bild-zu-Video: 16:9 (Standard) 9:16 4:3 3:4 1:1	Erstes Frame wird bei Bild-zu-Video mittig auf das Seitenverhältnis zugeschnitten
image_urls	Pflicht bei Bild-zu-Video	Nur 1 Bild, jpeg/png/webp, ≤10MB	Erstes Frame; Text-zu-Video akzeptiert dieses Feld nicht

Es gibt kein resolution, seed oder negative_prompt, auch kein End-Frame.

Fehler, die dir begegnen werden

Bei falschen Parametern beim Absenden gibt die Schnittstelle direkt 400 zurück, es wird kein Task angelegt und nichts berechnet:

• duration: value must be one of 5, 10: Bei Text-zu-Video wurde 9:16 mit 8 Sekunden kombiniert.
• duration: value must be one of 5, 8, 10: Die Dauer kennt nur diese drei Stufen.
• image_urls: maxItems: got 2, want 1: Bild-zu-Video akzeptiert nur ein erstes Frame, kein End-Frame.
• image_urls: missing required field "image_urls": Bei Bild-zu-Video wurde kein erstes Frame übergeben.
• prompt: maxLength: got 3,000, want 1,000: Der Prompt darf maximal 1000 Zeichen lang sein.
• additional properties 'negative_prompt', 'cfg_scale' not allowed: Diese beiden Felder existieren bei Runway Gen-4.5 nicht.

Hinweise vor dem Go-live

• Callbacks statt Polling: Auf oberster Ebene der Anfrage (gleichrangig zu input) "callback": {"url": "https://deine-domain/hiapi/callback"} hinzufügen und nach taskId deduplizieren.
• Rechtzeitig sichern: output[0].url verfällt nach etwa 7 Tagen, sofort in den eigenen Speicher übertragen.
• duration und aspect_ratio explizit angeben: Hochformatiges Text-zu-Video muss 8 Sekunden vermeiden, fest im Code ist am sichersten.
• Bei Wiederholungen Idempotenzschlüssel mitgeben: Im Request-Header Idempotency-Key hinzufügen, derselbe Schlüssel legt nur einmal einen Task an.

Häufige Fragen

Geht 1080p oder 4K?

Nein, die Ausgabe ist fest 720p. Für 1080p kann man Kling 2.5 Turbo verwenden, zum Vergleich siehe Runway Gen-4.5 vs. Kling 2.5 Turbo im Vergleich.

Haben die fertigen Videos Ton?

Nein, die Ausgabe enthält nur das Bild. Musik, Soundeffekte und Voiceover werden beim Schnitt hinzugefügt.

Kann Bild-zu-Video ein End-Frame hinzufügen?

Nein, image_urls akzeptiert nur ein Bild. Um das Ende per End-Frame zu steuern, Bild-zu-Video von Kling 2.5 Turbo verwenden.

Was passiert, wenn das Seitenverhältnis des ersten Frames nicht dem gewählten entspricht?

Das erste Frame wird mittig auf das gewählte Seitenverhältnis zugeschnitten; das Motiv in der Mitte zu platzieren ist am sichersten.

Preisdetails siehe Runway Gen-4.5 API-Preise, weitere Szenarien siehe Runway Gen-4.5 Prompt-Sammlung. Wer zuerst die Wirkung sehen will, kopiert den Leuchtturm-Prompt oben und generiert das erste Video auf der Modellseite.