Runway: Aleph 2.0
Aleph 2.0 bearbeitet vorhandene Videos mit gezielten Textanweisungen und Keyframe-Vorgaben. Ersetzen Sie einen Gegenstand oder ändern Sie Hintergrund, Kleidung, Licht oder Stil und legen Sie dabei fest, 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 Runways Modell zur kontextbezogenen Videobearbeitung. Es verändert vorhandenes herkömmliches oder generiertes Filmmaterial anhand einer schriftlichen Anweisung und optionaler Keyframe-Vorgaben. Der vorgesehene Ablauf ändert den gewünschten Szenenteil und erhält die umgebende Komposition, das Licht und die Details. Das eignet sich für Produktaustausch, Kleidungswechsel, Hintergrundänderung, neue Beleuchtung oder eine andere Bildgestaltung, ohne die gesamte Szene aus einem Textbriefing neu zu erzeugen.
Beginnen Sie mit einer direkten Handlung und der gewünschten Veränderung: hinzufügen, entfernen, ersetzen, ändern, neu beleuchten oder umgestalten. Benennen Sie beim Produktaustausch den sichtbaren Gegenstand und beschreiben Sie seinen Ersatz; nennen Sie anschließend Handbewegung, Kamerabewegung und Umgebung, die erhalten bleiben sollen. Beschreiben Sie für eine saisonale Szene das zu ändernde Wetter oder Licht. Eine knappe, gezielte Anweisung liefert ein klareres Bearbeitungsziel als eine allgemeine Aufforderung, den ganzen Clip zu verbessern.
Keyframe-Vorgaben legen fest, wie das bearbeitete Ergebnis zu einem bestimmten Zeitpunkt aussehen soll. Wählen Sie einen Frame, der das Ziel klar zeigt: eine weite Ansicht für eine Hintergrundänderung oder eine nähere für ein kleines Merkmal oder Accessoire. In Runways Edit-Studio-Ablauf lässt sich eine Standbildbearbeitung vorab ansehen und verfeinern, bevor die ausgewählte Version die Videoveränderung anleitet. Vergleichen Sie bearbeiteten Frame und Quelle hinsichtlich der zu erhaltenden Motivdetails, Kanten und Gegenstände und verwenden Sie ihn danach als visuelle Vorgabe für den Clip.
Die Hersteller-API unterstützt Ausgangsvideos von 2 bis 30 Sekunden und bis zu fünf optionale Keyframe-Bilder an angegebenen Zeitpunkten. Ordnen Sie jedes Vorgabebild seinem vorgesehenen Punkt in der Quelle zu und nutzen Sie wenige klare Änderungen statt widersprüchlicher visueller Ziele. Aleph 2.0 unterscheidet sich vom älteren Modell Gen-4 Aleph; der Hersteller führt sein API-Modell separat. Eine keyframegestützte Bearbeitung unterscheidet sich auch von einem Text-zu-Video-Auftrag für eine unabhängige Einstellung.
Die dokumentierten Vorbereitungsregeln von Edit Studio verlangen übliche Seitenverhältnisse, eine Quellenauflösung zwischen 480p und 1080p und 24–30 Bilder pro Sekunde bei höchstens zehn Schnitten oder Einstellungswechseln. Empfohlen werden Quellen in 720p oder 1080p; Material über 30 fps wird in dieser Oberfläche heruntergerechnet, Uploads über 30 Sekunden werden gekürzt. Dies sind die Vorbereitungsregeln des Bearbeitungsablaufs des Herstellers. Wählen Sie einen Quellenausschnitt, der das gesamte zu bearbeitende Ereignis zeigt und dessen Motiv überall sichtbar bleibt, wo die Änderung durchgängig gelten soll.
Das Modell kann Änderungen an Hintergrund, Kleidung, Gegenstand, Licht oder Stil auf das gesamte Material übertragen. Eine zusätzliche Bewegungsanweisung hilft, wenn eine neue Handlung benötigt wird, die in der Quelle fehlt und nicht allein aus dem Keyframe hervorgeht, etwa ein sich zeitlich entwickelnder visueller Effekt. Viele Bearbeitungen brauchen keine zusätzliche Bewegungsbeschreibung, weil das Modell die Keyframe-Anpassung innerhalb der vorhandenen Szene animiert. Beschreiben Sie neue Bewegung konkret und getrennt von der bereits durch den Keyframe festgelegten visuellen Änderung.
Der Bearbeitungsablauf des Herstellers wendet eine Änderung standardmäßig auf das gesamte Video an und kann sie auf einen gewählten Zeitleistenbereich begrenzen. Behalten Sie den Originalclip für einen Vergleich und gezielte Folgeänderungen. Prüfen Sie mehr als den ausgewählten Frame: Anfang, Mitte, Ende, jeden Schnitt und den Zeitraum, in dem das Ziel kurz verdeckt wird. Das nutzbare Ergebnis ist ein überarbeiteter Clip, dessen gewünschte Veränderung zeitlich konsistent bleibt und dessen wichtige unveränderte Elemente ihre Rolle behalten.
MP4 ist das Standardformat für Wiedergabe und Weitergabe. Der dafür geeignete Ganzvideo-Ablauf von Edit Studio bietet außerdem ProRes als MOV-Datei mit PCM-Ton oder eine ZIP-Datei einzelner PNG-Frames für Compositing. ProRes-Profile reichen von 422 Proxy bis 4444 XQ. Auf einen Zeitleistenbereich begrenzte Bearbeitungen liefern MP4; das Ausgabeformat wird beim Start der Generierung gewählt und nach Fertigstellung nicht nachträglich geändert. Wählen Sie das Herstellerexportformat passend zur anschließenden Schnittaufgabe und unterscheiden Sie es von der eigentlichen visuellen Bearbeitungsfähigkeit des Modells.
Vergleichen Sie für eine gelungene Bearbeitung den gewünschten Austausch, das Licht oder den Stil mit dem Keyframe und prüfen Sie umgebende Details, die unverändert bleiben sollten. Bewahren Sie die gelungene Version auf und überarbeiten Sie die konkrete Anweisung oder das Vorgabebild, das für eine Abweichung verantwortlich ist. Aleph 2.0 verändert Ausgangsmaterial anhand eines klaren visuellen Ziels; eine neue Tonspur, Änderungen am Verhalten einer Anwendung oder eine separate fertige Sendepipeline sind zusätzliche Aufgaben rund um das bearbeitete Video.
Ailoot Ultra · Videos POST /v1/videos runway/aleph-2
runway/aleph-2Einstieg
Aleph 2.0 bearbeitet vorhandene Videos mit gezielten Textanweisungen und Keyframe-Vorgaben. Ersetzen Sie einen Gegenstand oder ändern Sie Hintergrund, Kleidung, Licht oder Stil und legen Sie dabei fest, 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 · Videos POST /v1/videos
- Eingabe
text,image,audio,video- Ausgabe
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 dessen zurückgegebener Signatur. Eigentümer, Typ und gespeicherter Byte-Nachweis des Assets müssen mit der Anfrage übereinstimmen. |
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 Tokens | TarifstaffelGrundtarif | Prognostizierte Menge— | Gebührenkomponente— | Abrechnungseinheit— | Abrechnungsbedingungen— | Mindestgebührenregel— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · In Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · In Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| 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 für die 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 für die Generierung · Schätzung nur zum Vergleich $1.12 Mindestgebühr für die Generierung Mindestbetrag je Generierung; wenden Sie ihn als Mindestbetrag an, 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 · Videos
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 · Videos
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 und die tatsächlich zurückgegebene id/polling_url auf. Setzen Sie den ursprünglichen Auftrag fort; übermitteln 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