modelos

Black Forest Labs: FLUX Video Edit

Markdown · JSON

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 /black-forest-labs/flux-video-edit

Introduçã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
CampoTipoRequisitoValores e limitesPredefinição
CampomodelTipostringRequisitoObrigatórioValores e limites
black-forest-labs/flux-video-edit
Predefinição—
Campoinput_referencesTipoarrayRequisitoObrigatórioValores e limites
Número mínimo de elementos: 1
Número máximo de elementos: 1
Predefinição—
CampopromptTipostringRequisitoObrigatórioValores e limites
Comprimento mínimo: 1
Predefinição—
Parâmetros e ciclo de vida do método
ParâmetroContrato
Parâmetrocontent_typeContratoapplication/json
ParâmetrorequiredContratomodel, input_references, prompt
Parâmetromaterial_typesContratotext, image, audio, video
Parâmetromaterial_conditionsContratoUtilize 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çãoTabela de tarifasQuantidade previstaUnidade de faturaçãoCondições de faturaçãoCusto
ConfiguraçãoTarifas base por tokenTabela de tarifasTarifa baseQuantidade 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ídeoTabela de tarifas—Quantidade prevista—Unidade de faturaçãopor segundo de vídeoCondiçõ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çãoTabela de tarifas—Quantidade previstaestimativa para uma geraçãoUnidade 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

Use dados de entrada reais e guarde o resultado completo
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
GET 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
CampoTipo
CampoidTipo
CampostatusTipo
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

black-forest-labs/flux-video-edit

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

Mais detalhes

Ligue o Ailoot ao Claude Code, OpenCode, Hermes ou à sua aplicação.

A empresa e a sua carteira de projetos

A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões.

Compre tokens com desconto.

Desconto por subscrição para trabalho regular. Códigos promocionais — até 50% na compra de tokens.

Subscrição
Escolha um plano com desconto para os pedidos regulares.
Código promocional até 50%
Introduza o código na compra. O preço é recalculado conforme a campanha em vigor.
Custos no histórico
O modelo, os tokens e o montante são guardados para cada pedido.

Escolher subscrição · Ver preços dos modelos

Ligue a API ao produto que vende.

SaaS, aplicações e bots — ao abrigo da oferta e do contrato de licença Ailoot. Para revenda, peça uma licença de revendedor.

Aplicação comercial
Integre geração de texto, imagens, vídeo e som nas funcionalidades pagas do seu serviço.
Licença de revendedor
Envie uma descrição do projeto e do modelo de acesso. Peça condições escritas de utilização e revenda.
Documentos no site
A oferta, o contrato de licença e a política de tratamento de dados estão disponíveis antes da ligação.

Pedir licença de revendedor · Oferta e contrato de licença