Use a API RunComfy para executar alibaba/happyhorse-1.1/reference-to-video. Para entradas e saídas aceitas, consulte o esquema.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/alibaba/happyhorse-1.1/reference-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7373/media-files/ref-promo.webp",
"prompt": "The referenced woman walks slowly through a sunlit modern art gallery, tall windows casting soft golden light across white walls, her trench coat moving gently with each step, calm confident expression, faint ambient murmur and distant footsteps. Cinematic slow dolly-in, shallow depth of field, premium photoreal look, identity-stable face and outfit."
}'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/alibaba/happyhorse-1.1/reference-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7373/media-files/ref-promo.webp",
"prompt": "The referenced woman walks slowly through a sunlit modern art gallery, tall windows casting soft golden light across white walls, her trench coat moving gently with each step, calm confident expression, faint ambient murmur and distant footsteps. Cinematic slow dolly-in, shallow depth of field, premium photoreal look, identity-stable face and outfit."
}'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": [
"image_url_1",
"prompt"
],
"properties": {
"prompt": {
"title": "Prompt",
"description": "Descreva a cena, a ação, o movimento de câmera e a atmosfera que deseja criar a partir das imagens de referência. Até 5000 caracteres não chineses ou 2500 caracteres chineses; o conteúdo excedente é cortado.",
"type": "string",
"default": "The referenced woman walks slowly through a sunlit modern art gallery, tall windows casting soft golden light across white walls, her trench coat moving gently with each step, calm confident expression, faint ambient murmur and distant footsteps. Cinematic slow dolly-in, shallow depth of field, premium photoreal look, identity-stable face and outfit.",
"maxLength": 5000
},
"ratio": {
"title": "Proporção",
"description": "Proporção de tela do vídeo gerado.",
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
],
"default": "16:9"
},
"duration": {
"title": "Duração",
"description": "Duração do vídeo de saída, em segundos. Valores permitidos: 3 a 15.",
"type": "integer",
"enum": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
],
"default": 5
},
"image_url_1": {
"title": "Imagem de referência 1",
"description": "Imagem de referência principal usada para orientar o elemento principal, o estilo ou a composição do vídeo. Formatos: JPEG, JPG, PNG ou WEBP.",
"type": "string",
"default": "https://playgrounds-storage-public.runcomfy.net/tools/7373/media-files/ref-promo.webp"
},
"image_url_2": {
"title": "Imagem de referência 2",
"description": "Imagem de referência adicional opcional. Formatos: JPEG, JPG, PNG ou WEBP.",
"type": "string",
"default": ""
},
"image_url_3": {
"title": "Imagem de referência 3",
"description": "Imagem de referência adicional opcional. Formatos: JPEG, JPG, PNG ou WEBP.",
"type": "string",
"default": ""
},
"image_url_4": {
"title": "Imagem de referência 4",
"description": "Imagem de referência adicional opcional. Formatos: JPEG, JPG, PNG ou WEBP.",
"type": "string",
"default": ""
},
"image_url_5": {
"title": "Imagem de referência 5",
"description": "Imagem de referência adicional opcional. Formatos: JPEG, JPG, PNG ou WEBP.",
"type": "string",
"default": ""
},
"image_url_6": {
"title": "Imagem de referência 6",
"description": "Imagem de referência adicional opcional. Formatos: JPEG, JPG, PNG ou WEBP.",
"type": "string",
"default": ""
},
"image_url_7": {
"title": "Imagem de referência 7",
"description": "Imagem de referência adicional opcional. Formatos: JPEG, JPG, PNG ou WEBP.",
"type": "string",
"default": ""
},
"image_url_8": {
"title": "Imagem de referência 8",
"description": "Imagem de referência adicional opcional. Formatos: JPEG, JPG, PNG ou WEBP.",
"type": "string",
"default": ""
},
"image_url_9": {
"title": "Imagem de referência 9",
"description": "Imagem de referência adicional opcional. É possível combinar até 9 imagens de referência. Formatos: JPEG, JPG, PNG ou WEBP.",
"type": "string",
"default": ""
},
"resolution": {
"title": "Resolução",
"description": "Resolução do vídeo de saída. Happy Horse 1.1 reference to video aceita 720P ou 1080P.",
"type": "string",
"enum": [
"720P",
"1080P"
],
"default": "1080P"
},
"seed": {
"title": "Seed",
"description": "Seed opcional para reproduzir resultados. Use 0 para que o provedor escolha um valor aleatório.",
"type": "integer",
"minimum": 0,
"maximum": 2147483647,
"default": 0
},
"watermark": {
"title": "Marca-d’água",
"description": "Define se a marca-d’água do provedor será mantida no vídeo gerado.",
"type": "boolean",
"default": false
}
}
}{
"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.