Runway: Aleph 2.0
O Aleph 2.0 edita vídeo existente através de instruções de texto direcionadas e orientação por fotogramas-chave. Use-o para substituir um objeto, alterar um fundo, guarda-roupa, iluminação ou estilo, indicando quais os pormenores da cena original que devem permanecer intactos.
Sobre o modelo
Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo.
O Aleph 2.0 é o modelo de edição de vídeo em contexto da Runway. Transforma filmagens tradicionais ou geradas existentes usando uma instrução escrita e orientação opcional por fotogramas-chave. O fluxo pretendido altera a parte solicitada de uma cena preservando a composição, a iluminação e os pormenores envolventes, tornando-o útil para substituição de produto, mudança de guarda-roupa, transformação de fundo, nova iluminação ou mudança de estilo visual sem recriar toda a cena a partir de um pedido em texto.
Comece com uma ação direta e a transformação desejada: acrescentar, remover, substituir, alterar, iluminar de novo ou mudar o estilo. Para uma substituição de produto, identifique o objeto visível e descreva o substituto, depois indique que movimento de mão, movimento de câmara e cenário envolvente devem permanecer. Para uma cena sazonal, descreva o tempo ou a luz que devem mudar. Uma instrução concisa e direcionada dá um objetivo de edição mais claro do que um pedido genérico para melhorar todo o clip.
A orientação por fotograma-chave estabelece como deve parecer o resultado editado num momento específico. Escolha um fotograma que mostre claramente o alvo: uma vista ampla para uma mudança de fundo, ou uma vista mais próxima para uma característica pequena ou um acessório. No fluxo Edit Studio da Runway, uma edição de imagem estática pode ser pré-visualizada e refinada antes de essa versão selecionada orientar a transformação do vídeo. Compare o fotograma editado com a fonte quanto aos pormenores do sujeito, contornos e objetos que pretende preservar, depois use-o como orientação visual para o clip.
A API do fabricante suporta vídeos de origem de 2 a 30 segundos e até cinco imagens opcionais de fotogramas-chave colocadas em marcas temporais especificadas. Mantenha cada imagem orientadora associada ao ponto pretendido na fonte e use um pequeno número de alterações claras, em vez de uma coleção de objetivos visuais contraditórios. O Aleph 2.0 distingue-se do modelo mais antigo Gen-4 Aleph; o fabricante identifica separadamente o seu modelo na API. Uma edição orientada por fotogramas-chave também é diferente de pedir a um modelo de texto para vídeo que crie um plano sem relação.
As regras documentadas de preparação do Edit Studio usam proporções convencionais, resolução de origem entre 480p e 1080p e 24–30 fotogramas por segundo, com um máximo de dez cortes ou mudanças de plano. Recomendam material de origem de 720p ou 1080p; filmagens acima de 30 fps são reamostradas para uma taxa inferior e carregamentos acima de 30 segundos são cortados nessa interface. Estas são as regras de preparação do fluxo de edição do fabricante. Escolha um segmento de origem que mostre o acontecimento completo a editar e cujo sujeito permaneça visível onde a alteração tem de se manter.
O modelo pode propagar uma alteração de fundo, roupa, objeto, luz ou estilo pelas filmagens. Uma instrução de movimento adicional é útil quando a edição precisa de uma ação nova ausente da fonte e que não resultaria apenas do fotograma-chave, como um efeito visual que se desenvolve com o tempo. Muitas edições não precisam de um pedido de movimento adicional, porque o modelo anima o ajuste do fotograma-chave dentro da cena existente. Descreva especificamente o novo movimento e mantenha-o separado da alteração visual já estabelecida pelo fotograma-chave.
O fluxo de edição do fabricante aplica por predefinição uma edição ao vídeo completo e pode limitá-la a um intervalo selecionado da linha temporal. Conserve o clip original para comparar o resultado selecionado com a fonte e usá-lo numa continuação focada. Uma revisão prática vai além do fotograma escolhido: verifique o início, o meio, o fim, qualquer corte e o período em que o alvo fica brevemente oculto. O artefacto útil é um clip revisto cuja transformação solicitada permanece consistente ao longo do tempo, enquanto os elementos importantes inalterados conservam a sua função.
MP4 é o artefacto predefinido para reprodução e partilha. O fluxo elegível de vídeo completo do Edit Studio da Runway também oferece ProRes como ficheiro MOV com áudio PCM, ou um ZIP de fotogramas PNG individuais para composição. Os perfis ProRes vão de 422 Proxy a 4444 XQ. Edições limitadas a um intervalo da linha temporal devolvem MP4 e o formato de saída é escolhido no início da geração, em vez de alterado após o resultado acabado. Selecione a forma de exportação do fabricante para a tarefa de edição seguinte, mantendo-a separada da capacidade central de edição visual do modelo.
Para uma edição acabada útil, compare a substituição, a iluminação ou o estilo pretendidos com o fotograma-chave e examine os pormenores envolventes que não deviam mudar. Conserve a versão bem-sucedida e reveja a instrução ou o fotograma orientador específico responsável por uma divergência. A função do Aleph 2.0 é transformar filmagens de origem através de um objetivo visual claro; produzir uma nova banda sonora, alterar o comportamento de uma aplicação ou concluir um fluxo separado de entrega para emissão são tarefas adicionais em torno do vídeo editado.
Ailoot Ultra · Vídeo POST /v1/videos runway/aleph-2
runway/aleph-2Introdução
O Aleph 2.0 edita vídeo existente através de instruções de texto direcionadas e orientação por fotogramas-chave. Use-o para substituir um objeto, alterar um fundo, guarda-roupa, iluminação ou estilo, indicando quais os pormenores da cena original que devem permanecer intactos.
- Entradas aceites
- Texto · Imagens · Áudio · Vídeo
- Resultados
- Vídeo
Disponível no Ailoot · entradas e métodos
Ailoot Ultra · Vídeo POST /v1/videos
- Entrada
text,image,audio,video- Saída
video
| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites runway/aleph-2 | Predefinição— |
Campoinput_references | Tipoarray | RequisitoObrigatório | Valores e limites Número mínimo de elementos: 1 Número máximo de elementos: 1 | Predefinição— |
Campoprompt | Tipostring | RequisitoObrigatório | Valores e limites Comprimento mínimo: 1 | Predefinição— |
Parâmetros e ciclo de vida do método
| Parâmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, input_references, prompt |
Parâmetromaterial_types | Contratotext, image, audio, video |
Parâmetromaterial_conditions | ContratoUtilize exatamente um URL real de conteúdo de um recurso de vídeo concluído pertencente ao utilizador, com a assinatura devolvida. O proprietário, o tipo e a prova dos bytes armazenados do recurso têm de corresponder ao pedido. |
Ciclo de vida: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · id ou polling_url efetivamente devolvido
GET /v1/videos/{request_id}/content
Tarifários
Cálculo do custo final
As tarifas apresentadas permitem estimar o custo antes da geração. O montante final cobrado é calculado a partir do custo registado para a geração original. A duração medida do resultado e as quantidades previstas não correspondem à quantidade final faturável.
As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado.
- Modo rápido
- Não especificado Quando o modo rápido está selecionado
- Modo flex
- Não especificado Quando o modo flex está selecionado
- Esforço máximo de raciocínio
- Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default)
Tarifas estimadas para comparação
Preços por configuração
Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas. Aplique a regra do custo mínimo indicada para essa configuração.
| Configuração | Tabela de tarifas | Quantidade prevista | Componente do custo | Unidade de faturação | Condições de faturação | Regra do custo mínimo | Custo |
|---|---|---|---|---|---|---|---|
| ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade prevista— | Componente do custo— | Unidade de faturação— | Condições de faturação— | Regra do custo mínimo— | Custo Entrada · Tokens de entrada · Estimativa apenas para comparação — / 1K tokens Saída · Tokens de saída · Estimativa apenas para comparação — / 1K tokens Entrada · Leitura da cache · Estimativa apenas para comparação — / 1K tokens Entrada · Escrita na cache · Estimativa apenas para comparação — / 1K tokens Entrada · Escrita na cache, 1 hora · Estimativa apenas para comparação — / 1K tokens |
| ConfiguraçãoPreço do vídeo | Tabela de tarifas— | Quantidade prevista— | Componente do custo— | Unidade de faturaçãopor segundo de vídeo | Condições de faturaçãoNão é declarada nenhuma condição adicional nesta chave de preços. | Regra do custo mínimo— | Custo Saída · Preço do vídeo · Estimativa apenas para comparação $0.56 por segundo de vídeo |
| ConfiguraçãoMínimo por geração | Tabela de tarifas— | Quantidade prevista— | Componente do custoCusto mínimo | Unidade de faturaçãocusto mínimo de geração | Condições de faturaçãoNão é declarada nenhuma condição adicional nesta chave de preços. | Regra do custo mínimoSim | Custo total · Mínimo por geração · Estimativa apenas para comparação $1.12 custo mínimo de geração Cobrança mínima por geração; aplique-a como um mínimo, sem a somar como taxa adicional. Não implica uma duração mínima. |
| ConfiguraçãoCusto estimado de geração | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Componente do custo— | Unidade de faturação— | Condições de faturação— | Regra do custo mínimo— | Custo Saída · Custo estimado de geração · Estimativa apenas para comparação $0.56 estimativa antes da geração Esta estimativa não é um encargo adicional nem uma tarifa fixa para a geração concluída. |
O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. Como funcionam a reserva e a liquidação →
Exemplos de pedidos
Ailoot Ultra · Vídeo
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.
Receber e guardar os resultados
Ailoot Ultra · Vídeo
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Guardar todos os recursos concluídos
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
Guardar todos os resultados concluídos
Guarde cada vídeo concluído ou ficheiro devolvido; obtenha cada URL de recurso efetivamente devolvido.
Conserve a resposta completa e os cabeçalhos, todos os resultados efetivamente produzidos, os identificadores originais devolvidos e todos os campos de utilização. Recupere a operação original sem voltar a enviar o pedido de criação.
Se for necessário verificar a resposta original
Conserve X-Client-Request-ID, X-Ailoot-Task-Id e o id/polling_url efetivamente devolvido. Continue a tarefa original; não volte a enviar o pedido de criação.
Campos da resposta
| Campo | Tipo |
|---|---|
Campoid | Tipo |
Campostatus | Tipo |
Campodata[] | Tipo |
Campooutputs[] | Tipo |
Aliases
Aliases do modelo
Ailoot Ultra runway/aleph-2
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
FAQ · Runway: Aleph 2.0
- Que entradas e resultados estão disponíveis?
POST /v1/videos·runway/aleph-2:text,image,audio,video→video- Que campos utiliza o pedido?
POST /v1/videos·runway/aleph-2:model,input_references,prompt