Usa la API de RunComfy para ejecutar blackforestlabs/flux-3-max/text-to-video. Para entradas y salidas admitidas, consulta el esquema.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-3-max/text-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "A young man with tousled light brown hair and a charcoal overcoat speaks from the stone steps of a red-brick courthouse in a New England town in autumn. Only the crowd's hands show at the bottom of the frame. No signs, no captions, no readable flags. He lifts one hand as fallen leaves cross the steps. A clear speaking voice and distant traffic."
}'Define la variable de entorno YOUR_API_TOKEN con tu clave API (gestión en Perfil) e incluye en cada solicitud un token Bearer en la cabecera Authorization : Authorization: Bearer $YOUR_API_TOKEN.
Envía un trabajo de generación asíncrono y recibe de inmediato un request_id y URLs para consultar estado, obtener resultados y cancelar.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-3-max/text-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "A young man with tousled light brown hair and a charcoal overcoat speaks from the stone steps of a red-brick courthouse in a New England town in autumn. Only the crowd's hands show at the bottom of the frame. No signs, no captions, no readable flags. He lifts one hand as fallen leaves cross the steps. A clear speaking voice and distant traffic."
}'Obtiene el estado actual de un request_id ("in_queue", "in_progress", "completed" o "cancelled").
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
--header "Authorization: Bearer <token>"Obtiene las salidas finales y metadatos del request_id; si el trabajo no ha terminado, la respuesta devuelve el estado actual para seguir haciendo polling.
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
--header "Authorization: Bearer <token>"Cancela un trabajo en cola por request_id; los trabajos en curso no se pueden cancelar.
curl --request POST \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
--header "Authorization: Bearer <token>"Proporciona una URL HTTPS públicamente accesible. El host debe permitir peticiones del servidor (sin login/cookies), sin rate limit agresivo ni bloqueo de bots. Recomendado: imágenes ≤ 50 MB (~4K), vídeos ≤ 100 MB (~2–5 min a 720p). Para activos privados, URLs estables o firmadas.
{
"type": "object",
"title": "Esquema de entrada",
"required": [
"prompt"
],
"properties": {
"prompt": {
"title": "Prompt",
"description": "Describe el sujeto, la acción, la cámara, la luz y cualquier sonido que desees.",
"type": "string",
"default": "A young man with tousled light brown hair and a charcoal overcoat speaks from the stone steps of a red-brick courthouse in a New England town in autumn. Only the crowd's hands show at the bottom of the frame. No signs, no captions, no readable flags. He lifts one hand as fallen leaves cross the steps. A clear speaking voice and distant traffic."
},
"aspect_ratio": {
"title": "Relación de aspecto",
"description": "Forma del marco de salida. auto usa 16:9 cuando no se adjunta ninguna imagen.",
"type": "string",
"enum": [
"auto",
"21:9",
"2:1",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
],
"default": "16:9"
},
"resolution": {
"title": "Resolución",
"description": "Resolución de salida. 720p es la predeterminada. 1080p es la opción más nítida.",
"type": "string",
"enum": [
"720p",
"1080p"
],
"default": "720p"
},
"duration": {
"title": "Duración",
"description": "Duración del clip en segundos completos.",
"type": "integer",
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20
],
"default": 5
},
"generate_audio": {
"title": "Generar audio",
"description": "Crea una pista de audio con el video. Desactívala para un clip silencioso.",
"type": "boolean",
"default": true
},
"reasoning_level": {
"title": "Nivel de razonamiento",
"description": "low regresa antes. high pasa más tiempo en la indicación y es más lento.",
"type": "string",
"enum": [
"low",
"high"
],
"default": "high"
},
"seed": {
"title": "Seed",
"description": "Opcional. Déjelo vacío y el modelo elegirá una semilla aleatoria.",
"type": "integer"
}
}
}{
"output": {
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "uri",
"description": "URL de una sola imagen"
},
"video": {
"type": "string",
"format": "uri",
"description": "URL de un solo vídeo"
},
"images": {
"type": "array",
"description": "varias URLs de imagen",
"items": {
"type": "string",
"format": "uri"
}
},
"videos": {
"type": "array",
"description": "varias URLs de vídeo",
"items": {
"type": "string",
"format": "uri"
}
}
}
}
}RunComfy es la principal ComfyUI plataforma, ofreciendo ComfyUI en línea entorno y servicios, junto con flujos de trabajo de ComfyUI con impresionantes imágenes. RunComfy también ofrece AI Models, permitiendo a los artistas aprovechar las últimas herramientas de AI para crear arte increíble.