Runway: Aleph 2.0
Aleph 2.0 upravuje existujúce video pomocou cielených textových pokynov a vedenia kľúčovými snímkami. Použite ho na náhradu predmetu, zmenu pozadia, oblečenia, osvetlenia alebo štýlu a určite, ktoré detaily pôvodnej scény majú zostať zachované.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Aleph 2.0 je model kontextových úprav videa od Runway. Premieňa existujúce tradičné alebo generované zábery pomocou písaného pokynu a voliteľného vedenia kľúčovými snímkami. Zamýšľaný postup mení požadovanú časť scény pri zachovaní okolitej kompozície, osvetlenia a detailov, takže je užitočný pre náhradu produktu, zmenu oblečenia, premenu pozadia, nové osvetlenie alebo vizuálnu zmenu štýlu bez opätovného vytvorenia celej scény z textového zadania.
Začnite priamou akciou a požadovanou premenou: pridať, odstrániť, nahradiť, zmeniť, zmeniť osvetlenie alebo štýl. Pri náhrade produktu identifikujte viditeľný predmet a opíšte jeho náhradu, potom uveďte pohyb ruky, pohyb kamery a okolité prostredie na zachovanie. Pri sezónnej scéne opíšte počasie alebo svetlo, ktoré sa má zmeniť. Stručný cielený pokyn dáva jasnejší cieľ úprav než všeobecné vylepšenie celého klipu.
Vedenie kľúčovou snímkou stanovuje vzhľad upraveného výsledku v konkrétnom momente. Vyberte snímku jasne ukazujúcu cieľ: široký pohľad pre zmenu pozadia alebo bližší pre malý prvok či doplnok. V postupe Edit Studio od Runway možno úpravu statickej snímky prezrieť a doladiť predtým, než vybraná verzia usmerní premenu videa. Upravenú snímku porovnajte so zdrojom z hľadiska detailov subjektu, okrajov a predmetov na zachovanie a potom ho použite ako vizuálny smer klipu.
API výrobcu podporuje zdrojové videá 2 až 30 sekúnd a až päť voliteľných obrázkov kľúčových snímok umiestnených na určených časových značkách. Každý vodiaci obrázok spojte so zamýšľaným bodom zdroja a používajte malý počet jasných zmien namiesto zbierky protichodných vizuálnych cieľov. Aleph 2.0 sa líši od staršieho modelu Gen-4 Aleph; výrobca jeho API model identifikuje samostatne. Úprava vedená kľúčovými snímkami sa tiež líši od požiadavky na textovo-video model vytvoriť nesúvisiaci záber.
Dokumentované pravidlá prípravy Edit Studio používajú bežné pomery strán, zdrojové rozlíšenie medzi 480p a 1080p a 24–30 snímok za sekundu s najviac desiatimi strihmi alebo zmenami záberu. Odporúča zdroj 720p alebo 1080p; zábery nad 30 fps sa prevzorkujú nadol a nahrávky nad 30 sekúnd sa v tomto rozhraní orežú. Ide o prípravné pravidlá postupu úprav výrobcu. Vyberte zdrojový segment ukazujúci celú udalosť na úpravu, ktorého subjekt zostáva viditeľný tam, kde sa musí zmena preniesť.
Model môže prenášať zmenené pozadie, oblečenie, predmet, svetlo alebo štýl naprieč zábermi. Pokyn dodatočného pohybu je užitočný, keď úprava potrebuje novú akciu chýbajúcu v zdroji, ktorá by nevyplynula len z kľúčovej snímky, napríklad vizuálny efekt vyvíjajúci sa v čase. Mnohé úpravy nepotrebujú zadanie dodatočného pohybu, pretože model animuje úpravu kľúčovej snímky v existujúcej scéne. Nový pohyb opíšte konkrétne a držte ho oddelene od vizuálnej zmeny už stanovenej kľúčovou snímkou.
Postup úprav výrobcu predvolene aplikuje úpravu na celé video a môže ju obmedziť na zvolený rozsah časovej osi. Pôvodný klip uchovajte, aby sa vybraný výsledok dal porovnať so zdrojom a použiť na cielené pokračovanie. Praktická kontrola presahuje vybranú snímku: overte začiatok, stred, koniec, každý strih a obdobie krátkeho zakrytia cieľa. Užitočným výsledkom je revidovaný klip, ktorého požadovaná premena zostáva konzistentná v čase a dôležité nezmenené prvky si zachovávajú úlohu.
MP4 je predvoleným výsledkom na prehrávanie a zdieľanie. Pri celovideových úpravách v Edit Studio od Runway, ktoré spĺňajú podmienky tejto funkcie, sú dostupné aj ProRes ako súbor MOV so zvukom PCM alebo ZIP jednotlivých snímok PNG na skladanie obrazu. Profily ProRes siahajú od 422 Proxy po 4444 XQ. Úpravy obmedzené na rozsah časovej osi vracajú MP4 a výstupný formát sa vyberá pri začatí generovania, nie mení po dokončení výsledku. Exportnú podobu výrobcu vyberte pre nasledujúcu úlohu úprav a odlišujte ju od základnej schopnosti vizuálnych úprav modelu.
Pri užitočnej hotovej úprave porovnajte zamýšľanú náhradu, osvetlenie alebo štýl s kľúčovou snímkou a skontrolujte okolité detaily, ktoré sa nemali zmeniť. Úspešnú verziu zachovajte a revidujte konkrétny pokyn alebo vodiacu snímku zodpovedný za nesúlad. Úlohou Aleph 2.0 je premena zdrojových záberov podľa jasného vizuálneho cieľa; tvorba novej zvukovej stopy, zmena správania aplikácie alebo dokončenie samostatnej vysielacej dodacej cesty sú dodatočné úlohy okolo upraveného videa.
Ailoot Ultra · Generovanie videa POST /v1/videos runway/aleph-2
runway/aleph-2Úvod
Aleph 2.0 upravuje existujúce video pomocou cielených textových pokynov a vedenia kľúčovými snímkami. Použite ho na náhradu predmetu, zmenu pozadia, oblečenia, osvetlenia alebo štýlu a určite, ktoré detaily pôvodnej scény majú zostať zachované.
- Povolené vstupy
- Text · Obrázky · Audio · Video
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Generovanie videa POST /v1/videos
- Vstup
text,image,audio,video- Výstup
video
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity runway/aleph-2 | Predvolené— |
Poleinput_references | Typarray | PožiadavkaPovinné | Hodnoty a limity Minimálny počet položiek: 1 Maximálny počet položiek: 1 | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Minimálna dĺžka: 1 | Predvolené— |
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, input_references, prompt |
Parametermaterial_types | Špecifikáciatext, image, audio, video |
Parametermaterial_conditions | ŠpecifikáciaPoužite presne jednu skutočnú URL obsahu dokončeného videosúboru vo vašom vlastníctve s vráteným podpisom. Vlastník súboru, jeho typ a uložený doklad o jeho bajtoch musia zodpovedať požiadavke. |
Životný cyklus: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · skutočne vrátené id alebo polling_url
GET /v1/videos/{request_id}/content
Cenník
Ako sa vypočíta konečný poplatok
Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Odhadované sadzby na porovnanie
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu. Použite pravidlo minimálneho poplatku uvedené pre danú konfiguráciu.
| Konfigurácia | Sadzobník | Odhadované množstvo | Komponent poplatku | Účtovacia jednotka | Podmienky účtovania | Pravidlo minimálneho poplatku | Poplatok |
|---|---|---|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Komponent poplatku— | Účtovacia jednotka— | Podmienky účtovania— | Pravidlo minimálneho poplatku— | Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov |
| KonfiguráciaCena videa | Sadzobník— | Odhadované množstvo— | Komponent poplatku— | Účtovacia jednotkaza sekundu videa | Podmienky účtovaniaV tomto cenovom kľúči nie je uvedená žiadna ďalšia podmienka. | Pravidlo minimálneho poplatku— | Poplatok Výstup · Cena videa · Odhad iba na porovnanie $0.56 za sekundu videa |
| KonfiguráciaMinimum za generovanie | Sadzobník— | Odhadované množstvo— | Komponent poplatkuMinimálny poplatok | Účtovacia jednotkaminimálny poplatok za generovanie | Podmienky účtovaniaV tomto cenovom kľúči nie je uvedená žiadna ďalšia podmienka. | Pravidlo minimálneho poplatkuÁno | Poplatok total · Minimálna cena generovania · Odhad iba na porovnanie $1.12 minimálny poplatok za generovanie Minimálny poplatok za generovanie; uplatnite ho ako minimum, nie ako ďalší poplatok. Nevyplýva z neho žiadna minimálna dĺžka. |
| KonfiguráciaOdhadované náklady na generovanie | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Komponent poplatku— | Účtovacia jednotka— | Podmienky účtovania— | Pravidlo minimálneho poplatku— | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.56 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie. |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Príklady požiadaviek
Ailoot Ultra · Generovanie videa
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.
Prijať a uložiť výsledky
Ailoot Ultra · Generovanie videa
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Uložiť všetky dokončené podklady
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
Uchovať všetky dokončené výsledky
Uložte každé dokončené video alebo vrátený súbor; načítajte obsah každej skutočne vrátenej URL podkladu.
Uchovajte úplnú odpoveď a hlavičky, všetky skutočné výstupy, pôvodné vrátené identifikátory a všetky polia s údajmi o spotrebe. Obnovte pôvodnú operáciu bez opätovného odoslania požiadavky na vytvorenie.
Ak treba overiť pôvodnú odpoveď
Zachovajte X-Client-Request-ID, X-Ailoot-Task-Id a skutočne vrátené id/polling_url. Pokračujte v pôvodnej úlohe; vytvorenie znova neodosielajte.
Polia odpovede
| Pole | Typ |
|---|---|
Poleid | Typ |
Polestatus | Typ |
Poledata[] | Typ |
Poleoutputs[] | Typ |
Aliasy
Aliasy modelov
Ailoot Ultra runway/aleph-2
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · Runway: Aleph 2.0
- Aké vstupy a výsledky sú dostupné?
POST /v1/videos·runway/aleph-2:text,image,audio,video→video- Aké polia používa požiadavka?
POST /v1/videos·runway/aleph-2:model,input_references,prompt