Source: https://ailoot.ai/models/pt-pt/black-forest-labs-flux-3-video/
Canonical: https://ailoot.ai/models/pt-pt/black-forest-labs-flux-3-video/
Language: pt-pt

# Black Forest Labs: FLUX.3 Video

[Markdown](https://ailoot.ai/models/pt-pt/black-forest-labs-flux-3-video/index.md) · [JSON](https://ailoot.ai/models/pt-pt/black-forest-labs-flux-3-video/facts.json)

## [Black Forest Labs: FLUX.3 Video](https://ailoot.ai/models/pt-pt/black-forest-labs-flux-3-video/)

O FLUX 3 Video cria clips com diálogo, efeitos e ambiente sincronizados a partir de texto, imagens fixadas ou um clip a continuar. Fotogramas-chave, composição com vários planos e melhoria de prévias ajudam a desenvolver uma sequência controlada e a conservar a tomada selecionada.

- [**Ailoot Ultra · Vídeo** `POST /v1/videos` `black-forest-labs/flux-3-video`](https://ailoot.ai/models/pt-pt/black-forest-labs-flux-3-video/#method-0)

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 3 Video é o modelo multimodal da Black Forest Labs para gerar vídeo com áudio sincronizado. Cria cenas a partir de um pedido em texto, constrói movimento em torno de imagens fixadas ou continua um clip existente. Fala, efeitos e ambiente podem ser gerados em conjunto com os fotogramas, apoiando uma cena curta cujo movimento de câmara, ação e som são concebidos como uma única sequência.

Para texto para vídeo, descreva o sujeito, o cenário, a ação visível, o comportamento da câmara e o som. Uma cena de produto útil pode começar com uma vista ampla, aproximar-se de um pormenor de material e terminar com o produto em utilização. Pedidos com vários planos podem nomear cada plano e a transição entre ângulos de câmara, mantendo o sujeito e o estilo visual consistentes ao longo da sequência. A tipografia pode aparecer na cena, por isso forneça as palavras exatas e a sua posição quando um letreiro ou título for importante. O modelo abrange imagem real, animação, grafismo em movimento e visuais estilizados.

Imagem para vídeo usa de uma a dez imagens de fotogramas-chave. Uma única imagem estabelece o fotograma inicial; um par fixa o início e o fim, enquanto imagens ordenadas com marcas temporais orientam momentos específicos do clip. Estas imagens tornam-se fotogramas do vídeo, em vez de servirem apenas como referências gerais de estilo. Com três ou mais imagens sem marcas temporais, o fabricante exige uma duração explícita: a primeira e a última fixam os extremos e as restantes são distribuídas uniformemente entre elas. Os fotogramas com marcas temporais devem estar por ordem cronológica; a duração automática vai até à última marca temporal arredondada por excesso, dentro do máximo de 20 segundos. Prepare fotogramas-chave com sujeitos, enquadramento e pormenores visuais compatíveis, depois descreva o movimento entre eles. Para uma revelação de produto, o primeiro fotograma pode mostrar o objeto fechado e o último a disposição aberta, com a ação intermédia definida no pedido.

A continuação de vídeo parte dos fotogramas finais do clip fornecido. O fluxo de lançamento usa até quatro segundos de vídeo e áudio existentes como contexto para a ação seguinte, transportando o comportamento de câmara, o movimento e o som através da junção. Escolha um final de origem que estabeleça claramente para onde se dirigem o sujeito e a câmara e descreva o que acontece a seguir. Continuação é diferente de reescrever um plano existente: o FLUX Video Edit é um modelo de edição separado e não passa a fazer parte do modelo de geração apenas porque ambos aceitam vídeo.

A geração condicionada por texto e imagem suporta clips de 5 a 20 segundos. A apresentação específica por modo atribui à continuação de vídeo um intervalo de saída de 5–15 segundos. A duração e a proporção podem ser escolhidas automaticamente, ou o pedido pode especificar uma forma horizontal, quadrada ou vertical suportada, incluindo 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16 e 9:21. A saída tem 24 fotogramas por segundo. Escolha a duração em torno de um pequeno número de ações visíveis, em vez de tentar incluir uma história inteira numa geração curta.

A saída HD vem diretamente da geração; FHD, QHD e UHD acabam a mesma cena com um ampliador de vídeo. Para 16:9, as dimensões entregues são, respetivamente, 1280 × 704, 1920 × 1088, 2560 × 1440 e 3840 × 2176. As dimensões são alinhadas a múltiplos de 32, pelo que uma classe de resolução designada pode diferir de um tamanho convencional de entrega. Recorte o fotograma acabado quando precisar de uma tela standard exata, preservando o conteúdo importante nas suas margens. A resolução mais alta é uma etapa de acabamento, não uma interpretação diferente do plano.

O áudio nativo está ativo por predefinição e pode ser desativado para um clip silencioso. Para diálogo, cite a fala, identifique o locutor e descreva a interpretação; fala multilingue, sotaques e sincronização labial fazem parte das capacidades audiovisuais do modelo. Mantenha o diálogo e as indicações sonoras ligados ao acontecimento visível, como uma tampa a fechar ou passos a afastarem-se. Reveja a voz, os tempos e as palavras pronunciadas juntamente com a imagem, em vez de tratar o som como uma camada sem relação acrescentada após a geração.

O modo Draft produz uma pré-visualização HD e um pacote de prévia. Melhore o pacote selecionado para renderizar essa geração com qualidade completa; enviar o mesmo pedido como um novo pedido de renderização completa é uma nova interpretação e pode produzir uma tomada diferente. As prévias usam apenas HD, enquanto a melhoria pode selecionar as quatro classes de resolução e tem FHD como predefinição. Isto permite uma sequência prática de explorar primeiro a ação e a composição e depois acabar a tomada escolhida no tamanho de entrega pretendido.

O fluxo do fabricante devolve um identificador de tarefa antes de o MP4 estar pronto e fornece depois o clip concluído quando o processamento termina. Os locais assinados de resultados expiram após cerca de duas horas, por isso guarde o recurso efetivo quando o plano for selecionado. Examine as transições de fotogramas-chave, os cortes, a tipografia, os pormenores do sujeito e a junção áudio face ao pedido. Para uma sequência mais longa, conserve as referências e o contexto final do plano bem-sucedido como entrada para o clip seguinte, em vez de assumir que um pedido curto contém toda a produção.

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

[`black-forest-labs/flux-3-video`](https://ailoot.ai/models/pt-pt/#m=black-forest-labs%2Fflux-3-video&route=Ultra&caller=black-forest-labs%2Fflux-3-video&fmt=videos)

Black Forest Labs /`black-forest-labs/flux-3-video`

### Introdução

O FLUX 3 Video cria clips com diálogo, efeitos e ambiente sincronizados a partir de texto, imagens fixadas ou um clip a continuar. Fotogramas-chave, composição com vários planos e melhoria de prévias ajudam a desenvolver uma sequência controlada e a conservar a tomada selecionada.

Entradas aceites

Texto · Imagens

Resultados

Vídeo

### Disponível no Ailoot · entradas e métodos

**Ailoot Ultra · Vídeo** `POST /v1/videos`

Entrada

`text`, `image`

Saída

`video`

Formato de saída

bytes MP4 originais; sem normalização nem transcodificação

| Campo | Tipo | Requisito | Valores e limites | Predefinição |
| --- | --- | --- | --- | --- |
| Campo`model` | Tipo`string` | RequisitoObrigatório | Valores e limites black-forest-labs/flux-3-video | Predefinição— |
| Campo`prompt` | Tipo`string` | RequisitoObrigatório | Valores e limites | Predefinição— |
| Campo`duration` | Tipo`integer` | RequisitoObrigatório | Valores e limites 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20 Mínimo: 1 Máximo: 600 | Predefinição— |
| Campo`resolution` | Tipo`string` | RequisitoOpcional | Valores e limites 720p, 1080p | Predefinição— |
| Campo`aspect_ratio` | Tipo`string` | RequisitoOpcional | Valores e limites 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Predefinição— |
| Campo`generate_audio` | Tipo`boolean` | RequisitoOpcional | Valores e limites false, true | Predefinição— |
| Campo`frame_images` | Tipo`array` | RequisitoOpcional | Valores e limites Número mínimo de elementos: 1 Número máximo de elementos: 2 Conteúdo de entrada: Matriz de objetos de fotograma. Cada objeto tem type=image\_url, image\_url com url e frame\_type. Utilize um URL HTTPS de imagem e defina frame\_type como first\_frame ou last\_frame. Cada função de fotograma aparece, no máximo, uma vez. Chaves exatas: type, image\_url, frame\_type Condições: Estas chaves descrevem cada objeto de fotograma; image\_url contém apenas url. Omita frame\_images num pedido apenas de texto. | Predefinição— |
| Campo`input_references` | Tipo`array` | RequisitoOpcional | Valores e limites | Predefinição— |
| Campo`previous_job_id` | Tipo`string` | RequisitoOpcional | Valores e limites Padrão: ^video\_\[0-9a-f\]{8}-\[0-9a-f\]{4}-\[0-9a-f\]{4}-\[0-9a-f\]{4}-\[0-9a-f\]{12}$ | Predefinição— |
| Campo`callback_url` | Tipo`string` | RequisitoOpcional | Valores e limites Padrão: ^https:// | Predefinição— |
| Campo`session_id` | Tipo`string` | RequisitoOpcional | Valores e limites | Predefinição— |
| Campo`trace` | Tipo`object` | RequisitoOpcional | Valores e limites | Predefinição— |
| Campo`user` | Tipo`string` | RequisitoOpcional | Valores e limites | Predefinição— |

Combinações de materiais de entrada

**Texto para vídeo** · Uma instrução escrita. · Obrigatório: model, prompt, duration

`Forneça prompt como texto e duration em segundos inteiros. Escolha uma resolução suportada e, se necessário, uma proporção.`

`model`: Tipo: string · black-forest-labs/flux-3-video

`prompt`: Tipo: string · Número máximo de bytes UTF-8: 10 000 · São obrigatórios caracteres que não sejam espaços: Sim

**Imagem para vídeo** · Uma instrução escrita e uma imagem do primeiro fotograma. · Obrigatório: model, prompt, duration, frame\_images

`frame_images é uma matriz. Cada objeto de fotograma tem type, image_url e frame_type; image_url contém url. Defina type como image_url. Utilize first_frame com um last_frame opcional. Cada função de fotograma aparece, no máximo, uma vez. Forneça um URL HTTPS público de imagem para cada fotograma. Escolha uma resolução suportada e, se necessário, uma proporção.`

Chaves exatas: type, image\_url, frame\_type

`model`: Tipo: string · black-forest-labs/flux-3-video

`prompt`: Tipo: string · Número máximo de bytes UTF-8: 10 000 · São obrigatórios caracteres que não sejam espaços: Sim

**Continue a video** · Uma instrução escrita e o seu vídeo original concluído. · Obrigatório: model, prompt, duration, previous\_job\_id

`Defina previous_job_id como o ID público de vídeo do seu original concluído. Utilize o mesmo modelo, conta e chave API. Conserve a identidade da tarefa existente; este pedido cria uma tarefa de continuação separada. Escolha uma resolução suportada e, se necessário, uma proporção.`

`model`: Tipo: string · black-forest-labs/flux-3-video

`prompt`: Tipo: string · Número máximo de bytes UTF-8: 10 000 · São obrigatórios caracteres que não sejam espaços: Sim

Parâmetros e ciclo de vida do método

| Parâmetro | Contrato |
| --- | --- |
| Parâmetro`content_type` | Contratoapplication/json |
| Parâmetro`required` | Contratomodel, prompt, duration |
| Parâmetro`material_types` | Contratotext, image |
| Parâmetro`additional_properties` | Contratofalse |
| Parâmetro`optional_controls` | Contratoresolution, aspect\_ratio, generate\_audio, frame\_images, input\_references, previous\_job\_id, callback\_url, session\_id, trace, user |

Ciclo de vida: `submit_once_poll_original`

`GET /v1/videos/{public_id}`

`GET /v1/videos/{public_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 | Componente do custo | Modo de referência | Unidade de faturação | Condições de faturação | Custo |
| --- | --- | --- | --- | --- | --- | --- | --- |
| ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade prevista— | Componente do custo— | Modo de referência— | 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çãoTexto para vídeo · Imagem para vídeo (imagens de fotogramas) · tarifa de referência | Tabela de tarifas— | Quantidade prevista— | Componente do custo`reference_output_rate` | Modo de referênciaTexto para vídeo · Imagem para vídeo (fotogramas) | Unidade de faturaçãopor segundo de saída | Condições de faturação— | Custo Saída · Tarifa de referência por segundo de vídeo de saída · Estimativa apenas para comparação **$0.34** por segundo de saída |
| ConfiguraçãoPreço do vídeo | Tabela de tarifas— | Quantidade prevista— | Componente do custo— | Modo de referência— | Unidade de faturaçãopor segundo de vídeo | Condições de faturaçãoresolution: 1080p | Custo Saída · Preço do vídeo · Estimativa apenas para comparação **$0.58** por segundo de vídeo |
| ConfiguraçãoPreço do vídeo | Tabela de tarifas— | Quantidade prevista— | Componente do custo— | Modo de referência— | Unidade de faturaçãopor segundo de vídeo | Condições de faturaçãoresolution: 720p | Custo Saída · Preço do vídeo · Estimativa apenas para comparação **$0.34** por segundo de vídeo |
| ConfiguraçãoPreço do vídeo | Tabela de tarifas— | Quantidade prevista— | Componente do custo— | Modo de referência— | Unidade de faturaçãopor segundo de vídeo | Condições de faturaçãoentrada: video\_continuation; resolução: 1080p | Custo Saída · Preço do vídeo · Estimativa apenas para comparação **$1.06** por segundo de vídeo |
| ConfiguraçãoPreço do vídeo | Tabela de tarifas— | Quantidade prevista— | Componente do custo— | Modo de referência— | Unidade de faturaçãopor segundo de vídeo | Condições de faturaçãoentrada: video\_continuation; resolução: 720p | Custo Saída · Preço do vídeo · Estimativa apenas para comparação **$0.82** por segundo de vídeo |
| ConfiguraçãoCusto estimado de geração | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Componente do custo— | Modo de referência— | Unidade de faturação— | Condições de faturação— | Custo Saída · Custo estimado de geração · Estimativa apenas para comparação **$1.7** 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 →](https://ailoot.ai/docs/pt-pt/billing/reserve/)

#### Detalhes da tarifa de referência

As tabelas de referência do modelo não alteram a seleção do método, as cotações ou os custos. Os custos ativos usam as tarifas do método Ailoot selecionado.

Referências de preços das configurações de vídeo

#### 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 | Condições de faturação | Custo |
| --- | --- | --- |
| ConfiguraçãoPreço do 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 **$0.34** por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãoresolution: 720p | Custo Saída · Preço do vídeo **$0.34** por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãoresolution: 1080p | Custo Saída · Preço do vídeo **$0.58** por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãoentrada: video\_continuation; resolução: 720p | Custo Saída · Preço do vídeo **$0.82** por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãoentrada: video\_continuation; resolução: 1080p | Custo Saída · Preço do vídeo **$1.06** por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |

### Exemplos de pedidos

#### Ailoot Ultra · Vídeo

curl · crie um vídeo

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"black-forest-labs/flux-3-video","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', 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 result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

### Receber e guardar os resultados

#### Ailoot Ultra · Vídeo

URLs assinados para conteúdo pertencente ao utilizador

- `GET /v1/videos/{public_id}`
- `GET /v1/videos/{public_id}/content`

##### Verificar o estado da tarefa

GET estado da operação original

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

Outras leituras de conteúdo

Guardar cada saída concluída de que é titular

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
```

##### Guardar todos os resultados concluídos

Guarde cada vídeo concluído ou ficheiro devolvido; obtenha cada URL de recurso efetivamente devolvido.

Conserve todos os resultados reais que pertencem ao utilizador e os respetivos metadados medidos devolvidos.

##### Se for necessário verificar a resposta original

503 result\_pending\_check + id original + X-Should-Retry:false; nunca repita o original

Campos da resposta

| Campo | Tipo | Significado |
| --- | --- | --- |
| Campo`index` | Tipointeger | SignificadoPosição deste vídeo na lista de saídas, com contagem a partir de zero. |
| Campo`content_url` | Tipostring | SignificadoURL HTTPS assinado para transferir este vídeo concluído. |
| Campo`sha256` | Tipostring \| null | SignificadoResumo criptográfico SHA-256 dos bytes do vídeo original; null se não estiver disponível. |
| Campo`size_bytes` | Tipointeger \| null | SignificadoTamanho do ficheiro de vídeo original em bytes; null se não estiver disponível. |
| Campo`duration_ms` | Tipointeger \| null | SignificadoDuração medida do vídeo em milissegundos; null se não estiver disponível. |
| Campo`width` | Tipointeger \| null | SignificadoLargura do vídeo em píxeis; null se não estiver disponível. |
| Campo`height` | Tipointeger \| null | SignificadoAltura do vídeo em píxeis; null se não estiver disponível. |
| Campo`video_codec` | Tipostring \| null | SignificadoIdentificador do codec de vídeo; null se não estiver registado. |
| Campo`has_audio` | Tipoboolean \| null | SignificadoIndica se o vídeo contém uma faixa de áudio; null se não tiver sido medido. |
| Campo`audio_codec` | Tipostring \| null | SignificadoIdentificador do codec de áudio; null quando não está registado qualquer identificador. |

Erros e passos seguintes

| Resposta | Condição | Passo seguinte |
| --- | --- | --- |
| Resposta404 · `not_found_error` | CondiçãoO acesso ao vídeo não está disponível ou este ID de vídeo não foi encontrado. | Passo seguinteVerifique o acesso ao vídeo. Para um vídeo existente, utilize o ID público original e a mesma chave API. |
| Resposta401 · `authentication_error` | CondiçãoA chave API não corresponde à conta autenticada. | Passo seguinteVerifique a sua chave API e o acesso à conta antes de enviar. |
| Resposta400 · `invalid_request_error` | CondiçãoNão foi possível ler o pedido ou o índice de transferência é inválido. | Passo seguinteCorrija o corpo do pedido. Para uma transferência, escolha um índice de saída devolvido pela tarefa original. |
| Resposta422 · `price_unavailable` | CondiçãoNão é possível calcular o preço da configuração de vídeo selecionada. | Passo seguinteEscolha uma configuração de vídeo suportada e preencha as opções obrigatórias antes de enviar um pedido corrigido. |
| Resposta422 · `invalid_request_error` | CondiçãoUma entrada de vídeo ou a tarefa original de continuação é inválida. | Passo seguinteUtilize entradas HTTPS válidas. Para continuação, utilize o ID público do seu vídeo original concluído com a mesma chave API. |
| Resposta402 · `billing_error` | CondiçãoO saldo disponível ou os limites não permitem efetuar uma reserva. | Passo seguinteVerifique o saldo disponível e os limites antes de enviar um novo pedido. |
| Resposta503 · `server_error` | CondiçãoA verificação, o armazenamento ou o acesso ao serviço de vídeo está temporariamente indisponível. | Passo seguinteAguarde a disponibilidade do serviço. Se já tiver um ID de vídeo, consulte essa tarefa original em vez de criar outra geração. |
| Resposta503 · `result_pending_check` | CondiçãoO resultado e a cobrança do vídeo original precisam de verificação. | Passo seguinteConserve o ID de vídeo devolvido e consulte essa tarefa. Não envie um pedido de geração substituto enquanto estiver a ser verificada. |
| Resposta503 · `owned_result_unavailable` | CondiçãoA transferência do vídeo existente está temporariamente indisponível. | Passo seguinteConsulte a mesma tarefa de vídeo mais tarde e transfira a saída existente. Uma nova geração cria uma operação separada. |
| Resposta409 · `video_not_ready` | CondiçãoO conteúdo do vídeo não foi publicado. | Passo seguinteConsulte o estado da tarefa original. Transfira quando indicar completed; se indicar failed, siga o aviso de verificação da cobrança. |

### Aliases

#### Aliases do modelo

**Ailoot Ultra** [`black-forest-labs/flux-3-video`](https://ailoot.ai/models/pt-pt/#m=black-forest-labs%2Fflux-3-video&route=Ultra&caller=black-forest-labs%2Fflux-3-video&fmt=videos)

#### Aliases dos caminhos dos métodos

Use os caminhos dos métodos indicados acima.

#### IDs de chamada relacionados

[`black-forest-labs/flux-3-video`](https://ailoot.ai/models/pt-pt/#m=black-forest-labs%2Fflux-3-video&route=Ultra&caller=black-forest-labs%2Fflux-3-video&fmt=videos)

FAQ · Black Forest Labs: FLUX.3 Video

Que entradas e resultados estão disponíveis?

`POST /v1/videos` · `black-forest-labs/flux-3-video`: `text`, `image` → `video`

Que campos utiliza o pedido?

`POST /v1/videos` · `black-forest-labs/flux-3-video`: `model`, `prompt`, `duration`, `resolution`, `aspect_ratio`, `generate_audio`, `frame_images`, `input_references`, `previous_job_id`, `callback_url`, `session_id`, `trace`, `user`

Que limites se aplicam?

`POST /v1/videos` · `black-forest-labs/flux-3-video`: `duration.minimum`: `1`; `duration.maximum`: `600`; `frame_images.max_items`: `2`; `frame_images.min_items`: `1`

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](https://ailoot.ai/docs/pt-pt/billing/subscriptions/) · [Ver preços dos modelos](https://ailoot.ai/models/pt-pt/)

## 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](mailto:support@ailoot.ai) · [Oferta e contrato de licença](https://ailoot.ai/legal/offer?lang=pt-pt)

## Ailoot · A empresa e a sua carteira de projetos





A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI.





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





A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.