Runway: Aleph 2.0
Aleph 2.0 modifica video esistenti tramite istruzioni testuali mirate e guida con fotogrammi chiave. Usalo per sostituire un oggetto, cambiare sfondo, abiti, illuminazione o stile, indicando quali dettagli della scena originale devono restare intatti.
Informazioni sul modello
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
Aleph 2.0 è il modello di Runway per la modifica video in contesto. Trasforma filmati esistenti, tradizionali o generati, usando un’istruzione scritta e una guida facoltativa con fotogrammi chiave. Il flusso previsto cambia la parte richiesta della scena preservando composizione, illuminazione e dettagli circostanti, rendendolo utile per sostituire un prodotto, cambiare abiti, trasformare lo sfondo, modificare l’illuminazione o lo stile visivo senza ricreare l’intera scena da un brief testuale.
Inizia con un’azione diretta e la trasformazione desiderata: aggiungere, rimuovere, sostituire, cambiare, modificare l’illuminazione o lo stile. Per sostituire un prodotto, identifica l’oggetto visibile e descrivi il sostituto, poi specifica quali movimenti della mano e della camera e quale ambientazione circostante devono restare. Per una scena stagionale, descrivi il tempo atmosferico o la luce da cambiare. Un’istruzione concisa e mirata offre un obiettivo di modifica più chiaro di una richiesta generale di migliorare l’intero clip.
La guida tramite fotogrammi chiave definisce come deve apparire il risultato modificato in un momento particolare. Scegli un fotogramma che mostri chiaramente l’elemento interessato: una vista ampia per cambiare lo sfondo o una più ravvicinata per una piccola caratteristica o un accessorio. Nel flusso Edit Studio di Runway, la modifica di un’immagine fissa può essere visualizzata in anteprima e perfezionata prima che la versione selezionata guidi la trasformazione video. Confronta il fotogramma modificato con la sorgente per dettagli del soggetto, bordi e oggetti da preservare, poi usalo come direzione visiva per il clip.
L’API del produttore supporta video sorgenti da 2 a 30 secondi e fino a cinque immagini facoltative di fotogrammi chiave collocate in momenti specificati. Mantieni ogni immagine guida associata al punto previsto nella sorgente e usa pochi cambiamenti chiari invece di una raccolta di obiettivi visivi contrastanti. Aleph 2.0 è distinto dal precedente modello Gen-4 Aleph; il produttore identifica separatamente il suo modello API. Una modifica guidata da fotogrammi chiave è anche diversa dal chiedere a un modello da testo a video di creare un’inquadratura non collegata.
Le regole di preparazione documentate di Edit Studio usano rapporti d’aspetto convenzionali, risoluzione sorgente tra 480p e 1080p e 24–30 fotogrammi al secondo, con non più di dieci tagli o cambi di inquadratura. Consigliano materiale sorgente a 720p o 1080p; nell’interfaccia, i filmati oltre 30 fps vengono ricampionati a una frequenza inferiore e i caricamenti oltre 30 secondi vengono tagliati. Sono le regole di preparazione del flusso di modifica del produttore. Scegli un segmento sorgente che mostri l’intero evento da modificare e il cui soggetto resti visibile dove il cambiamento deve mantenersi.
Il modello può propagare uno sfondo, un abito, un oggetto, una luce o uno stile modificati lungo il filmato. Un’istruzione di movimento aggiuntivo è utile quando la modifica richiede una nuova azione assente dalla sorgente e non deducibile dal solo fotogramma chiave, come un effetto visivo che si sviluppa nel tempo. Molte modifiche non richiedono un brief di movimento aggiuntivo, perché il modello anima l’adattamento del fotogramma chiave all’interno della scena esistente. Descrivi specificamente il nuovo movimento e tienilo distinto dal cambiamento visivo già definito dal fotogramma chiave.
Il flusso di modifica del produttore applica per impostazione predefinita il cambiamento all’intero video e può limitarlo a un intervallo selezionato della timeline. Conserva il clip originale, così il risultato scelto può essere confrontato con la sorgente e usato per un seguito mirato. Un controllo pratico va oltre il fotogramma selezionato: esamina inizio, parte centrale, fine, ogni taglio e il periodo in cui l’elemento interessato è brevemente nascosto. Il risultato utile è un clip modificato la cui trasformazione richiesta resta coerente nel tempo mentre gli elementi importanti invariati conservano il loro ruolo.
MP4 è il formato predefinito per riproduzione e condivisione. Il flusso Edit Studio di Runway per video completi idonei offre anche ProRes come file MOV con audio PCM oppure un ZIP di singoli fotogrammi PNG per il compositing. I profili ProRes vanno da 422 Proxy a 4444 XQ. Le modifiche limitate a un intervallo della timeline restituiscono MP4, e il formato di output si sceglie all’avvio della generazione invece di cambiarlo dopo il risultato completato. Seleziona la forma di esportazione del produttore adatta al successivo lavoro di montaggio, mantenendola distinta dalla capacità fondamentale di modifica visiva del modello.
Per una modifica finale utile, confronta sostituzione, illuminazione o stile previsti con il fotogramma chiave e controlla i dettagli circostanti che non dovevano cambiare. Conserva la versione riuscita e rivedi l’istruzione specifica o il fotogramma guida responsabile di una differenza. Il ruolo di Aleph 2.0 è trasformare filmati sorgenti tramite un obiettivo visivo chiaro; produrre una nuova colonna sonora, cambiare il comportamento di un’applicazione o completare una pipeline separata di consegna per la diffusione sono attività aggiuntive intorno al video modificato.
Ailoot Ultra · Generazione video POST /v1/videos runway/aleph-2
runway/aleph-2Introduzione
Aleph 2.0 modifica video esistenti tramite istruzioni testuali mirate e guida con fotogrammi chiave. Usalo per sostituire un oggetto, cambiare sfondo, abiti, illuminazione o stile, indicando quali dettagli della scena originale devono restare intatti.
- Input accettati
- Testo · Immagini · Audio · Video
- Risultati
- Video
Disponibile in Ailoot · input e metodi
Ailoot Ultra · Generazione video POST /v1/videos
- Tipi di input
text,image,audio,video- Tipi di output
video
| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti runway/aleph-2 | Predefinito— |
Campoinput_references | Tipoarray | RequisitoObbligatorio | Valori e limiti Numero minimo di elementi: 1 Numero massimo di elementi: 1 | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | Valori e limiti Lunghezza minima: 1 | Predefinito— |
Parametri e ciclo di vita del metodo
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, input_references, prompt |
Parametromaterial_types | Contrattotext, image, audio, video |
Parametromaterial_conditions | ContrattoUsa esattamente un URL reale del contenuto di una risorsa video completata di tua proprietà con la firma restituita. Il proprietario della risorsa, il tipo e la prova dei byte memorizzati devono corrispondere alla richiesta. |
Ciclo di vita: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · id o polling_url effettivamente restituito
GET /v1/videos/{request_id}/content
Tariffe
Calcolo del costo finale
Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile.
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
- Modalità rapida
- Non specificato Quando è selezionata la modalità rapida
- Modalità flex
- Non specificato Quando è selezionata la modalità flex
- Sforzo massimo di ragionamento
- Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)
Tariffe stimate per il confronto
Prezzi per configurazione
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative. Applica la regola del costo minimo indicata per quella configurazione.
| Configurazione | Listino delle tariffe | Quantità prevista | Componente del costo | Unità di fatturazione | Condizioni di fatturazione | Regola del costo minimo | Costo |
|---|---|---|---|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità prevista— | Componente del costo— | Unità di fatturazione— | Condizioni di fatturazione— | Regola del costo minimo— | Costo Input · Token in input · Stima solo a fini di confronto — / 1K token Output · Token in output · Stima solo a fini di confronto — / 1K token Input · Lettura dalla cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache, 1 ora · Stima solo a fini di confronto — / 1K token |
| ConfigurazionePrezzo del video | Listino delle tariffe— | Quantità prevista— | Componente del costo— | Unità di fatturazioneper secondo di video | Condizioni di fatturazioneIn questa chiave tariffaria non è dichiarata alcuna condizione aggiuntiva. | Regola del costo minimo— | Costo Output · Prezzo del video · Stima solo a fini di confronto $0.56 per secondo di video |
| ConfigurazioneMinimo per generazione | Listino delle tariffe— | Quantità prevista— | Componente del costoCosto minimo | Unità di fatturazionecosto minimo di generazione | Condizioni di fatturazioneIn questa chiave tariffaria non è dichiarata alcuna condizione aggiuntiva. | Regola del costo minimoSì | Costo total · Minimo per generazione · Stima solo a fini di confronto $1.12 costo minimo di generazione Addebito minimo per generazione; applicalo come minimo, non come costo aggiuntivo. Non implica una durata minima. |
| ConfigurazioneCosto stimato della generazione | Listino delle tariffe— | Quantità previstastima per una generazione | Componente del costo— | Unità di fatturazione— | Condizioni di fatturazione— | Regola del costo minimo— | Costo Output · Costo di generazione stimato · Stima solo a fini di confronto $0.56 stima prima della generazione Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata. |
Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
Esempi di richieste
Ailoot Ultra · Generazione video
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.
Ricevi e salva i risultati
Ailoot Ultra · Generazione video
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Salva tutte le risorse completate
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
Conserva tutti i risultati completati
Salva ogni video completato o file restituito; recupera ogni URL di risorsa effettivamente restituito.
Conserva la risposta completa e gli header, ogni output effettivo, gli identificatori originali restituiti e tutti i campi di utilizzo. Recupera l'operazione originale senza inviare nuovamente la richiesta di creazione.
Se occorre verificare la risposta originale
Conserva X-Client-Request-ID, X-Ailoot-Task-Id e id/polling_url effettivamente restituiti. Prosegui con l'attività originale; non inviare nuovamente la richiesta di creazione.
Campi della risposta
| Campo | Tipo |
|---|---|
Campoid | Tipo |
Campostatus | Tipo |
Campodata[] | Tipo |
Campooutputs[] | Tipo |
Alias
Alias del modello
Ailoot Ultra runway/aleph-2
Alias dei percorsi dei metodi
Usa i percorsi dei metodi indicati sopra.
ID di chiamata correlati
FAQ · Runway: Aleph 2.0
- Quali input e risultati sono disponibili?
POST /v1/videos·runway/aleph-2:text,image,audio,video→video- Quali campi usa la richiesta?
POST /v1/videos·runway/aleph-2:model,input_references,prompt