Introdução
HappyHorse 1.1 Referências para vídeo monta um plano a partir de uma a nove imagens de referência, enviadas em reference_image_urls na ordem em que o prompt as menciona. Ele devolve de 3 a 15 segundos inteiros em 720p ou 1080p, em qualquer uma de nove proporções de tela, com trilha sonora gerada. As referências são apenas imagens; referências de vídeo ou de áudio não são aceitas.
Escolha o modo pelo material inicial
| Material inicial | Modo |
|---|---|
| uma cena escrita ou um roteiro | HappyHorse 1.1 Texto para vídeo |
| uma imagem inicial aprovada | HappyHorse 1.1 Imagem para vídeo |
| de uma a nove imagens de referência | HappyHorse 1.1 Referências para vídeo |
Recursos e destaques
Nove espaços em ordem
Com até nove imagens, uma única requisição consegue fixar um personagem, peças de figurino, um veículo, um local e objetos de cena. O exemplo rider-jacket-bike-station usa três imagens para manter iguais de um take para outro o motociclista, a jaqueta aberta, a moto e o posto de gasolina, em 3:4 e 720p, e o prompt só precisa nomear a ação e a luz.
Rosto, objeto e local em um único take
O exemplo three-plate-corridor dá a cada imagem uma função diferente: a mulher, a guitarra vermelho-cereja que ela carrega e o corredor de motel com neon. O prompt diz qual imagem é qual e depois pede um único take com a câmera recuando, em que rosto, objeto e local precisam se manter juntos.
Nove formatos neste endpoint
aspect_ratio oferece nove valores com 16:9 como padrão, entre eles 1:1, 4:5 e 5:4. O exemplo product-in-place é quadrado em 1080p: um pote de vela tirado de uma imagem colocado sobre uma prateleira de mármore tirada de outra, iluminado de acordo com a luz de janela da prateleira.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Chame cada referência de [Image 1], [Image 2] e assim por diante, na ordem de envio e com os colchetes, diga o que ela contribui e depois descreva o plano que elas devem produzir. pelo menos 1 caracteres · no máximo 2500 caracteres |
reference_image_urls | Sim | Obrigatório, de uma a nove imagens na ordem em que o prompt as nomeia. Uma função por imagem. pelo menos 1 itens · no máximo 9 itens |
aspect_ratio | Não | Nove valores, padrão 16:9. Existe aqui, mas não no image-to-video. |
resolution | Não | 720p ou 1080p. |
duration_seconds | Não | Segundos inteiros, de 3 a 15. |
seed | Não | Inteiro de 0 a 2147483647 para o ponto de partida aleatório; omita e cada execução sorteia o seu. |
Preços
| Especificação | Preço |
|---|---|
| $0.14 / segundo |
| $0.18 / segundo |
Casos de uso
Um produto no seu ambiente
Envie o produto e o local como imagens separadas e descreva como eles interagem. Em product-in-place, a câmera se aproxima devagar enquanto o pavio acende e sobe um fio de fumaça, e o brilho quente da chama acrescenta uma segunda luz sobre o mármore e o linho.
Mesmo elenco e figurino ao longo de uma série
Use o mesmo conjunto de referências em cada plano para que a pessoa, o figurino e o veículo não mudem de um take para outro, e altere só a linha de ação do prompt. Envie as imagens sempre na mesma ordem, para que as referências por posição continuem apontando para a imagem certa.
Trabalho de personagem sem censura ou estilizado
Assim como o image-to-video, este caminho segue as imagens que recebe. Um trabalho de personagem sem censura que o text-to-video recusaria pode começar de um conjunto de referências em que elenco, figurino e local ficam fixados, cada um, pela própria imagem.
Guia de prompt e dicas práticas
Chame as imagens pela posição
Diga o que cada imagem traz antes de descrever o plano. Os exemplos publicados usam dois estilos por posição: "Use the woman from the first image exactly as she appears" e "Place the candle jar from [Image 1] into the empty centre of the marble shelf in [Image 2]". Faça o upload dos arquivos na mesma ordem em que o prompt os nomeia.
Uma função por imagem
Nove espaços são um teto, não uma meta. Várias vistas do mesmo assunto são tiradas na média em vez de conciliadas, então dê a cada imagem uma função distinta, como identidade, peça de roupa, objeto ou local. Cada imagem precisa de um lado menor de pelo menos 400 px e tamanho de até 20 MB.
Use o prompt para ação e luz
Depois que as referências resolvem a identidade, o prompt diz o que o assunto faz, não como ele é: "he swings a leg over the tank and settles, the overhead light pressing down from directly above, moths in the beam". Mantenha as instruções de luz coerentes com a imagem do local, como faz product-in-place ao seguir a direção e a temperatura de cor da luz da prateleira.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/happyhorse-1.1/reference-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://example.com/reference.png"
],
"resolution": "720p"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.







