Black Forest Labs: FLUX Video Upscale

O FLUX Video Upscale amplia um clip existente através de melhoria de pormenores fiel à origem ou criativa. O perfil documentado oferece ampliação de 1.5×–3×, preserva o áudio e o enquadramento de origem e limita a duração da fonte, a resolução de entrada e a área dos fotogramas de saída.

Ailoot Ultra · Vídeo POST /v1/videos black-forest-labs/flux-video-upscale

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 Upscale é o fluxo de super-resolução de vídeo da Black Forest Labs baseado no FLUX 3. Recebe um clip existente e devolve um MP4 ampliado, transportando o enquadramento e o áudio de origem para o resultado. Uma descrição curta opcional pode orientar os pormenores visuais melhorados. Os dois modos permitem uma escolha significativa entre manter a aparência fornecida e gerar pormenores mais intensamente, em vez de tratar qualquer imagem maior como uma reconstrução igualmente fiel.

Escolha melhoria precisa ou criativa

A definição de criatividade seleciona o modo. O valor 0 é o perfil preciso, fiel à origem: o fabricante recomenda-o quando um rosto, produto ou recurso de marca precisa de conservar a identidade. O valor 1 ativa a melhoria criativa de pormenores e é a predefinição. Pode restaurar ou inventar textura de forma mais intensa, o que é útil para filmagens geradas, paisagens, multidões ou superfícies cujo pormenor pode ser desenvolvido criativamente.

O fabricante alerta explicitamente que a melhoria criativa não preserva rostos e produtos com o mesmo rigor. Verifique a característica que deve permanecer identificável: aparência facial, contorno de produto, letras, padrão de material ou logótipo. Uma imagem que parece mais nítida pode ainda conter um pormenor alterado ou inventado. Para uma demonstração de produto, use a aparência pretendida do produto como critério de revisão, em vez de escolher uma versão apenas por ter uma textura mais elaborada.

O pedido opcional descreve o conteúdo do clip para orientar a melhoria; uma descrição vazia pede uma ampliação neutra. Um pedido original de cena gerada pode identificar uma parede de pedra coberta de musgo, luz do dia suave e textura fina das folhas. Mantenha a formulação centrada no material a refinar. Pedir a substituição de um objeto, a reconstrução do cenário ou a alteração de diálogo é uma decisão de edição, enquanto este perfil conserva a faixa de áudio de origem.

Fator de ampliação e área do fotograma de saída

O upscale_factor documentado varia de 1.5 a 3, com 2 como predefinição. Amplia a resolução de origem preservando a proporção. O fator selecionado e as dimensões de entrada determinam a saída pretendida, pelo que um clip horizontal e uma composição vertical precisam de ser planeados a partir dos seus fotogramas reais. Prepare o tamanho de apresentação de destino antes de escolher quanta ampliação é útil.

A especificação exata limita cada fotograma de saída a 13.75 unidades de megapíxel do fabricante. A documentação define uma dessas unidades como 1 048 576 píxeis, dando um limite de 14 417 920 píxeis, aproximadamente 14.4 milhões. Isto explica a formulação arredondada de 14.4 megapíxeis no guia. Assim, uma fonte grande pode receber menos ampliação do que o fator pedido. Verifique as dimensões entregues, em vez de assumir que um pedido de 3× produz sempre o triplo de cada dimensão de origem.

O limite publicado de resolução de origem é 2560×1440. Este fluxo amplia uma fonte elegível até 4K e além; não aceita uma fonte já maior apenas porque se pretende uma saída superior. Reduza a resolução ou prepare uma cópia de trabalho adequada antes de usar esse perfil documentado. Guarde separadamente a gravação original para que a comparação final não fique limitada a um intermédio redimensionado.

Prepare uma fonte curta e legível

As orientações normais de preparação do fabricante limitam as fontes a vinte segundos e cinquenta MB. O clip é fornecido através de um URL de vídeo ou MP4 codificado. A referência exata indica que o processamento abrange os primeiros vinte segundos: um pequeno excesso de duração pode ser processado apenas até esse ponto, enquanto um clip substancialmente mais longo é rejeitado. Não está publicada uma tolerância numérica. Corte o segmento pretendido para vinte segundos ou menos, em vez de depender desse comportamento não especificado no limite.

Escolha a versão menos comprimida disponível. Os artefactos de compressão limitam a quantidade de pormenor real que a ampliação pode recuperar, e a melhoria criativa pode criar uma textura plausível sem demonstrar o que existia na cena original. Conclua a edição e o corte pretendidos antes de ampliar o clip selecionado. Um fluxo original pode primeiro terminar um plano de produto, escolher o intervalo de ação útil e depois ampliar essa seleção final, conservando a fonte sem alterações para comparação.

O resultado mantém a faixa de áudio de origem. Examine os seus tempos com a imagem, sobretudo no início e no fim de um segmento selecionado. O perfil documentado não fornece um seletor independente de taxa de fotogramas, geração de diálogo novo nem controlos de edição com imagens de referência. O seu objetivo é um vídeo maior com o tratamento de pormenores escolhido, conservando o material temporal e sonoro da fonte no segmento processado.

