Runways Eleven-v4-Sprach-API: Anfrageformat und Preise ab Oktober

Runway hat Eleven v4 am 30. September in seine Entwickler-API aufgenommen. Der Versionshinweis bezeichnet das Modell als eleven_v4, begrenzt ein Skript auf 2.500 Zeichen und kündigt an, dass der Credit-Satz am 12. Oktober 2026 nach pazifischer Zeit steigt. Für Entwickler, die Sprachgenerierung in einen Produktionsablauf integrieren, ist entscheidend, welche Angaben eine gültige Anfrage benötigt und was der dokumentierte Satz in Dollar bedeutet. Dieser Leitfaden stützt sich auf Runways Dokumentation, geprüft am 6. Oktober; BIG CHANGE hat keinen kostenpflichtigen API-Aufruf ausgeführt und das Audio nicht bewertet.

Die große Veränderung

• Was sich geändert hat: Runway führt Eleven v4 nun als Text-zu-Sprache-Modell hinter seiner bestehenden Aufgaben-API. Ein Skript kann dokumentierte Audiomarkierungen wie [laughs] , [whispers] und [pause], innerhalb der Grenze von 2.500 Zeichen enthalten.
• Warum das wichtig ist: Ein Team mit einem Runway-Entwicklerprojekt kann Sprachgenerierung mit einer voreingestellten Stimme anfordern und die Audio-URL der abgeschlossenen Aufgabe abrufen. Für Integration und Budgetplanung stehen damit ein dokumentiertes Anfrageformat und ein datierter Preisplan zur Verfügung.
• Worauf zu achten ist: Laut Runway ändert sich der Satz am 12. Oktober 2026 (Pazifikzeit) von 2,2 auf 5 Credits pro 1.000 Zeichen. Wer wiederholte Generierungen kalkuliert, muss den zum Abrechnungszeitpunkt gültigen Satz verwenden und den aktuellen Preis prüfen, bevor das Budget festgelegt wird.

Projekt und API-Schlüssel einrichten

Runways Einrichtungsanleitung empfiehlt, zunächst im Entwicklerportal ein Konto und Projekt anzulegen und anschließend unter „API Keys“ einen Projekt-API-Schlüssel zu erstellen. Zum Erstellen oder Deaktivieren eines Schlüssels ist die Rolle Admin oder Developer erforderlich. Der Schlüssel wird einmal im Klartext angezeigt und sollte sicher gespeichert werden. Für die Nutzung mit dem SDK soll laut Runway RUNWAYML_API_SECRETgesetzt werden; das SDK liest diese Variable automatisch aus. Das Geheimnis gehört nicht in den Quellcode.

Das Projekt benötigt außerdem Credits, bevor es die API verwenden kann. Runway nennt eine anfängliche Mindesteinzahlung von $10, bei $0,01 pro Credit, über den Abrechnungsbereich des Projekts. Zum Hinzufügen von Credits ist die Rolle Admin oder Billing admin erforderlich. Das ist ein Mindestkauf von Credits, nicht der Preis für eine einzelne Sprachanfrage. Die Einrichtungsseite beschreibt keinen kostenlosen ersten Aufruf.

Eine Text-zu-Sprache-Anfrage senden

Der aktuelle Anfrage-Typ des Runway-Python-SDKs erfordert model, prompt_text und ein voice Objekt für Eleven v4. Auf der Leitung entsprechen dem die JSON-Felder model, promptText und voice, mit voice.type auf runway-preset und ein presetId. Bernard ist eine der aufgeführten voreingestellten Stimmen. Der SDK-Dienst sendet diese Anfrage an /v1/text_to_speech und gibt eine neue Aufgabenantwort zurück. Runways API-Leitfaden dokumentiert Host, Bearer-Schlüssel und den X-Runway-Version: 2024-11-06-Header für direkte HTTP-Aufrufe.

Dies ist ein aus der Dokumentation abgeleiteter Anfrageinhalt, kein von uns ausgeführter Aufruf:

{
  "model": "eleven_v4",
  "promptText": "The recording begins now. [pause] Welcome.",
  "voice": {
    "type": "runway-preset",
    "presetId": "Bernard"
  }
}

