FLUX 3 API
A API FLUX 3 da Black Forest Labs já está no ar na WaveSpeedAI, com endpoints de texto para vídeo, imagem para vídeo, vídeo de quadro inicial e final, extensão de vídeo, Draft e upscale de vídeo. Gere clipes de 5 a 20 segundos em 720P ou 1080P, com áudio sincronizado opcional, em uma única API pronta para produção.
Este guia da API FLUX 3 cobre os endpoints ativos da WaveSpeedAI, preços, exemplos, fluxo de integração, variantes Draft e workflows de vídeo em produção. O playground, os cards de endpoint, os preços, os exemplos e os códigos de exemplo abaixo usam a família black-forest-labs/flux-3 em produção.
Visão geral
Sobre o FLUX 3 API
O que o FLUX 3 faz, como ele se encaixa na linha de modelos da Black Forest Labs e por que as equipes o escolhem.
FLUX 3 é um modelo de geração de vídeo da Black Forest Labs, disponível pela API REST da WaveSpeedAI. A API FLUX 3 da Black Forest Labs já está no ar na WaveSpeedAI, com endpoints de texto para vídeo, imagem para vídeo, vídeo de quadro inicial e final, extensão de vídeo, Draft e upscale de vídeo. Gere clipes de 5 a 20 segundos em 720P ou 1080P, com áudio sincronizado opcional, em uma única API pronta para produção.
Este guia da API FLUX 3 cobre os endpoints ativos da WaveSpeedAI, preços, exemplos, fluxo de integração, variantes Draft e workflows de vídeo em produção. O playground, os cards de endpoint, os preços, os exemplos e os códigos de exemplo abaixo usam a família black-forest-labs/flux-3 em produção.
A família FLUX 3 na WaveSpeedAI traz 12 endpoints REST cobrindo os fluxos de Video-To-Video, Upscale-Video, Image-To-Image, Text-To-Image, Video-Extend, Text-To-Video, Image-To-Video. Cada variante tem seu próprio preço, parâmetros e exemplos de resultado — escolha a que combina com sua modalidade de entrada e suas restrições de produção, ou chame várias com a mesma chave de API para montar pipelines de várias etapas.
Execute o FLUX 3 com a mesma chave de API, a mesma conta de cobrança e os mesmos limites de taxa que você usa nos outros mais de 1.000 modelos de IA da WaveSpeedAI. Sem configuração separada por fornecedor, sem SDKs por provedor, sem limites de taxa por fornecedor — uma única integração cobre tudo, de texto para imagem e texto para vídeo até síntese de áudio, geração 3D, ampliação e edição.
Especificações
Recursos e status de lançamento do FLUX 3 API
Os detalhes específicos do modelo que desenvolvedores procuram antes de escolher uma API: disponibilidade, duração esperada do resultado, suporte a referências e a alternativa ativa atual.
Disponibilidade
Disponível agora
Nove endpoints do FLUX 3 estão ativos no catálogo da WaveSpeedAI para geração, extensão, iteração com Draft e upscale de vídeo pelo fluxo padrão de predictions REST.
Duração do vídeo
5 a 20 segundos
Gere clipes de 5 a 20 segundos a partir de texto, de uma imagem de origem ou de imagens inicial e final, ou estenda um vídeo existente com uma nova continuação.
Saída
720P / 1080P
Os endpoints de geração padrão suportam saída em 720P e 1080P com áudio sincronizado opcional. O upscale de vídeo suporta escala configurável de 1,5x a 3x.
Iteração
Endpoints Draft
As variantes Draft de texto para vídeo, imagem para vídeo, quadro inicial e final para vídeo e extensão de vídeo oferecem um caminho de menor custo para iterar em prompt e movimento.
Endpoints
Todos os endpoints da API de FLUX 3
12 endpoints de FLUX 3 disponíveis agora na WaveSpeedAI — escolha a variante que combina com seu fluxo de trabalho.
/filters:quality(82)/media/images/1789113620754515887_hYMV3cmw.webp)
Flux 3 Video Edit
FLUX 3 Video Edit applies prompt-guided changes to existing videos while preserving motion, timing, and framing, supporting precise video modification, visual style updates, scene refinements, creative edits, ads, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1787298940011758698_4IrBKT1b.webp)
Flux 3 Video Upscale
FLUX Video Upscale enhances MP4 videos with source-faithful or creative detail reconstruction, configurable 1.5x to 3x scaling, and improved visual clarity for video restoration, social content, ads, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1790921290885950224_DdmvFOAJ.webp)
Flux 3 Image Edit
FLUX 3 Image Edit transforms and combines up to 10 input images using natural-language instructions, with flexible 1K / 2K / 4K output for multi-image composition, visual refinements, creative edits, marketing assets, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1790921222365478560_RbW6fpyI.webp)
Flux 3 Text To Image
FLUX 3 Text-to-Image generates high-quality images from text prompts with detailed composition, strong typography, and flexible 1K / 2K / 4K output for creative visuals, marketing assets, product imagery, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1786251291501821218_QDkaw5jG.webp)
Flux 3 Video Extend Draft
FLUX 3 Video Extend Draft quickly continues a required input video into a draft clip with prompt-guided next-scene motion, optional synchronized audio, and flexible 5-20 second duration for rapid iteration.
/filters:quality(82)/media/images/1786251321454460317_x5e3clvE.webp)
Flux 3 Text To Video Draft
FLUX 3 Text-to-Video Draft generates short draft videos from text prompts with coherent motion, prompt-guided camera direction, optional synchronized audio, and pricing optimized for rapid iteration.
/filters:quality(82)/media/images/1786251351572590694_qiqJaC8C.webp)
Flux 3 Image To Video Draft
FLUX 3 Image-to-Video Draft quickly animates a required reference image into a draft clip with prompt-guided motion, optional synchronized audio, and flexible 5-20 second duration for rapid visual iteration.
/filters:quality(82)/media/images/1786251386747220978_8aWoJ0iz.webp)
Flux 3 Start End To Video Draft
FLUX 3 Start-End-to-Video Draft quickly generates a transition between required start and end images, with prompt-guided motion, optional synchronized audio, and flexible 5-20 second duration for rapid keyframe iteration.
/filters:quality(82)/media/images/1785952605637015407_SuDLV4DN.webp)
Flux 3 Text To Video
FLUX 3 Text-to-Video generates cinematic 5-20 second videos from text prompts, with coherent motion, cinematic composition, optional synchronized audio, and 720P / 1080P output for creative videos, social content, ads, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1785953660196858181_bUeDcy0o.webp)
Flux 3 Video Extend
FLUX 3 Video Extend continues input videos into new 5-20 second clips, using prompt guidance to control the next action, camera movement, visual style, motion continuity, and optional synchronized audio at 720P / 1080P output. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1785952695147978688_UKcluENW.webp)
Flux 3 Start End To Video
FLUX 3 Start-End-to-Video generates 5-20 second transition videos between required start and end images, using prompt guidance to control action, camera movement, visual style, motion continuity, and optional synchronized audio at 720P / 1080P output. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1785952675883482836_NxW5IR09.webp)
Flux 3 Image To Video
FLUX 3 Image-to-Video animates a required reference image into a 5-20 second video, preserving subject appearance while using prompt control to guide motion, camera movement, visual style, and optional synchronized audio at 720P / 1080P output. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Exemplos
Veja o FLUX 3 em ação
Resultados reais gerados pela API do FLUX 3. Passe o mouse sobre qualquer vídeo para pré-visualizar e clique para abrir o visualizador em tamanho real.
Como usar
Como usar a API do FLUX 3
Quatro passos do cadastro até uma geração concluída. Exemplos completos em Python, Node.js e cURL estão na seção de API abaixo.
- 01
Obtenha uma chave de API
Crie uma conta na WaveSpeedAI e copie sua chave de API no painel. Contas novas recebem créditos iniciais grátis — o suficiente para usar o playground algumas dezenas de vezes antes de a cobrança começar.
- 02
Envie uma predição
Faça POST da sua entrada em JSON para https://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video. O endpoint devolve um id de predição imediatamente — as gerações são assíncronas, então você não mantém uma conexão aberta durante a inferência.
- 03
Consulte até concluir
Faça GET em https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Retorne os resultados quando o status for completed; pare com erro em failed, cancelled, timeout ou deleted; continue consultando em qualquer outro status.
- 04
Leia a URL do resultado
Quando o status for "completed", leia a URL em data.outputs[0]. A URL aponta para a mídia gerada na CDN da WaveSpeedAI — imagem, vídeo, áudio ou arquivo 3D, conforme a variante do FLUX 3 que você chamou.
Casos de uso
O que você pode criar com o FLUX 3
Fluxos de trabalho comuns para os quais desenvolvedores e criadores usam a API do FLUX 3.
Texto para vídeo com áudio sincronizado opcional
Gere clipes cinematográficos de 5 a 20 segundos diretamente a partir de prompts, com controle de ação, direção de câmera e composição, saída em 720P ou 1080P e áudio sincronizado opcional.
Imagem para vídeo com continuidade do sujeito
Anime uma imagem de origem obrigatória e use o prompt para guiar movimento, câmera e estilo visual, sem precisar recriar a composição inicial a partir de texto.
Transições entre quadro inicial e final
Envie as imagens inicial e final obrigatórias para gerar uma transição controlada entre keyframes aprovados, com orientação por prompt para a ação, o caminho da câmera, o estilo e a continuidade do movimento.
Estenda um vídeo existente
Continue um vídeo de entrada em um novo clipe de 5 a 20 segundos. Descreva a próxima ação, o movimento de câmera e a direção visual enquanto o FLUX 3 leva o movimento para a continuação.
Workflow de produção com Draft primeiro
Use um endpoint Draft para testar a direção do prompt, os quadros de origem e o movimento a um custo menor e depois leve a entrada aprovada ao endpoint padrão correspondente para entrega em 720P ou 1080P.
Upscale de vídeo e reconstrução de detalhes
Melhore um MP4 com reconstrução de detalhes fiel à origem ou criativa e escala configurável de 1,5x a 3x, para restauração, entrega em redes sociais e exportações de produção.
Dicas
Dicas de prompt para o FLUX 3
Conselhos práticos para obter melhores resultados com o FLUX 3 — extraídos dos padrões que funcionam em modelos de vídeo em pipelines de produção.
- 01
Escolha o endpoint conforme o material de origem
Use texto para vídeo para um plano só com prompt, imagem para vídeo quando o primeiro quadro está aprovado, start-end-to-video quando os dois quadros de limite estão definidos e video-extend quando o novo clipe precisa continuar uma filmagem existente.
- 02
Prototipe com o Draft antes da renderização final
Há variantes Draft para texto para vídeo, imagem para vídeo, start-end-to-video e extensão de vídeo. Valide primeiro a direção do prompt, os quadros de origem e o movimento e depois leve a entrada aprovada ao endpoint padrão correspondente.
- 03
Descreva o movimento e a direção de câmera separadamente
Diga o que o sujeito faz e depois descreva o movimento de câmera, a escala do plano e o ritmo. Deixar a ação e a cinematografia explícitas dá ao modelo um plano temporal mais claro para um clipe de 5 a 20 segundos.
- 04
Use quadros inicial e final para transições controladas
Quando as composições de abertura e de encerramento já estão aprovadas, envie as duas imagens e concentre o prompt na transição: movimento do sujeito, trajetória da câmera, mudança no ambiente e como o quadro final deve ser alcançado.
- 05
Amplie depois de fixar a direção criativa
Use o video-upscale depois que o timing, o movimento e a composição estiverem aprovados. Escolha a reconstrução fiel à origem quando preservar a entrada for importante, ou a reconstrução criativa de detalhes quando a origem precisar de textura adicional.
Preços
Preços da API de FLUX 3
O preço é por resultado. O valor final varia conforme os parâmetros definidos no playground de cada variante (resolução, duração, quantidade de resultados, referências).
| Endpoint | Tipo | Preço inicial |
|---|---|---|
| black-forest-labs/ | video-to-video | $0.03 |
| black-forest-labs/ | upscale-video | $0.79 |
| black-forest-labs/ | image-to-image | $0.05 |
| black-forest-labs/ | text-to-image | $0.05 |
| black-forest-labs/ | video-extend | $0.12 |
| black-forest-labs/ | text-to-video | $0.06 |
| black-forest-labs/ | image-to-video | $0.06 |
| black-forest-labs/ | image-to-video | $0.06 |
| black-forest-labs/ | text-to-video | $0.17 |
| black-forest-labs/ | video-extend | $0.41 |
| black-forest-labs/ | image-to-video | $0.17 |
| black-forest-labs/ | image-to-video | $0.17 |
API
Chame a API de FLUX 3
Crie uma chave de API em wavespeed.ai/accesskey e envie uma predição via REST. O playground gera exemplos prontos para colar para qualquer combinação de entradas.
POSThttps://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "9:16",
"resolution": "720p",
"duration": 5,
"generate_audio": true
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "9:16",
"resolution": "720p",
"duration": 5,
"generate_audio": true
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "9:16",
"resolution": "720p",
"duration": 5,
"generate_audio": True
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)Comparar
FLUX 3 vs alternativas
Quando escolher o FLUX 3 em vez de modelos semelhantes na WaveSpeedAI.
FLUX 3 vs Seedance 2.5
O FLUX 3 oferece workflows de texto, imagem, quadro inicial e final e extensão de 5 a 20 segundos, além de endpoints Draft e de upscale. O Seedance 2.5 suporta clipes de até 30 segundos, pacotes de referência maiores e edição de vídeo dedicada. Escolha de acordo com o material de origem e o workflow, em vez de tratar as APIs como intercambiáveis.
FLUX 3 vs Veo 3.1
Ambas as famílias suportam vídeo guiado por prompt, com variantes que geram áudio. O FLUX 3 também oferece transições entre quadro inicial e final, iteração com Draft, extensão de vídeo e upscale de vídeo em uma única família de endpoints ativa.
FLUX 3 vs Sora 2
O FLUX 3 oferece endpoints explícitos de texto para vídeo, imagem para vídeo, quadro inicial e final, extensão, Draft e upscale, de 5 a 20 segundos. Compare o formato de origem exigido, a duração e a resolução de entrega antes de escolher uma família.
FAQ
FLUX 3 API — Perguntas frequentes
Preços, licença, integração — perguntas comuns sobre executar o FLUX 3 na WaveSpeedAI.
A API FLUX 3 está disponível na WaveSpeedAI?
Sim. Nove endpoints black-forest-labs/flux-3 estão ativos no catálogo da WaveSpeedAI para texto para vídeo, imagem para vídeo, vídeo de quadro inicial e final, extensão de vídeo, iteração com Draft e upscale de vídeo.
Qual endpoint da API FLUX 3 devo usar?
Use texto para vídeo para um workflow só com prompt, imagem para vídeo para animar uma imagem de origem, quadro inicial e final para vídeo para conectar dois keyframes aprovados, video-extend para continuar um clipe, uma variante Draft para iterar a menor custo ou video-upscale para melhoria de 1,5x a 3x.
Qual duração e resolução o FLUX 3 suporta?
Os endpoints ativos de geração padrão e de extensão suportam clipes de 5 a 20 segundos em 720P ou 1080P, com áudio sincronizado opcional. Os requisitos de entrada variam por endpoint: imagem para vídeo exige uma imagem de origem, start-end-to-video exige os dois quadros e video-extend exige um vídeo de entrada.
Como integro a API FLUX 3?
Use o fluxo padrão de predictions da WaveSpeedAI: autentique-se com sua chave de API, envie com POST a entrada específica do endpoint para um caminho de modelo black-forest-labs/flux-3 e consulte o id da prediction retornado até que a saída esteja pronta. O playground e os exemplos de código desta página mostram o schema de requisição atual.
O que é a API do FLUX 3?
FLUX 3 é um modelo de geração de vídeo da Black Forest Labs disponibilizado como API REST na WaveSpeedAI. A API FLUX 3 da Black Forest Labs já está no ar na WaveSpeedAI, com endpoints de texto para vídeo, imagem para vídeo, vídeo de quadro inicial e final, extensão de vídeo, Draft e upscale de vídeo. Gere clipes de 5 a 20 segundos em 720P ou 1080P, com áudio sincronizado opcional, em uma única API pronta para produção. Você pode chamá-lo por código ou testá-lo no playground indicado acima.
Como chamo a API do FLUX 3?
Crie uma conta na WaveSpeedAI, copie sua chave de API em /accesskey e faça POST para https://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video com sua entrada em JSON. O endpoint devolve um id de predição. Consulte o endpoint de resultado a cada 2 segundos, aproximadamente, aumente o intervalo em tarefas longas e pare em qualquer status final. Exemplos prontos para produção em Python / Node.js / cURL estão acima.
Quanto custa a API do FLUX 3?
O FLUX 3 começa em $0.03 por execução. O custo exato varia conforme os parâmetros definidos (resolução, duração, quantidade de resultados, referências). A prévia de custo ao vivo ao lado do botão Gerar no playground mostra o preço exato da sua entrada atual.
Quais variantes do FLUX 3 estão disponíveis?
A WaveSpeedAI hospeda 12 endpoints de FLUX 3 ativos: black-forest-labs/flux-3/video-edit, black-forest-labs/flux-3/video-upscale, black-forest-labs/flux-3/image-edit, black-forest-labs/flux-3/text-to-image, black-forest-labs/flux-3/video-extend-draft, black-forest-labs/flux-3/text-to-video-draft, black-forest-labs/flux-3/image-to-video-draft, black-forest-labs/flux-3/start-end-to-video-draft, e mais. Cada variante tem sua própria página de playground e seu preço.
Posso usar os resultados do FLUX 3 comercialmente?
Os direitos de uso comercial seguem a licença do modelo da Black Forest Labs. A maioria dos modelos da Black Forest Labs permite o uso comercial dos resultados; veja o resumo da licença na página do playground de cada modelo e os Termos de Serviço da WaveSpeedAI para as condições da plataforma.
Por que usar o FLUX 3 na WaveSpeedAI em vez de ir direto à fonte?
Uma chave de API e uma conta de cobrança para o FLUX 3 E mais de 1.000 outros modelos de IA de outros provedores. Sem configuração de SDK por fornecedor, sem limites de taxa separados, sem reescrever o código de integração a cada fornecedor. Os preços costumam ser iguais ou menores que os da API direta da Black Forest Labs.
Provedor
Sobre a Black Forest Labs
A equipe por trás do FLUX 3 e de toda a linha de modelos da Black Forest Labs na WaveSpeedAI.
A Black Forest Labs criou a família FLUX de modelos de imagem de pesos abertos. O FLUX.2 [klein] traz endpoints de texto para imagem e edição de 4B e 9B, com realismo aprimorado, renderização de texto mais nítida e suporte nativo a LoRA — uma alternativa econômica às variantes maiores do FLUX para pipelines de imagem em alto volume.
Comece a criar com o FLUX 3 na WaveSpeedAI
Créditos iniciais grátis no cadastro. Uma chave de API para mais de 1.000 modelos de IA da Black Forest Labs e de todos os outros provedores.