Guarde e verifique o clip entregue

O fluxo do fabricante é assíncrono: uma tarefa submetida fornece uma identidade e um local de consulta do estado, e o resultado concluído contém uma ligação assinada para entrega do MP4. Essa ligação expira após cerca de uma hora. Guarde o clip efetivo, a fonte, o fator selecionado, o modo de criatividade e a descrição do conteúdo, em vez de depender do local temporário. Distinga um estado de falha ou de moderação de um vídeo concluído.

Reveja fotogramas individuais quanto a rostos, marcas e alterações de superfície, depois veja a sequência para avaliar continuidade, movimento e alinhamento do áudio. Saídas precisas e criativas respondem a requisitos visuais diferentes; o artefacto útil é o clip ampliado que cumpre o objetivo de fidelidade escolhido no tamanho de apresentação pretendido. Uma resolução maior, por si só, não demonstra que a identidade, a formulação ou os pormenores finos originais permaneceram corretos.

Ailoot Ultra · Vídeo POST /v1/videos black-forest-labs/flux-video-upscale

black-forest-labs/flux-video-upscale

Black Forest Labs /black-forest-labs/flux-video-upscale

Introdução

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
Campo`model`	Tipo`string`	RequisitoObrigatório	Valores e limites black-forest-labs/flux-video-upscale	Predefinição—
Campo`input_references`	Tipo`array`	RequisitoObrigatório	Valores e limites Número mínimo de elementos: 1 Número máximo de elementos: 1	Predefinição—
Campo`upscale_factor`	Tipo`number`	RequisitoObrigatório	Valores e limites Mínimo: 1,5 Máximo: 3	Predefinição—
Campo`creativity`	Tipo`integer`	RequisitoObrigatório	Valores e limites 0, 1	Predefinição—

Parâmetros e ciclo de vida do método

Parâmetro	Contrato
Parâmetro`content_type`	Contratoapplication/json
Parâmetro`required`	Contratomodel, input_references, upscale_factor, creativity
Parâmetro`material_types`	Contratotext, image, audio, video
Parâmetro`material_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	Píxeis por megapíxel	Custo
ConfiguraçãoTarifas base por token	Tabela de tarifasTarifa base	Quantidade prevista—	Unidade de faturação—	Condições de faturação—	Píxeis por megapíxel—	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 megapíxel-segundo	Condições de faturaçãoqualidade: creative	Píxeis por megapíxel1 048 576	Custo Saída · Preço do vídeo · Estimativa apenas para comparação $0.21 por megapíxel-segundo
ConfiguraçãoPreço do vídeo	Tabela de tarifas—	Quantidade prevista—	Unidade de faturaçãopor megapíxel-segundo	Condições de faturaçãoquality: precise	Píxeis por megapíxel1 048 576	Custo Saída · Preço do vídeo · Estimativa apenas para comparação $0.15 por megapíxel-segundo
ConfiguraçãoCusto estimado de geração	Tabela de tarifas—	Quantidade previstaestimativa para uma geração	Unidade de faturação—	Condições de faturação—	Píxeis por megapíxel—	Custo Saída · Custo estimado de geração · Estimativa apenas para comparação $0.15 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_UPSCALE_FACTOR:?Set the actual documented input value}"
export AILOOT_UPSCALE_FACTOR
: "${AILOOT_CREATIVITY:?Set the actual documented input value}"
export AILOOT_CREATIVITY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'black-forest-labs/flux-video-upscale', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}', 'upscale_factor': '${ACTUAL_UPSCALE_FACTOR}', 'creativity': '${ACTUAL_CREATIVITY}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
request['upscale_factor']=float(os.environ['AILOOT_UPSCALE_FACTOR'])
request['creativity']=int(os.environ['AILOOT_CREATIVITY'])
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

Campo	Tipo
Campo`id`	Tipo
Campo`status`	Tipo
Campo`data[]`	Tipo
Campo`outputs[]`	Tipo

Aliases

Aliases do modelo

Ailoot Ultra black-forest-labs/flux-video-upscale

Aliases dos caminhos dos métodos

Use os caminhos dos métodos indicados acima.

IDs de chamada relacionados

black-forest-labs/flux-video-upscale

FAQ · Black Forest Labs: FLUX Video Upscale

Que entradas e resultados estão disponíveis?: POST /v1/videos · black-forest-labs/flux-video-upscale: text, image, audio, video → video
Que campos utiliza o pedido?: POST /v1/videos · black-forest-labs/flux-video-upscale: model, input_references, upscale_factor, creativity
Que limites se aplicam?: POST /v1/videos · black-forest-labs/flux-video-upscale: upscale_factor.minimum: 1.5; upscale_factor.maximum: 3

Black Forest Labs: FLUX Video Upscale