Usa la API de RunComfy para ejecutar kling/kling-3.0/pro/text-to-video. Para entradas y salidas admitidas, consulta el esquema.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/kling/kling-3.0/pro/text-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "Cinematic multi-shot of a young American couple celebrating their anniversary at a candlelit terrace dinner in Tuscany at golden hour. Wide establishing shot sweeps over rolling vineyard hills, cypress trees casting long shadows, then cuts to a slow dolly-in on a stone terrace where a woman in an ivory linen dress laughs softly while the man in a navy rolled-sleeve shirt pours red wine. Cut to a tender close-up: their hands interlace across the table, candlelight catching her diamond ring, his thumb gently brushing hers. Cut to a profile two-shot as he leans in and whispers; she smiles, eyes glistening, golden light rim-lighting her loose blonde hair. Final shot: a graceful crane pull-back revealing the terrace, the warm villa, and the sun melting into the Tuscan horizon. Distant church bells, light cricket ambience, soft acoustic guitar. Photoreal skin, fabric texture, wine ripples — shot on Arri Alexa 35, anamorphic lenses, shallow depth of field, premium cinematic color grade."
}'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/kling/kling-3.0/pro/text-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "Cinematic multi-shot of a young American couple celebrating their anniversary at a candlelit terrace dinner in Tuscany at golden hour. Wide establishing shot sweeps over rolling vineyard hills, cypress trees casting long shadows, then cuts to a slow dolly-in on a stone terrace where a woman in an ivory linen dress laughs softly while the man in a navy rolled-sleeve shirt pours red wine. Cut to a tender close-up: their hands interlace across the table, candlelight catching her diamond ring, his thumb gently brushing hers. Cut to a profile two-shot as he leans in and whispers; she smiles, eyes glistening, golden light rim-lighting her loose blonde hair. Final shot: a graceful crane pull-back revealing the terrace, the warm villa, and the sun melting into the Tuscan horizon. Distant church bells, light cricket ambience, soft acoustic guitar. Photoreal skin, fabric texture, wine ripples — shot on Arri Alexa 35, anamorphic lenses, shallow depth of field, premium cinematic color grade."
}'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": "Descripción textual de la escena, movimiento, estilo de cámara y atmósfera.",
"type": "string",
"default": "Cinematic multi-shot of a young American couple celebrating their anniversary at a candlelit terrace dinner in Tuscany at golden hour. Wide establishing shot sweeps over rolling vineyard hills, cypress trees casting long shadows, then cuts to a slow dolly-in on a stone terrace where a woman in an ivory linen dress laughs softly while the man in a navy rolled-sleeve shirt pours red wine. Cut to a tender close-up: their hands interlace across the table, candlelight catching her diamond ring, his thumb gently brushing hers. Cut to a profile two-shot as he leans in and whispers; she smiles, eyes glistening, golden light rim-lighting her loose blonde hair. Final shot: a graceful crane pull-back revealing the terrace, the warm villa, and the sun melting into the Tuscan horizon. Distant church bells, light cricket ambience, soft acoustic guitar. Photoreal skin, fabric texture, wine ripples — shot on Arri Alexa 35, anamorphic lenses, shallow depth of field, premium cinematic color grade."
},
"negative_prompt": {
"title": "Aviso negativo",
"description": "Elementos a excluir del vídeo.",
"type": "string"
},
"duration": {
"title": "Duración",
"description": "Duración del vídeo en segundos.",
"type": "integer",
"minimum": 3,
"maximum": 15,
"default": 5
},
"aspect_ratio": {
"title": "Relación de aspecto",
"description": "Relación de salida del vídeo generado.",
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
],
"default": "16:9"
},
"cfg_scale": {
"title": "Escala CFG",
"description": "Fuerza de orientación rápida.",
"type": "float",
"minimum": 0,
"maximum": 1,
"default": 0.5
},
"sound": {
"title": "Sonido",
"description": "Genera sonido sincronizado junto al vídeo.",
"type": "boolean",
"default": true
},
"multi_prompt": {
"title": "Mensaje múltiple",
"description": "Segmentos de indicaciones adicionales para guiar las transiciones y progresiones de escenas. La suma de las duraciones en multi_prompt debe ser igual a la duración total del video.",
"type": "array",
"items": {
"prompt": {
"title": "Prompt",
"description": "Segmentos de indicaciones adicionales para guiar las transiciones y progresiones de escenas.",
"type": "string",
"format": "str"
},
"duration": {
"title": "Duración",
"description": "Duración del segmento de aviso en segundos.",
"type": "integer",
"format": "int_slider_with_range",
"minimum": 3,
"maximum": 15,
"default": 5
}
},
"maxItems": 20,
"minItems": 0
},
"shot_type": {
"title": "Tipo de disparo",
"description": "Modo de edición: inteligente (predeterminado, determina automáticamente el alcance) o personalizar.",
"type": "string",
"enum": [
"customize"
],
"default": "customize"
}
}
}{
"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.