Runways Änderungsprotokoll vom 30. September nennt [laughs], [whispers] und [pause] als unterstützte Beispiele und erklärt, dass Eleven v4 dieselben Runway-Voreinstellungen für Stimmen wie Eleven v3 nutzt. Markierungen sind Teil des Skripts; sie müssen innerhalb des angegebenen Maximums von 2.500 Zeichen Platz finden. Das SDK führt außerdem optionale Stimmeinstellungen, Sprache und benachbarte Textfelder auf. Aus dem Schema folgt nicht, dass eine Einstellung eine bestimmte Sprechweise garantiert; dieser Artikel trifft keine Aussagen zu Stimmqualität oder Latenz.

Die erste Antwort ist eine Aufgabe und keine Audiodaten. Runways Ausgabeanleitung empfiehlt, GET /v1/tasks/:id abzufragen; eine erfolgreich abgeschlossene Aufgabe enthält ein output-Array mit Ergebnis-URLs. Diese laufen innerhalb von 24–48 Stunden nach Zugriff auf die API ab. Lade das Ergebnis daher in den eigenen Speicher herunter, statt in einem Produkt die temporäre URL zu verwenden. Das allgemeine Ausgabebeispiel betrifft eine Videoaufgabe und zeigt die Antwortstruktur einer Aufgabe; die Modellliste weist Eleven v4 als Audioausgabe aus. Wir haben keine Eleven-v4-Antwort beobachtet und das Audioformat nicht verifiziert.

Den datierten Preis berechnen

Runways Preisseite und Versionshinweis nennen 2,2 Credits pro 1.000 Zeichen bis zum 12. Oktober 2026, Pazifikzeit, danach 5 Credits pro 1.000 Zeichen, bei einem Mindestbetrag von einem Credit. Beim veröffentlichten Preis von $0,01 je Credit entsprechen die Sätze $0,022 und $0,05 je 1.000 Zeichen, jeweils vor möglicherweise anfallenden Steuern. Der spätere Satz ist etwa 2,27-mal so hoch wie der frühere.

Ein transparentes Planungsbeispiel: Zehn einzelne Skripte mit jeweils genau 1.000 abrechenbaren Zeichen ergeben insgesamt 10.000 Zeichen. Multipliziert mit den veröffentlichten Sätzen sind das 22 Credits beziehungsweise $0,22, zum früheren Satz und 50 Credits beziehungsweise $0,50, zum späteren Satz. Jedes Skript liegt unter der Grenze von 2.500 Zeichen, und jede berechnete Anfrage über dem Mindestbetrag von einem Credit. Das ist eine Rechnung anhand der von Runway veröffentlichten Sätze, keine beobachtete Rechnung. Die zitierten Seiten erläutern weder, wie Markierungen bei abrechenbaren Zeichen gezählt werden, noch ob anteilige Gebühren pro Anfrage gerundet werden. Für Schätzungen im Produktivbetrieb sollten daher tatsächliche Nutzungsdaten und aktuelle Bedingungen geprüft werden.

Quellen und weiterführende Informationen

Runways API-Änderungsprotokoll vom 30. September belegt das Veröffentlichungsdatum, die Modell-ID, Beispiele für Markierungen, die Skriptgrenze und die datierte Preisangabe. Die Einrichtungsanleitung erläutert Voraussetzungen für Projekt, Schlüssel und Credits, einschließlich Rollenberechtigungen und der anfänglichen Zahlung von $10. Die Preisseite liefert die Umrechnung von Credits in Dollar und die aufgeführten Eleven-v4-Sätze.

Das Anfrageschema des Python-SDK und seine Dienstimplementierung legen die Feldnamen, die Form der voreingestellten Stimme, den Endpunktpfad und die für diesen Leitfaden geprüfte Antwort beim Erstellen einer Aufgabe fest. Runways Einstiegsanleitung, Modellliste und Ausgabeanleitung liefern den HTTP-Versionsheader, die Einstufung als Audioausgabe und das Verhalten beim Abrufen einer Aufgabe. Dies sind Anbieterunterlagen, kein unabhängiger Leistungstest. Geprüft am 6. Oktober 2026.