[Image 1], [Image 2], e assim por diante no seu prompt, e então rastreie a tarefa assíncrona pelo img_uuid.API de Referência HappyHorse 1.1
Gere vídeos guiados por referência através da API independente da GoEnhance. Envie de 1 a 9 URLs de imagens públicas, faça referência a elas como
Obter Chave de API
Crie uma solicitação de referência para vídeo
Guie o movimento com 1 a 9 imagens de referência
Faça um POST para https://api.goenhance.ai/api/v1/videos/generations com model: happyhorse-1-1-ref. O array obrigatório image_urls aceita de 1 a 9 URLs de imagens públicas.
Controle a composição e a conclusão
Defina o prompt, a proporção, a duração e a resolução, e então persista o img_uuid retornado. Consulte GET /api/v1/jobs/detail ou receba callbacks de mudança de status em uma URL HTTPS pública.
Valide cada campo antes de enviar uma tarefa de geração.
Capacidades da API de Referência HappyHorse 1.1
Modo de entrada apenas por referência
Esta rota requer <code>image_urls</code> e não suporta geração de texto para vídeo puro.
1 a 9 imagens de referência
Forneça entre uma e nove URLs de imagens públicas na ordem usada pelo seu prompt.
Referências de prompt indexadas
Refira-se às entradas explicitamente como <code>[Image 1]</code>, <code>[Image 2]</code>, e assim por diante.
Sete proporções de tela
Escolha 16:9, 9:16, 3:4, 4:3, 4:5, 5:4 ou 1:1. O padrão é 16:9.
Duração de 3 a 15 segundos
Defina uma duração inteira de 3 a 15 segundos. O padrão documentado é 5 segundos.
720p ou 1080p
Selecione a saída em 720p ou 1080p. O padrão documentado é 720p.
O preço é por segundo gerado na conversão documentada de $0.02 por token.
Preço da API de referência HappyHorse 1.1
Preços para 720p
5,2 tokens por segundo gerado, equivalente a $0.104 por segundo.
Preços para 1080p
7,2 tokens por segundo gerado, equivalente a $0.144 por segundo.
Estime cada solicitação
Multiplique a taxa por segundo selecionada pela duração. Por exemplo, 5 segundos em 720p consomem 26 tokens.
Integre a API HappyHorse em seis etapas
1
1. Crie uma chave de API
Crie uma chave GoEnhance e envie-a como um token bearer no cabeçalho de Autorização.
2
2. Hospede imagens de referência
Forneça de 1 a 9 URLs de imagem acessíveis publicamente na ordem de matriz necessária.
3
3. Escreva um prompt indexado
Descreva o movimento e os relacionamentos enquanto nomeia cada entrada como
[Image N]. 4
4. Valide as configurações de saída
Escolha uma proporção suportada, uma duração de 3 a 15 segundos e resolução de 720p ou 1080p.
5
5. Envie e persista o ID
Faça um POST da tarefa e salve o
img_uuid retornado antes de processar os eventos de conclusão. 6
6. Faça polling ou receba callbacks
Faça polling no endpoint de detalhes do trabalho ou gerencie alterações de status em uma URL de callback HTTPS pública.
Crie fluxos de trabalho de vídeo repetíveis em torno de entradas visuais aprovadas.
Casos de uso da API de referência HappyHorse
Continuidade de personagem
Use referências de personagem aprovadas para orientar a identidade e o estilo em uma cena gerada.
Storytelling de produto
Combine referências de produto, cenário e clima em um conceito de vídeo direcionado por prompt.
Variantes de campanha
Parametrize conjuntos de referência e prompts para variações criativas enquanto mantém um único manipulador de tarefas.
Desenvolvimento de storyboard
Transforme quadros visuais e referências de direção de arte em conceitos de movimento curtos para revisão.
Criativo localizado
Troque referências regionais aprovadas enquanto preserva seu fluxo de trabalho de validação e conclusão.
Previsualização
Explore interações entre vários assuntos referenciados antes de se comprometer com a produção completa.
Respostas para perguntas comuns sobre entrada, preços e integração assíncrona.