Use a API RunComfy para executar kling/kling-3.0/pro/image-to-video. Para entradas e saídas aceitas, consulte o esquema.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/kling/kling-3.0/pro/image-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "Bring this still photograph to life with premium cinematic motion. The young American couple ride their two chestnut quarter horses side-by-side across the golden Montana plains at sunset — hooves rhythmically stepping forward, kicking up soft golden dust, horse manes and tails flowing in the prairie wind. The man in the cowboy hat and denim shirt glances over and laughs warmly; the woman in the cream cable-knit sweater laughs back, her wavy auburn hair whipping in the breeze. Tall amber prairie grass sways across the foreground in slow waves, distant Rocky Mountain silhouettes shimmer in heat haze, wispy pink-orange clouds drift slowly across the sky, a few birds wheel overhead. The camera follows in a smooth lateral tracking shot, parallax revealing the vastness of the open plains, then gently pushes in to a tighter two-shot of their faces. Natural ambient sound: rhythmic hoofbeats on dirt trail, leather creaking, wind through tall grass, distant meadowlark calls, and a soft acoustic country guitar score. Photoreal motion realism — every horse muscle flexing, hair strand moving, dust particle drifting, fabric folding — golden-hour rim lighting, lens flare, shot on Arri Alexa 35, 85mm anamorphic, shallow depth of field, premium cinematic color grade, Yellowstone-style.",
"start_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7351/media-files/input.png"
}'Defina a variável de ambiente YOUR_API_TOKEN com sua chave de API (gerenciamento no Perfil) e inclua em cada solicitação um token Bearer no cabeçalho Authorization : Authorization: Bearer $YOUR_API_TOKEN.
Envie um trabalho de geração assíncrono e receba imediatamente um request_id e URLs para status, resultados e cancelamento.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/kling/kling-3.0/pro/image-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "Bring this still photograph to life with premium cinematic motion. The young American couple ride their two chestnut quarter horses side-by-side across the golden Montana plains at sunset — hooves rhythmically stepping forward, kicking up soft golden dust, horse manes and tails flowing in the prairie wind. The man in the cowboy hat and denim shirt glances over and laughs warmly; the woman in the cream cable-knit sweater laughs back, her wavy auburn hair whipping in the breeze. Tall amber prairie grass sways across the foreground in slow waves, distant Rocky Mountain silhouettes shimmer in heat haze, wispy pink-orange clouds drift slowly across the sky, a few birds wheel overhead. The camera follows in a smooth lateral tracking shot, parallax revealing the vastness of the open plains, then gently pushes in to a tighter two-shot of their faces. Natural ambient sound: rhythmic hoofbeats on dirt trail, leather creaking, wind through tall grass, distant meadowlark calls, and a soft acoustic country guitar score. Photoreal motion realism — every horse muscle flexing, hair strand moving, dust particle drifting, fabric folding — golden-hour rim lighting, lens flare, shot on Arri Alexa 35, 85mm anamorphic, shallow depth of field, premium cinematic color grade, Yellowstone-style.",
"start_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7351/media-files/input.png"
}'Obtém o estado atual de um request_id ("in_queue", "in_progress", "completed" ou "cancelled").
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
--header "Authorization: Bearer <token>"Obtém as saídas finais e metadados do request_id; se o trabalho não estiver concluído, a resposta retorna o estado atual para continuar o polling.
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
--header "Authorization: Bearer <token>"Cancela um trabalho na fila por request_id; trabalhos em andamento não podem ser cancelados.
curl --request POST \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
--header "Authorization: Bearer <token>"Forneça uma URL HTTPS publicamente acessível. O host deve permitir buscas no servidor (sem login/cookies), sem limite de taxa agressivo ou bloqueio de bots. Recomendado: imagens ≤ 50 MB (~4K), vídeos ≤ 100 MB (~2–5 min em 720p). Para ativos privados, URLs estáveis ou pré-assinadas.
{
"type": "object",
"title": "Esquema de entrada",
"required": [
"prompt",
"start_image_url"
],
"properties": {
"prompt": {
"title": "Prompt",
"description": "",
"type": "string",
"default": "Bring this still photograph to life with premium cinematic motion. The young American couple ride their two chestnut quarter horses side-by-side across the golden Montana plains at sunset — hooves rhythmically stepping forward, kicking up soft golden dust, horse manes and tails flowing in the prairie wind. The man in the cowboy hat and denim shirt glances over and laughs warmly; the woman in the cream cable-knit sweater laughs back, her wavy auburn hair whipping in the breeze. Tall amber prairie grass sways across the foreground in slow waves, distant Rocky Mountain silhouettes shimmer in heat haze, wispy pink-orange clouds drift slowly across the sky, a few birds wheel overhead. The camera follows in a smooth lateral tracking shot, parallax revealing the vastness of the open plains, then gently pushes in to a tighter two-shot of their faces. Natural ambient sound: rhythmic hoofbeats on dirt trail, leather creaking, wind through tall grass, distant meadowlark calls, and a soft acoustic country guitar score. Photoreal motion realism — every horse muscle flexing, hair strand moving, dust particle drifting, fabric folding — golden-hour rim lighting, lens flare, shot on Arri Alexa 35, 85mm anamorphic, shallow depth of field, premium cinematic color grade, Yellowstone-style."
},
"multi_prompt": {
"title": "Segmentos de múltiplos prompts",
"description": "Fornece vários segmentos de prompt para transições de cena. A soma de todas as durações dos segmentos deve ser igual à duração total do vídeo.",
"type": "array",
"items": {
"type": "object",
"properties": {
"prompt": {
"type": "string",
"format": "str"
},
"duration": {
"type": "integer",
"format": "int_slider_with_range",
"minimum": 3,
"maximum": 15,
"default": 5
}
}
},
"maxItems": 20,
"minItems": 0
},
"start_image_url": {
"title": "Imagem inicial",
"description": "Imagem inicial do vídeo. Suporta os formatos jpg, jpeg, png, bmp, webp.",
"type": "string",
"default": "https://playgrounds-storage-public.runcomfy.net/tools/7351/media-files/input.png"
},
"end_image_url": {
"title": "Imagem final",
"description": "Imagem final opcional para transições controladas entre dois quadros. Suporta formatos jpg, jpeg, png, bmp, webp.",
"type": "string"
},
"duration": {
"title": "Duração",
"description": "Duração total do vídeo gerado em segundos.",
"type": "integer",
"minimum": 3,
"maximum": 15,
"default": 10
},
"generate_audio": {
"title": "Gerar áudio",
"description": "Habilite esta opção para gerar áudio para o vídeo.",
"type": "boolean",
"default": true
},
"elements": {
"title": "Elementos",
"description": "Ativos de entrada usados para geração, incluindo imagens de referência e segmentos de vídeo.",
"type": "array",
"items": {
"type": "object",
"properties": {
"frontal_image_url": {
"type": "string",
"format": "image_uri",
"description": "Referência de imagem frontal para o sujeito."
},
"reference_image_urls": {
"type": "array",
"format": "image_uris",
"items": {
"type": "string",
"format": "image_uri"
},
"description": "URLs de imagem de referência adicionais usados para orientar a renderização."
},
"video_url": {
"type": "string",
"format": "video_uri",
"description": "Fonte de vídeo opcional usada para referência de movimento."
}
}
},
"minItems": 0,
"maxItems": 3
},
"shot_type": {
"title": "Tipo de plano",
"description": "Define como a tomada da câmera ou o enquadramento da cena são tratados.",
"type": "string",
"enum": [
"customize"
],
"default": "customize"
},
"negative_prompt": {
"title": "Prompt negativo",
"description": "",
"type": "string"
},
"cfg_scale": {
"title": "Escala de orientação",
"description": "Escala de orientação sem classificador que controla a adesão ao prompt.",
"type": "float",
"minimum": 0,
"maximum": 1,
"default": 0.5
}
}
}{
"output": {
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "uri",
"description": "URL de imagem única"
},
"video": {
"type": "string",
"format": "uri",
"description": "URL de vídeo único"
},
"images": {
"type": "array",
"description": "várias URLs de imagem",
"items": {
"type": "string",
"format": "uri"
}
},
"videos": {
"type": "array",
"description": "várias URLs de vídeo",
"items": {
"type": "string",
"format": "uri"
}
}
}
}
}RunComfy é a principal ComfyUI plataforma, oferecendo ComfyUI online ambiente e serviços, juntamente com fluxos de trabalho do ComfyUI apresentando visuais impressionantes. RunComfy também oferece AI Models, permitindo que artistas utilizem as mais recentes ferramentas de AI para criar arte incrível.