Runway: Aleph 2.0
Aleph 2.0 bearbeitet vorhandenes Video durch gezielte Textanweisungen und Keyframe-Steuerung. Ersetzen Sie ein Objekt oder ändern Sie Hintergrund, Kleidung, Beleuchtung oder Stil und bestimmen Sie dabei, welche Details der ursprünglichen Szene erhalten bleiben sollen.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Aleph 2.0 ist das In-Context-Videobearbeitungsmodell von Runway. Es verändert herkömmlich aufgenommenes oder generiertes Filmmaterial durch eine schriftliche Anweisung und optionale Keyframe-Steuerung. Sein vorgesehener Workflow ändert den gewünschten Teil einer Szene und bewahrt dabei umgebende Komposition, Beleuchtung und Details. Das ist für Produktaustausch, Kleidungswechsel, Hintergrundveränderung, neue Beleuchtung oder visuelle Stiländerung nützlich, ohne die gesamte Szene aus einem Textbriefing neu zu erstellen.
Beginnen Sie mit einer direkten Handlung und der gewünschten Veränderung: hinzufügen, entfernen, ersetzen, ändern, neu beleuchten oder umgestalten. Identifizieren Sie für einen Produktaustausch das sichtbare Objekt und beschreiben Sie seinen Ersatz; nennen Sie dann die zu bewahrenden Handbewegungen, Kamerabewegungen und Umgebungsdetails. Beschreiben Sie für eine jahreszeitliche Szene Wetter oder Licht, die sich ändern sollen. Eine knappe, gezielte Anweisung liefert ein klareres Bearbeitungsziel als die allgemeine Aufforderung, den gesamten Clip zu verbessern.
Keyframe-Steuerung legt fest, wie das bearbeitete Ergebnis zu einem bestimmten Zeitpunkt aussehen soll. Wählen Sie ein Bild, das das Ziel klar zeigt: eine weite Ansicht für einen Hintergrundwechsel oder eine nähere Ansicht für ein kleines Merkmal oder Zubehör. Im Edit-Studio-Workflow von Runway kann eine Standbildbearbeitung vorab angesehen und verfeinert werden, bevor diese gewählte Fassung die Videoveränderung steuert. Vergleichen Sie bearbeitetes Bild und Quelle hinsichtlich der zu bewahrenden Motivdetails, Kanten und Objekte und verwenden Sie es anschließend als visuelle Richtung für den Clip.
Die Hersteller-API unterstützt Quellvideos von 2 bis 30 Sekunden und bis zu fünf optionale Keyframe-Bilder an vorgegebenen Zeitstempeln. Halten Sie jedes steuernde Bild mit seiner vorgesehenen Quellposition verknüpft und verwenden Sie wenige klare Änderungen statt einer Sammlung widersprüchlicher visueller Ziele. Aleph 2.0 unterscheidet sich vom älteren Gen-4-Aleph-Modell; der Hersteller kennzeichnet sein API-Modell separat. Eine keyframegesteuerte Bearbeitung unterscheidet sich außerdem von der Aufforderung an ein Text-zu-Video-Modell, eine unzusammenhängende Einstellung zu erzeugen.
Die dokumentierten Vorbereitungsregeln von Edit Studio verwenden übliche Seitenverhältnisse, Quellauflösung zwischen 480p und 1080p sowie 24–30 Bilder pro Sekunde mit höchstens zehn Schnitten oder Einstellungswechseln. Empfohlen wird 720p- oder 1080p-Quellmaterial; Material mit mehr als 30 fps wird heruntergerechnet, und Uploads über 30 Sekunden werden in dieser Oberfläche gekürzt. Dies sind Vorbereitungsregeln des Hersteller-Bearbeitungsworkflows. Wählen Sie ein Quellsegment, das das vollständige zu bearbeitende Ereignis zeigt und dessen Motiv dort sichtbar bleibt, wo die Änderung durchgängig gelten muss.
Das Modell kann Änderungen an Hintergrund, Kleidung, Objekt, Licht oder Stil über das Material hinweg übertragen. Eine zusätzliche Bewegungsanweisung ist nützlich, wenn die Bearbeitung eine neue, in der Quelle fehlende Handlung benötigt, die sich nicht allein aus dem Keyframe ergibt, etwa einen sich zeitlich entwickelnden visuellen Effekt. Viele Bearbeitungen benötigen keine zusätzliche Bewegungsregie, weil das Modell die Keyframe-Anpassung innerhalb der vorhandenen Szene animiert. Beschreiben Sie neue Bewegung gezielt und trennen Sie sie von der bereits durch den Keyframe festgelegten visuellen Änderung.
Der Hersteller-Bearbeitungsworkflow wendet eine Bearbeitung standardmäßig auf das vollständige Video an und kann sie auf einen gewählten Zeitlinienbereich begrenzen. Bewahren Sie den ursprünglichen Clip auf, damit das gewählte Ergebnis mit der Quelle verglichen und für eine gezielte Weiterbearbeitung verwendet werden kann. Eine praktische Prüfung geht über das gewählte Bild hinaus: Prüfen Sie Anfang, Mitte, Ende, jeden Schnitt und den Zeitraum, in dem das Ziel kurz verdeckt ist. Das nützliche Ergebnis ist ein überarbeiteter Clip, dessen gewünschte Veränderung zeitlich konsistent bleibt, während wichtige unveränderte Elemente ihre Rolle behalten.
MP4 ist das Standardergebnis für Wiedergabe und Weitergabe. Der dafür geeignete Edit-Studio-Workflow von Runway für vollständige Videos bietet außerdem ProRes als MOV-Datei mit PCM-Audio oder ein ZIP einzelner PNG-Bilder für Compositing. ProRes-Profile reichen von 422 Proxy bis 4444 XQ. Auf einen Zeitlinienbereich begrenzte Bearbeitungen liefern MP4; das Ausgabeformat wird beim Generierungsstart gewählt, statt nach dem fertigen Ergebnis geändert zu werden. Wählen Sie die Hersteller-Exportform für die folgende Bearbeitungsaufgabe und halten Sie sie von der visuellen Kernbearbeitungsfähigkeit des Modells getrennt.
Vergleichen Sie für eine nützliche fertige Bearbeitung den vorgesehenen Austausch, die Beleuchtung oder den Stil mit dem Keyframe und prüfen Sie umgebende Details, die sich nicht ändern sollten. Bewahren Sie die gelungene Version auf und überarbeiten Sie die konkrete Anweisung oder das steuernde Bild, das für eine Abweichung verantwortlich ist. Die Rolle von Aleph 2.0 ist die Veränderung von Quellmaterial anhand eines klaren visuellen Ziels; eine neue Tonspur zu erzeugen, das Verhalten einer Anwendung zu ändern oder eine separate Sendebereitstellung abzuschließen sind zusätzliche Aufgaben rund um das bearbeitete Video.
Ailoot Ultra · Videogenerierung POST /v1/videos runway/aleph-2
runway/aleph-2Start
Aleph 2.0 bearbeitet vorhandenes Video durch gezielte Textanweisungen und Keyframe-Steuerung. Ersetzen Sie ein Objekt oder ändern Sie Hintergrund, Kleidung, Beleuchtung oder Stil und bestimmen Sie dabei, welche Details der ursprünglichen Szene erhalten bleiben sollen.
- Zulässige Eingaben
- Text · Bilder · Audio · Video
- Ergebnisse
- Video
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Videogenerierung POST /v1/videos
- Eingabetypen
text,image,audio,video- Ausgabetypen
video
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits runway/aleph-2 | Standard— |
Feldinput_references | Typarray | AnforderungErforderlich | Werte und Limits Mindestanzahl Elemente: 1 Maximale Anzahl Elemente: 1 | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 | Standard— |
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, input_references, prompt |
Parametermaterial_types | Vertragtext, image, audio, video |
Parametermaterial_conditions | VertragVerwenden Sie genau eine tatsächliche Inhalts-URL eines fertiggestellten, Ihnen zugeordneten Videoassets mit ihrer zurückgegebenen Signatur. Eigentümer, Typ und Nachweis der gespeicherten Bytes des Assets müssen zur Anfrage passen. |
Lebenszyklus: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · Tatsächlich zurückgegebene id oder polling_url
GET /v1/videos/{request_id}/content
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif. Wenden Sie die angezeigte Mindestgebührenregel für diese Konfiguration an.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Gebührenkomponente | Abrechnungseinheit | Abrechnungsbedingungen | Mindestgebührenregel | Gebühr |
|---|---|---|---|---|---|---|---|
| KonfigurationBasistarife für Token | TarifstaffelGrundtarif | Prognostizierte Menge— | Gebührenkomponente— | Abrechnungseinheit— | Abrechnungsbedingungen— | Mindestgebührenregel— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Token Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Lesen · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Token |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Gebührenkomponente— | Abrechnungseinheitpro Videosekunde | AbrechnungsbedingungenIn diesem Preisschlüssel ist keine zusätzliche Bedingung angegeben. | Mindestgebührenregel— | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.56 pro Videosekunde |
| KonfigurationMindestbetrag pro Generierung | Tarifstaffel— | Prognostizierte Menge— | GebührenkomponenteMindestgebühr | AbrechnungseinheitMindestgebühr für die Generierung | AbrechnungsbedingungenIn diesem Preisschlüssel ist keine zusätzliche Bedingung angegeben. | MindestgebührenregelJa | Gebühr total · Mindestbetrag pro Generierung · Schätzung nur zum Vergleich $1.12 Mindestgebühr für die Generierung Mindestbetrag pro Generierung; als Mindestbetrag anwenden, nicht als zusätzliche Gebühr. Daraus ergibt sich keine Mindestdauer. |
| KonfigurationGeschätzte Generierungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Gebührenkomponente— | Abrechnungseinheit— | Abrechnungsbedingungen— | Mindestgebührenregel— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.56 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · Videogenerierung
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_INPUT_REFERENCES_JSON:?Set the actual documented input value}"
export AILOOT_INPUT_REFERENCES_JSON
: "${AILOOT_PROMPT:?Set the actual documented input value}"
export AILOOT_PROMPT
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'runway/aleph-2', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}', 'prompt': '${ACTUAL_EDIT_PROMPT}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
request['prompt']=os.environ['AILOOT_PROMPT']
Path('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
Ergebnisse abrufen und speichern
Ailoot Ultra · Videogenerierung
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Alle fertiggestellten Dateien speichern
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Video oder jede zurückgegebene Datei; rufen Sie jede tatsächlich zurückgegebene Datei-URL ab.
Die vollständige Antwort und ihre Header, jede tatsächliche Ausgabe, die ursprünglich zurückgegebenen Kennungen und alle Nutzungsfelder aufbewahren. Den ursprünglichen Vorgang wiederaufnehmen, ohne die Erstellung erneut anzufordern.
Wenn die ursprüngliche Antwort geprüft werden muss
Bewahren Sie X-Client-Request-ID, X-Ailoot-Task-Id sowie die tatsächlich zurückgegebenen id/polling_url auf. Setzen Sie den ursprünglichen Auftrag fort; senden Sie die Erstellung nicht erneut.
Antwortfelder
| Feld | Typ |
|---|---|
Feldid | Typ |
Feldstatus | Typ |
Felddata[] | Typ |
Feldoutputs[] | Typ |
Aliasnamen
Modellaliasnamen
Ailoot Ultra runway/aleph-2
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · Runway: Aleph 2.0
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/videos·runway/aleph-2:text,image,audio,video→video- Welche Felder verwendet die Anfrage?
POST /v1/videos·runway/aleph-2:model,input_references,prompt