Runway: Aleph 2.0
Aleph 2.0 bewerkt bestaande video via gerichte tekstinstructies en keyframesturing. Gebruik het om een object te vervangen of achtergrond, kleding, belichting of stijl te veranderen en stuur daarbij welke details van de oorspronkelijke scène intact moeten blijven.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Aleph 2.0 is het in-contextvideobewerkingsmodel van Runway. Het transformeert bestaand traditioneel of gegenereerd beeldmateriaal met een geschreven instructie en optionele keyframesturing. De bedoelde workflow verandert het gevraagde deel van een scène met behoud van de omliggende compositie, belichting en details. Dat maakt het nuttig voor productvervanging, kledingwijziging, achtergrondtransformatie, nieuwe belichting of visuele restyling zonder de hele scène opnieuw uit een tekstbriefing te maken.
Begin met een directe actie en de gewenste transformatie: toevoegen, verwijderen, vervangen, veranderen, opnieuw belichten of restylen. Identificeer voor een productvervanging het zichtbare object en beschrijf de vervanging; geef vervolgens aan welke handbeweging, camerabeweging en omliggende omgeving behouden moeten blijven. Beschrijf voor een seizoensscène het weer of licht dat moet veranderen. Een beknopte, gerichte instructie geeft een duidelijker bewerkingsdoel dan een algemeen verzoek om de hele clip te verbeteren.
Keyframesturing legt vast hoe het bewerkte resultaat er op een bepaald moment uit moet zien. Kies een frame dat het doel duidelijk toont: een ruim beeld voor een achtergrondwijziging of een dichterbijbeeld voor een klein kenmerk of accessoire. In de Edit Studio-workflow van Runway kan een bewerking van een stilstaand frame worden bekeken en verfijnd voordat die geselecteerde versie de videotransformatie stuurt. Vergelijk het bewerkte frame met de bron op de onderwerpdetails, randen en objecten die u wilt behouden en gebruik het daarna als visuele richting voor de clip.
De API van de producent ondersteunt bronvideo's van 2 tot 30 seconden en maximaal vijf optionele keyframebeelden op opgegeven tijdstippen. Houd elk sturend beeld gekoppeld aan het bedoelde punt in de bron en gebruik een klein aantal duidelijke wijzigingen in plaats van een verzameling tegenstrijdige visuele doelen. Aleph 2.0 staat los van het oudere Gen-4 Aleph-model; de producent identificeert het API-model afzonderlijk. Een keyframegestuurde bewerking is ook iets anders dan een tekst-naar-videomodel vragen om een niet-gerelateerd shot te creëren.
De gedocumenteerde voorbereidingsregels van Edit Studio gebruiken conventionele beeldverhoudingen, een bronresolutie tussen 480p en 1080p en 24–30 frames per seconde, met maximaal tien cuts of shotwisselingen. De workflow beveelt bronmateriaal op 720p of 1080p aan; beeldmateriaal boven 30 fps wordt gedownsampled en uploads langer dan 30 seconden worden in die interface ingekort. Dit zijn de voorbereidingsregels van de bewerkingsworkflow van de producent. Kies een bronsegment dat de volledige te bewerken gebeurtenis toont en waarvan het onderwerp zichtbaar blijft waar de wijziging moet doorlopen.
Het model kan een gewijzigde achtergrond, kleding, object, licht of stijl door het beeldmateriaal heen doorvoeren. Een instructie voor extra beweging is nuttig wanneer de bewerking een nieuwe actie nodig heeft die in de bron ontbreekt en niet uit het keyframe alleen zou volgen, zoals een visueel effect dat zich in de tijd ontwikkelt. Veel bewerkingen hebben geen briefing voor extra beweging nodig, omdat het model de keyframeaanpassing binnen de bestaande scène animeert. Beschrijf een nieuwe beweging specifiek en houd die gescheiden van de visuele wijziging die het keyframe al vastlegt.
De bewerkingsworkflow van de producent past een bewerking standaard op de volledige video toe en kan deze tot een geselecteerd tijdlijnbereik beperken. Bewaar de oorspronkelijke clip zodat het geselecteerde resultaat met de bron kan worden vergeleken en voor een gericht vervolg kan worden gebruikt. Een praktische beoordeling kijkt verder dan het gekozen frame: controleer begin, midden, einde, elke cut en de periode waarin het doel kort aan het zicht wordt onttrokken. Het bruikbare resultaat is een herziene clip waarvan de gevraagde transformatie in de tijd consistent blijft en waarin de belangrijke ongewijzigde elementen hun rol behouden.
MP4 is het standaardbestand voor afspelen en delen. De daarvoor geschikte Edit Studio-workflow van Runway voor volledige video's biedt ook ProRes als MOV-bestand met PCM-audio of een ZIP met afzonderlijke PNG-frames voor compositing. ProRes-profielen lopen van 422 Proxy tot 4444 XQ. Bewerkingen die tot een tijdlijnbereik zijn beperkt, geven MP4 terug en het uitvoerformaat wordt bij de start van de generatie gekozen, in plaats van na het voltooide resultaat te worden veranderd. Selecteer de exportvorm van de producent voor de volgende montagetaak en houd die gescheiden van de kernmogelijkheid van het model voor visuele bewerking.
Vergelijk voor een bruikbare voltooide bewerking de bedoelde vervanging, belichting of stijl met het keyframe en controleer omliggende details die niet moesten veranderen. Bewaar de geslaagde versie en herzie de specifieke instructie of het sturende frame dat verantwoordelijk is voor een afwijking. De rol van Aleph 2.0 is bronmateriaal via een duidelijk visueel doel te transformeren; een nieuwe soundtrack produceren, het gedrag van een toepassing veranderen of een afzonderlijke uitzendleveringsketen afronden zijn aanvullende taken rond de bewerkte video.
Ailoot Ultra · Videogeneratie POST /v1/videos runway/aleph-2
runway/aleph-2Aan de slag
Aleph 2.0 bewerkt bestaande video via gerichte tekstinstructies en keyframesturing. Gebruik het om een object te vervangen of achtergrond, kleding, belichting of stijl te veranderen en stuur daarbij welke details van de oorspronkelijke scène intact moeten blijven.
- Toegestane invoer
- Tekst · Afbeeldingen · Audio · Video
- Resultaten
- Video
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Videogeneratie POST /v1/videos
- Invoer
text,image,audio,video- Uitvoer
video
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten runway/aleph-2 | Standaard— |
Veldinput_references | Typearray | VereisteVereist | Waarden en limieten Minimumaantal items: 1 Maximumaantal items: 1 | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, input_references, prompt |
Parametermaterial_types | Contracttext, image, audio, video |
Parametermaterial_conditions | ContractGebruik precies één werkelijke inhouds-URL van een voltooide video-asset die je toebehoort, met de teruggestuurde handtekening. De eigenaar, het type en het opgeslagen bewijs van de bytes van de asset moeten overeenkomen met de aanvraag. |
Levenscyclus: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · werkelijk teruggestuurde id of polling_url
GET /v1/videos/{request_id}/content
Tarieven
Zo worden de uiteindelijke kosten berekend
De getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus geselecteerd is
- Flex-modus
- Niet opgegeven Wanneer de flex-modus geselecteerd is
- Maximale redeneerinspanning
- Niet opgegeven Wanneer voor maximale redeneerinspanning de default-aanpassing wordt gebruikt
Geschatte tarieven ter vergelijking
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties. Pas de getoonde regel voor het minimumbedrag van die configuratie toe.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Kostencomponent | Rekeneenheid | Factureringsvoorwaarden | Regel voor minimumbedrag | Kosten |
|---|---|---|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Kostencomponent— | Rekeneenheid— | Factureringsvoorwaarden— | Regel voor minimumbedrag— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| ConfiguratieVideoprijs | Tariefstaffel— | Verwachte hoeveelheid— | Kostencomponent— | Rekeneenheidper videoseconde | FactureringsvoorwaardenIn deze prijssleutel is geen bijkomende voorwaarde opgegeven. | Regel voor minimumbedrag— | Kosten Uitvoer · Videoprijs · Schatting uitsluitend ter vergelijking $0.56 per videoseconde |
| ConfiguratieMinimum per generatie | Tariefstaffel— | Verwachte hoeveelheid— | KostencomponentMinimumbedrag | Rekeneenheidminimumkosten voor generatie | FactureringsvoorwaardenIn deze prijssleutel is geen bijkomende voorwaarde opgegeven. | Regel voor minimumbedragJa | Kosten total · Minimum per generatie · Schatting uitsluitend ter vergelijking $1.12 minimumkosten voor generatie Minimumbedrag per generatie; pas dit toe als minimum en niet als extra kost. Dit houdt geen minimumduur in. |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Kostencomponent— | Rekeneenheid— | Factureringsvoorwaarden— | Regel voor minimumbedrag— | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.56 schatting vóór generatie Deze raming is geen extra kost of vast tarief voor de voltooide generatie. |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
Ailoot Ultra · Videogeneratie
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.
Resultaten ophalen en opslaan
Ailoot Ultra · Videogeneratie
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Alle voltooide bestanden opslaan
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 voltooide resultaten bewaren
Sla elke voltooide video of elk teruggegeven bestand op; haal elke daadwerkelijk teruggegeven bestands-URL op.
Bewaar de volledige respons en headers, iedere daadwerkelijke uitvoer, de oorspronkelijk teruggegeven identificatoren en alle verbruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar X-Client-Request-ID, X-Ailoot-Task-Id en de werkelijk teruggestuurde id/polling_url. Zet de oorspronkelijke opdracht voort; dien de aanmaakaanvraag niet opnieuw in.
Antwoordvelden
| Veld | Type |
|---|---|
Veldid | Type |
Veldstatus | Type |
Velddata[] | Type |
Veldoutputs[] | Type |
Aliasnamen
Modelaliasnamen
Ailoot Ultra runway/aleph-2
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · Runway: Aleph 2.0
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/videos·runway/aleph-2:text,image,audio,video→video- Welke velden gebruikt het verzoek?
POST /v1/videos·runway/aleph-2:model,input_references,prompt