HappyHorse 1.1 API

HappyHorse 1.1 Riferimenti in video costruisce un’inquadratura da una a nove immagini di riferimento, inviate in reference_image_urls nell’ordine in cui il prompt le cita. Restituisce da 3 a 15 secondi interi a 720p o 1080p in uno qualsiasi dei nove formati, con una colonna sonora generata. I riferimenti sono solo immagini; riferimenti video o audio non sono accettati.

Scegli il metodo in base al materiale di partenza

Nove slot ordinati

Con un massimo di nove immagini, una sola richiesta può fissare un personaggio, pezzi di costume, un veicolo, un luogo e oggetti di scena. L’esempio rider-jacket-bike-station usa tre immagini per mantenere uguali da una ripresa all’altra il motociclista, la giacca aperta, la moto e la stazione di servizio, in 3:4 a 720p, così il prompt deve solo nominare azione e luce.

Volto, oggetto e luogo in una sola ripresa

L’esempio three-plate-corridor dà a ogni immagine un compito diverso: la donna, la chitarra rosso ciliegia che porta e il corridoio di motel al neon. Il prompt dice quale immagine è quale e poi chiede un’unica ripresa con la camera che arretra, in cui volto, oggetto e luogo devono reggere insieme.

Nove formati anche su questo endpoint

aspect_ratio offre nove valori con 16:9 come predefinito, tra cui 1:1, 4:5 e 5:4. L’esempio product-in-place è quadrato a 1080p: un barattolo di candela preso da un’immagine posato su una mensola di marmo presa da un’altra, illuminato in accordo con la luce di finestra della mensola.

Un prodotto nel suo ambiente

Invia prodotto e luogo come immagini separate e descrivi come interagiscono. In product-in-place la camera avanza piano mentre lo stoppino si accende e sale un filo di fumo, e il bagliore caldo della fiamma aggiunge una seconda luce sul marmo e sul lino.

Stesso cast e stessi costumi in tutta una serie

Riusa lo stesso set di riferimenti per ogni inquadratura, così interprete, costume e veicolo restano uguali da una ripresa all’altra, e cambia solo la riga d’azione del prompt. Invia le immagini sempre nello stesso ordine, perché i rimandi per posizione continuino a indicare l’immagine giusta.

Lavoro sui personaggi senza censura o stilizzato

Come image-to-video, questa strada segue le immagini che riceve. Un lavoro sui personaggi senza censura che text-to-video rifiuterebbe può quindi partire da un set di riferimenti in cui cast, costume e luogo sono fissati ciascuno dalla propria immagine.

# 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"

Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.