FLUX 3 API
La API de FLUX 3 de Black Forest Labs ya está disponible en WaveSpeedAI con endpoints de texto a vídeo, imagen a vídeo, vídeo con fotograma inicial y final, extensión de vídeo, Draft y escalado de vídeo. Genera clips de 5 a 20 segundos en 720P o 1080P, con audio sincronizado opcional, a través de una única API lista para producción.
Esta guía de la API de FLUX 3 recoge los endpoints activos de WaveSpeedAI, los precios, ejemplos, el flujo de integración, las variantes Draft y los flujos de trabajo de vídeo en producción. El playground, las tarjetas de endpoints, los precios, los ejemplos y las muestras de API de más abajo usan la familia black-forest-labs/flux-3 en vivo.
Resumen
Acerca de FLUX 3 API
Qué hace FLUX 3, cómo encaja en la gama de modelos de Black Forest Labs y por qué los equipos lo eligen.
FLUX 3 es un modelo de generación de vídeo de Black Forest Labs, disponible a través de la API REST de WaveSpeedAI. La API de FLUX 3 de Black Forest Labs ya está disponible en WaveSpeedAI con endpoints de texto a vídeo, imagen a vídeo, vídeo con fotograma inicial y final, extensión de vídeo, Draft y escalado de vídeo. Genera clips de 5 a 20 segundos en 720P o 1080P, con audio sincronizado opcional, a través de una única API lista para producción.
Esta guía de la API de FLUX 3 recoge los endpoints activos de WaveSpeedAI, los precios, ejemplos, el flujo de integración, las variantes Draft y los flujos de trabajo de vídeo en producción. El playground, las tarjetas de endpoints, los precios, los ejemplos y las muestras de API de más abajo usan la familia black-forest-labs/flux-3 en vivo.
La familia FLUX 3 en WaveSpeedAI incluye 12 endpoints REST que cubren los flujos de trabajo de Video-To-Video, Upscale-Video, Image-To-Image, Text-To-Image, Video-Extend, Text-To-Video, Image-To-Video. Cada variante tiene su propio precio, parámetros y ejemplos de resultados: elige la que se ajuste a tu modalidad de entrada y a tus requisitos de producción, o llama a varias con la misma clave de API para componer flujos de varios pasos.
Ejecuta FLUX 3 con la misma clave de API, la misma cuenta de facturación y los mismos límites de uso que ya usas para los demás más de 1.000 modelos de IA de WaveSpeedAI. Sin configuración aparte por proveedor, sin SDK por proveedor, sin límites de uso distintos por proveedor: una sola integración lo cubre todo, desde texto a imagen y texto a vídeo hasta síntesis de audio, generación 3D, escalado y edición.
Especificaciones
Capacidades y estado de lanzamiento de FLUX 3 API
Los detalles específicos del modelo que los desarrolladores buscan antes de elegir una API: disponibilidad, duración esperada del resultado, compatibilidad con referencias y la alternativa en producción actual.
Disponibilidad
Disponible ahora
Nueve endpoints de FLUX 3 están activos en el catálogo de WaveSpeedAI para generación, extensión, iteración con Draft y escalado de vídeo mediante el flujo estándar de predicciones REST.
Duración del vídeo
5-20 segundos
Genera clips de 5 a 20 segundos a partir de texto, de una imagen de origen o de imágenes inicial y final, o amplía un vídeo existente con una nueva continuación.
Salida
720P / 1080P
Los endpoints de generación estándar admiten salida en 720P y 1080P con audio sincronizado opcional. El escalado de vídeo admite un factor configurable de 1,5x a 3x.
Iteración
Endpoints Draft
Las variantes Draft de texto a vídeo, imagen a vídeo, inicio-fin a vídeo y extensión de vídeo ofrecen una vía de menor coste para iterar sobre el prompt y el movimiento.
Endpoints
Todos los endpoints de la API de FLUX 3
12 endpoints de FLUX 3 disponibles ahora en WaveSpeedAI: elige la variante que se ajuste a tu flujo de trabajo.
/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.
Ejemplos
Mira FLUX 3 en acción
Resultados reales generados con la API de FLUX 3. Pasa el cursor sobre cualquier vídeo para previsualizarlo y haz clic para abrir el visor a tamaño completo.
Cómo empezar
Cómo usar la API de FLUX 3
Cuatro pasos desde el registro hasta una generación terminada. Encontrarás ejemplos completos en Python, Node.js y cURL en la sección de API más abajo.
- 01
Obtén una clave de API
Regístrate en WaveSpeedAI y copia tu clave de API desde el panel. Las cuentas nuevas incluyen créditos gratuitos para empezar: suficientes para usar el playground unas decenas de veces antes de que empiece la facturación.
- 02
Envía una predicción
Haz POST de tu entrada como JSON a https://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video. El endpoint devuelve un id de predicción de inmediato: las generaciones son asíncronas, así que no mantienes una conexión abierta durante la inferencia.
- 03
Consulta hasta que termine
Haz GET a https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Devuelve los resultados con completed; detente con un error en failed, cancelled, timeout o deleted; sigue consultando con cualquier otro estado.
- 04
Lee la URL del resultado
Cuando status sea "completed", lee la URL de data.outputs[0]. La URL apunta a tu contenido generado en la CDN de WaveSpeedAI: imagen, vídeo, audio o archivo 3D según la variante de FLUX 3 que hayas llamado.
Casos de uso
Qué puedes crear con FLUX 3
Flujos de trabajo habituales para los que desarrolladores y creadores usan la API de FLUX 3.
Texto a vídeo con audio sincronizado opcional
Genera clips cinematográficos de 5 a 20 segundos directamente desde prompts, con control de la acción, la dirección de cámara y la composición, salida en 720P o 1080P y audio sincronizado opcional.
Imagen a vídeo con continuidad del sujeto
Anima una imagen de origen obligatoria y usa el prompt para guiar el movimiento, los movimientos de cámara y el estilo visual, sin tener que reconstruir la composición inicial a partir de texto.
Transiciones entre fotograma inicial y final
Aporta una imagen inicial y otra final obligatorias para generar una transición controlada entre fotogramas clave aprobados, con indicaciones en el prompt sobre la acción, la trayectoria de cámara, el estilo y la continuidad del movimiento.
Ampliar un vídeo existente
Continúa un vídeo de entrada con un nuevo clip de 5 a 20 segundos. Describe la siguiente acción, el movimiento de cámara y la dirección visual, mientras FLUX 3 traslada el movimiento a la continuación.
Flujo de producción que empieza con Draft
Usa un endpoint Draft para probar la dirección del prompt, los fotogramas de origen y el movimiento a menor coste; después pasa la entrada aprobada al endpoint estándar correspondiente para entregar en 720P o 1080P.
Escalado de vídeo y reconstrucción de detalle
Mejora un MP4 con reconstrucción de detalle fiel al original o creativa y un escalado configurable de 1,5x a 3x, para restauración, entrega en redes sociales y exportaciones de producción.
Consejos
Consejos para escribir prompts en FLUX 3
Consejos prácticos para obtener mejores resultados con FLUX 3, basados en los patrones que funcionan en modelos de vídeo en flujos de producción.
- 01
Elige el endpoint según el material de origen
Usa texto a vídeo para un plano que parte solo de un prompt, imagen a vídeo cuando el primer fotograma está aprobado, start-end-to-video cuando los dos fotogramas extremos están fijados y video-extend cuando el nuevo clip debe continuar metraje existente.
- 02
Prototipa con Draft antes del renderizado de entrega
Hay variantes Draft para texto a vídeo, imagen a vídeo, start-end-to-video y extensión de vídeo. Valida primero la dirección del prompt, los fotogramas de origen y el movimiento, y después pasa la entrada aprobada al endpoint estándar correspondiente.
- 03
Describe por separado el movimiento y la dirección de cámara
Indica qué hace el sujeto y después describe el movimiento de cámara, la escala del plano y el ritmo. Mantener explícitas la acción y la cinematografía da al modelo un plan temporal más claro para un clip de 5 a 20 segundos.
- 04
Usa fotogramas inicial y final para transiciones controladas
Cuando las composiciones de apertura y de cierre ya están aprobadas, aporta ambas imágenes y centra el prompt en la transición: el movimiento del sujeto, la trayectoria de cámara, el cambio del entorno y cómo debe alcanzarse el fotograma final.
- 05
Escala una vez fijada la dirección creativa
Usa video-upscale cuando el ritmo, el movimiento y la composición estén aprobados. Elige la reconstrucción fiel al original cuando importe conservar la entrada, o la reconstrucción creativa de detalle cuando el origen necesite textura adicional.
Precios
Precios de la API de FLUX 3
El precio es por resultado. El cargo final depende de los parámetros que definas en el playground de cada variante (resolución, duración, número de resultados, referencias).
| Endpoint | Tipo | Precio 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
Llama a la API de FLUX 3
Obtén una clave de API en wavespeed.ai/accesskey y envía una predicción por REST. El playground genera ejemplos listos para pegar con cualquier combinación 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 frente a las alternativas
Cuándo elegir FLUX 3 en lugar de modelos similares en WaveSpeedAI.
FLUX 3 frente a Seedance 2.5
FLUX 3 ofrece flujos de texto, imagen, fotograma inicial y final y extensión de 5 a 20 segundos, además de endpoints Draft y de escalado. Seedance 2.5 admite clips de hasta 30 segundos, paquetes de referencias más grandes y edición de vídeo específica. Elige según el material de origen y el flujo de trabajo, no como si las API fueran intercambiables.
FLUX 3 frente a Veo 3.1
Ambas familias admiten vídeo guiado por prompts con variantes que incluyen audio. FLUX 3 además ofrece transiciones entre fotograma inicial y final, iteración con Draft, extensión de vídeo y escalado de vídeo dentro de una misma familia de endpoints en vivo.
FLUX 3 frente a Sora 2
FLUX 3 ofrece endpoints explícitos de texto a vídeo, imagen a vídeo, fotograma inicial y final, extensión, Draft y escalado, todos de 5 a 20 segundos. Compara el formato de origen requerido, la duración y la resolución de entrega antes de elegir una familia.
Preguntas frecuentes
FLUX 3 API — Preguntas frecuentes
Precios, licencia, integración: preguntas habituales sobre cómo ejecutar FLUX 3 en WaveSpeedAI.
¿Está disponible la API de FLUX 3 en WaveSpeedAI?
Sí. Nueve endpoints de black-forest-labs/flux-3 están activos en el catálogo de WaveSpeedAI para texto a vídeo, imagen a vídeo, vídeo con fotograma inicial y final, extensión de vídeo, iteración con Draft y escalado de vídeo.
¿Qué endpoint de la API de FLUX 3 debo usar?
Usa texto a vídeo si trabajas solo con un prompt, imagen a vídeo para animar una imagen de origen, start-end-to-video para unir dos fotogramas clave aprobados, video-extend para continuar un clip, una variante Draft para iterar a menor coste o video-upscale para mejorar el vídeo con un escalado de 1,5x a 3x.
¿Qué duración y resolución admite FLUX 3?
Los endpoints estándar de generación y extensión activos admiten clips de 5 a 20 segundos en 720P o 1080P, con audio sincronizado opcional. Los requisitos de entrada varían según el endpoint: imagen a vídeo requiere una imagen de origen, start-end-to-video requiere los dos fotogramas (inicial y final) y video-extend requiere un vídeo de entrada.
¿Cómo integro la API de FLUX 3?
Usa el flujo estándar de predicciones de WaveSpeedAI: autentícate con tu clave de API, envía con POST la entrada específica del endpoint a una ruta de modelo black-forest-labs/flux-3 y consulta el id de predicción devuelto hasta que el resultado esté listo. El playground y los ejemplos de código de esta página muestran el esquema de solicitud vigente.
¿Qué es la API de FLUX 3?
FLUX 3 es un modelo de generación de vídeo de Black Forest Labs expuesto como API REST en WaveSpeedAI. La API de FLUX 3 de Black Forest Labs ya está disponible en WaveSpeedAI con endpoints de texto a vídeo, imagen a vídeo, vídeo con fotograma inicial y final, extensión de vídeo, Draft y escalado de vídeo. Genera clips de 5 a 20 segundos en 720P o 1080P, con audio sincronizado opcional, a través de una única API lista para producción. Puedes llamarlo por programación o probarlo desde el playground enlazado arriba.
¿Cómo llamo a la API de FLUX 3?
Regístrate en WaveSpeedAI, copia tu clave de API desde /accesskey y haz POST a https://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video con tu entrada como JSON. El endpoint devuelve un id de predicción. Consulta el endpoint de resultados aproximadamente cada 2 segundos, aumenta el intervalo en las tareas largas y detente ante cualquier estado final. Arriba tienes ejemplos en Python / Node.js / cURL orientados a producción.
¿Cuánto cuesta la API de FLUX 3?
FLUX 3 empieza en $0.03 por ejecución. El coste exacto depende de los parámetros que definas (resolución, duración, número de resultados, referencias). La vista previa del coste en tiempo real junto al botón Generar del playground muestra el precio exacto de tu entrada actual.
¿Qué variantes de FLUX 3 hay disponibles?
WaveSpeedAI aloja 12 endpoints de FLUX 3 en producción: 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 y más. Cada variante tiene su propia página de playground y sus propios precios.
¿Puedo usar comercialmente los resultados de FLUX 3?
Los derechos de uso comercial dependen de la licencia del modelo de Black Forest Labs. La mayoría de los modelos de Black Forest Labs permiten el uso comercial de los resultados; consulta la página del playground de cada modelo para ver el resumen de su licencia y los Términos del servicio de WaveSpeedAI para las condiciones de la plataforma.
¿Por qué usar FLUX 3 en WaveSpeedAI en lugar de ir directamente al proveedor?
Una sola clave de API y una sola cuenta de facturación para FLUX 3 Y más de 1.000 modelos de IA de otros proveedores. Sin configurar un SDK por proveedor, sin límites de uso aparte y sin reescribir el código de integración para cada proveedor. Los precios suelen ser iguales o inferiores a los de la API directa de Black Forest Labs.
Proveedor
Acerca de Black Forest Labs
El equipo detrás de FLUX 3 y de la gama más amplia de modelos de Black Forest Labs en WaveSpeedAI.
Black Forest Labs creó la familia FLUX de modelos de imagen de pesos abiertos. FLUX.2 [klein] ofrece endpoints de texto a imagen y edición de 4B y 9B con mayor realismo, renderizado de texto más nítido y compatibilidad nativa con LoRA: una alternativa rentable a las variantes FLUX más grandes para pipelines de imagen de alto volumen.
Empieza a crear con FLUX 3 en WaveSpeedAI
Créditos gratuitos al registrarte. Una sola clave de API para más de 1.000 modelos de IA de Black Forest Labs y de todos los demás proveedores.