Black Forest Labs: FLUX Video Edit
O FLUX Video Edit [fast] transforma um clip existente através de uma instrução de edição escrita. Acrescente, remova ou substitua elementos, altere o cenário ou o estilo e reveja diálogo existente, respeitando as restrições documentadas de duração da fonte, enquadramento e áudio.
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 FLUX Video Edit [fast] é o fluxo da Black Forest Labs orientado por pedidos para alterar um vídeo existente. Recebe um clip de origem e uma instrução que descreve a edição, devolvendo depois um MP4 editado. A fonte estabelece o plano: a duração, o enquadramento, o movimento de câmara e os tempos fornecem a estrutura inicial. Use o pedido para identificar o que deve mudar, em vez de escrever a descrição de uma cena completamente nova que deixe a alteração pretendida pouco clara.
Nomeie a alteração e a sua posição
As edições documentadas incluem remover, acrescentar ou substituir objetos e personagens, reconstruir o cenário, mudar o estilo de um clip, alterar texto visível e rever diálogo ou som. Comece pelo alvo e pela operação. Uma instrução original pode remover um saco de uma cadeira preservando a pessoa sentada e a sala, ou substituir uma caneca simples por uma caneca azul esmaltada sem alterar a ação da mão. Se forem visíveis vários objetos semelhantes, distinga o alvo pela posição, aparência ou função.
Para uma adição, descreva localização, escala e ação relevante. Um candeeiro alto vermelho ao lado do sofá é mais específico do que um candeeiro adicional não especificado algures no plano. Para uma substituição, identifique o que se transforma em quê e o movimento ou contacto que deve permanecer. O guia de pedidos do fabricante recomenda a instrução mais curta que nomeie completamente a alteração, acrescentando pormenores onde a edição os exija. Preserve deliberadamente as características de origem, em vez de pedir uma melhoria genérica cujo âmbito não pode ser avaliado.
Cenários, estilos e animação preliminar
Uma mudança de cenário pode reconstruir o ambiente visível mantendo a ação. O fabricante demonstra a substituição de uma superfície de escalada por uma estrutura diferente e a especificação dos novos pontos de contacto, para as mãos e os pés da personagem continuarem a ter uma superfície com sentido. Numa cena prática, descreva o ambiente alterado e a geometria de que depende o movimento existente. Um novo fundo é mais fácil de avaliar quando a ação original tem uma relação explícita com ele.
O guia também mostra a transformação de uma animação preliminar num tratamento visual acabado. Nomeie quais os objetos da marcação que passam a ser os veículos ou adereços pretendidos, depois conserve as trajetórias, as velocidades e a relação com a câmara. Para mudar o estilo, descreva os materiais, as superfícies, a luz e os reflexos resultantes, além da estética. Uma cena com aspeto de argila e uma cena com aspeto fotográfico precisam de pistas visuais diferentes, mesmo quando seguem a mesma ação.
Uma revisão adicional pode usar o primeiro resultado editado como nova fonte. Guarde o original e cada etapa selecionada e dê à passagem seguinte um propósito claro. O exemplo documentado acompanha uma prévia preliminar até a um cenário acabado e depois a outro tratamento de iluminação. Após cada passagem, compare o clip revisto com a fonte anterior e verifique se as características que pretendia conservar ainda estão presentes.
O diálogo deve caber no tempo existente
O fluxo transporta o áudio de origem, salvo se a instrução pedir uma alteração de diálogo ou som. Uma fonte silenciosa devolve um resultado silencioso, pelo que não fornece fala existente para rever. Para editar diálogo, cite a fala pretendida, identifique o locutor e adeque as novas palavras ao tempo ocupado pela fala de origem. O guia relata o corte de uma substituição mais longa quando excedeu o intervalo de fala disponível. Escrever mais palavras não cria tempo adicional para falar dentro do plano existente.
Reveja a fala audível juntamente com a interpretação visível. Guarde uma cópia da formulação de origem e da substituição pretendida, para identificar uma palavra omitida, uma expressão fora de tempo ou uma alteração sonora indesejada. O resultado útil é o momento falado revisto dentro da cena editada, não uma transcrição considerada fiel apenas porque a renderização terminou.
Limites da fonte e saída herdada
O perfil exato do fabricante exige um vídeo e um pedido de edição. A instrução tem de um a 4096 caracteres após remover os espaços em branco nas extremidades. O clip é fornecido através de um URL ou MP4 codificado, com duração máxima de quinze segundos e limite de entrada de cinquenta MiB. Cada lado deve ter pelo menos 160 píxeis e o clip normalizado deve conter pelo menos dezassete fotogramas a 24 fps, aproximadamente sete décimos de segundo. Fontes demasiado longas são rejeitadas, em vez de cortadas silenciosamente; fontes demasiado pequenas podem falhar durante o processamento.
O fluxo documentado processa a 24 fps e segue a duração e a proporção da fonte. Entradas acima do perfil de 720p são reduzidas; o fabricante dá o exemplo de uma fonte de 1920×1088 devolvida como 1248×704. Duração, resolução e proporção não são definições de saída independentes neste perfil de edição. A receita de amostragem é gerida internamente e campos como mode, version, seed ou generate_audio não são aceites no contrato de pedido indicado.
Um vídeo usado apenas como inspiração de movimento ou estilo para um plano recém-gerado pertence a outro fluxo. Este editor não aceita uma imagem de referência, entrada só de áudio, máscaras nem um pedido de prolongamento do clip. Prepare o vídeo efetivo a alterar e conserve a duração selecionada antes de escrever a edição. Após processamento assíncrono, o fabricante devolve o MP4 editado através de uma ligação de entrega assinada temporária, válida por cerca de uma hora. Guarde o resultado e compare o objeto alterado, os fotogramas envolventes, os tempos e o áudio com a fonte antes de usar o clip numa edição maior.
Ailoot Ultra · Vídeo POST /v1/videos black-forest-labs/flux-video-edit
black-forest-labs/flux-video-edit
black-forest-labs/flux-video-editIntrodução
O FLUX Video Edit [fast] transforma um clip existente através de uma instrução de edição escrita. Acrescente, remova ou substitua elementos, altere o cenário ou o estilo e reveja diálogo existente, respeitando as restrições documentadas de duração da fonte, enquadramento e áudio.
- 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 black-forest-labs/flux-video-edit | 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.
| Configuração | Tabela de tarifas | Quantidade prevista | Unidade de faturação | Condições de faturação | Custo |
|---|---|---|---|---|---|
| ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade prevista— | Unidade de faturação— | Condições de faturação— | 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— | Unidade de faturaçãopor segundo de vídeo | Condições de faturaçãoNão é declarada nenhuma condição adicional nesta chave de preços. | Custo Saída · Preço do vídeo · Estimativa apenas para comparação $0.06 por segundo de vídeo |
| ConfiguraçãoCusto estimado de geração | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Unidade de faturação— | Condições de faturação— | Custo Saída · Custo estimado de geração · Estimativa apenas para comparação $0.06 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': 'black-forest-labs/flux-video-edit', '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 black-forest-labs/flux-video-edit
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
FAQ · Black Forest Labs: FLUX Video Edit
- Que entradas e resultados estão disponíveis?
POST /v1/videos·black-forest-labs/flux-video-edit:text,image,audio,video→video- Que campos utiliza o pedido?
POST /v1/videos·black-forest-labs/flux-video-edit:model,input_references,prompt