Video e musica

# Conserva il Request ID: l'assistenza lo usa per trovare la tua richiesta.
# Crea il job una sola volta; il ciclo sottostante ne legge soltanto lo stato.
curl --fail-with-body --max-time 120 -D video-create-headers-v1.txt \
  https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-imagine-video-1.5","prompt":"un lago tranquillo","seconds":"8","size":"1280x720"}' \
  -o video-create-v1.json || exit 1
VIDEO_ID=$(jq -er '.id // .request_id' video-create-v1.json) || exit 1
VIDEO_STATUS=""
# Questo ciclo legge soltanto il job originale. Non reinvia mai la richiesta di creazione.
for ATTEMPT in $(seq 1 60); do
  curl --fail-with-body --max-time 30 \
    "https://api.ailoot.ai/v1/videos/$VIDEO_ID" \
    -H "Authorization: Bearer $AILOOT_API_KEY" \
    -o video-status-v1.json || exit 1
  VIDEO_STATUS=$(jq -r '.status // empty' video-status-v1.json)
  # result_pending_check: true (lo stato rimane in_progress): il risultato è in fase di verifica. Fermati; non creare mai di nuovo il job.
  if jq -e '.result_pending_check == true' video-status-v1.json >/dev/null; then
    cat video-status-v1.json
    echo "The result is being checked. Do not create the job again: check GET /v1/videos/$VIDEO_ID later or contact support with the Request ID." >&2
    exit 1
  fi
  case "$VIDEO_STATUS" in
    done|completed) break ;;
    queued|in_progress|pending|processing) sleep 5 ;;
    # failed o qualsiasi altro stato: mostralo e fermati. Non creare mai di nuovo il job.
    *) cat video-status-v1.json; exit 1 ;;
  esac
done
case "$VIDEO_STATUS" in
  done|completed) ;;
  *) echo "The job is not finished yet (status: ${VIDEO_STATUS:-none}). Check it later: GET /v1/videos/$VIDEO_ID" >&2; exit 1 ;;
esac
curl --fail-with-body --max-time 120 -L --max-redirs 3 \
  "https://api.ailoot.ai/v1/videos/$VIDEO_ID/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o video-v1.mp4
# Dopo un timeout durante la creazione, verifica il Request ID nella cronologia di utilizzo prima di eseguire di nuovo questo script.

curl https://api.ailoot.ai/v1/music/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "google/lyria", "prompt": "Pianoforte e violoncello tranquilli, senza voce"}' 

// L'identificatore del job si trova nel campo id o request_id
{ "id": "…", … }

// Il formato dipende dal modello: usa l'identificatore
// della risposta di creazione senza modificarlo.

Autorizzazione

• Authorizationheaderobbligatorio

  Chiave nel formato Bearer sk-…. Sono accettati anche gli header x-api-key oppure x-goog-api-key.

Video: corpo della richiesta

• modelstringobbligatorio

  Modello video: google/omni-1.1-flash, grok-imagine-video, happyhorse-1.1-t2v, MiniMax-Hailuo-2.3, grok-imagine-video-1.5, happyhorse-1.1-r2v, grok-imagine-video-1.5-preview, happyhorse-1.1-i2v.

• promptstringobbligatorio

  Descrizione del video.

• duration / secondsinteger / stringfacoltativo

  Dipende dalla famiglia: Grok 1–15 secondi, MiniMax 6/10 a 768P o 6 a 1080P, HappyHorse 3–15; Google Omni 4/6/8/10. Non trasferire il campo di una famiglia a un’altra.

• resolution / sizestringfacoltativo

  Grok: 480p/720p/1080p (1080p per video-1.5), oppure size 1280x720/720x1280/1920x1080/1080x1920. MiniMax: 768P/1080P. HappyHorse: 480P/720P/1080P. Google Omni: 360p/720p.

• image / first_frame_image / image_urlsstring / arrayfacoltativo

  I campi delle immagini iniziali dipendono dalla famiglia e dalla modalità. MiniMax Fast richiede first_frame_image. HappyHorse t2v — senza images, i2v — esattamente un’immagine senza ratio, r2v — 1–9 immagini.

La risposta contiene l’identificatore dell’attività (campo id oppure request_id). Usalo così com’è, senza interpretarlo: il formato dipende dal modello. Stato e file pronto:

Gli stessi indirizzi funzionano anche con il prefisso /v1/videos/generations/{id}. Lo stato di un’attività pronta e i campi della risposta dipendono dal modello — fai riferimento al campo di stato e recupera il file tramite /content.

Creazione → stato → download

Salva la risposta di creazione e il suo Request ID. Per MiniMax/HappyHorse lo stato di completamento è status: completed, la risposta contiene content_url, data[] e usage. Per Grok — status: done con video.url. Google Omni restituisce 202 queued, poi in_progress con Retry-After, completed oppure partial/content_revoked. Non considerare ogni 200 come un video pronto. Se nella risposta di stato compare result_pending_check: true (status rimane in_progress), il risultato è in fase di chiarimento. Non creare di nuovo l’attività — controllala più tardi tramite GET /v1/videos/{id} oppure contatta l’assistenza con il Request ID.

/content può restituire direttamente MP4 oppure un redirect a un file firmato. Se la risposta contiene più risultati in data[], salvali tutti: tutti i risultati consegnati vengono addebitati. Non è possibile annullare o eliminare un’attività video tramite API. Eliminare il file pronto ne chiude l’accesso, ma non annulla la generazione.

Il pagamento è calcolato sui secondi del video pronto nella risoluzione scelta o per video, come indicato nel catalogo. L’intero costo viene riservato alla creazione dell’attività.

Musica

• modelstringobbligatorio

  google/lyria, google/lyria-3-clip-preview.

• promptstringobbligatorio

  Descrizione del brano: genere, strumenti e atmosfera.

Nella risposta data[] — link alle clip pronte. Il modello può restituire più clip per richiesta; ogni clip consegnata viene addebitata.