HappyHorse-1.1-I2V è un modello di Alibaba che avvia una scena video da un'immagine già pronta. L'immagine diventa il primo fotogramma, mentre il testo può definire ciò che avviene dopo: il movimento del personaggio, i cambiamenti nella scena e la direzione della videocamera. È adatto ad animare un'illustrazione, una fotografia di prodotto o un concept visivo preparato in precedenza.
La descrizione testuale è facoltativa. Se manca, il modello deduce un possibile movimento dal contenuto dell'immagine iniziale. Quando viene fornita, l'immagine di partenza definisce la composizione e l'aspetto degli oggetti, mentre le parole guidano lo sviluppo della scena nel tempo.
Alibaba mette in evidenza la conservazione dell'aspetto dei personaggi, la coerenza visiva, la fluidità del movimento e la combinazione di immagini e audio. Tra gli obiettivi dichiarati figurano anche la stabilità delle scritte e delle texture. Queste proprietà riguardano la progettazione del modello e non implicano la conservazione letterale di ogni pixel in tutti i fotogrammi generati.
Questa modalità utilizza una sola immagine iniziale. L'immagine definisce la scena di partenza, anziché fungere da insieme di riferimenti indipendenti per una nuova composizione. Per questa specifica versione non è dichiarata la possibilità di impostare un fotogramma finale separato.
Sono accettati JPEG, JPG, PNG e WEBP. Ogni lato dell'immagine in ingresso deve essere di almeno 300 pixel; le proporzioni ammesse vanno da 1:2,5 a 2,5:1 e la dimensione del file può arrivare a 20 MB. Le proporzioni del video finale seguono quelle del primo fotogramma.
La durata si imposta con un numero intero da 3 a 15 secondi. Sono disponibili le risoluzioni 480P, 720P e 1080P; il formato di uscita è MP4, con una frequenza di 24 fotogrammi al secondo. È supportata la generazione di audio insieme al video.
La descrizione può essere in qualsiasi lingua e contenere fino a 5000 caratteri non cinesi oppure 2500 caratteri cinesi. Se il limite viene superato, la parte in eccesso viene scartata: conviene quindi descrivere le azioni importanti e le caratteristiche del movimento entro questo spazio. Lo stesso seme casuale iniziale può produrre video simili, ma non ne garantisce la corrispondenza fotogramma per fotogramma.
", "aboutText": "HappyHorse-1.1-I2V è un modello di Alibaba che avvia una scena video da un'immagine già pronta. L'immagine diventa il primo fotogramma, mentre il testo può definire ciò che avviene dopo: il movimento del personaggio, i cambiamenti nella scena e la direzione della videocamera. È adatto ad animare un'illustrazione, una fotografia di prodotto o un concept visivo preparato in precedenza.\n\nLa descrizione testuale è facoltativa. Se manca, il modello deduce un possibile movimento dal contenuto dell'immagine iniziale. Quando viene fornita, l'immagine di partenza definisce la composizione e l'aspetto degli oggetti, mentre le parole guidano lo sviluppo della scena nel tempo.\n\n### Dal primo fotogramma al movimento\n\nAlibaba mette in evidenza la conservazione dell'aspetto dei personaggi, la coerenza visiva, la fluidità del movimento e la combinazione di immagini e audio. Tra gli obiettivi dichiarati figurano anche la stabilità delle scritte e delle texture. Queste proprietà riguardano la progettazione del modello e non implicano la conservazione letterale di ogni pixel in tutti i fotogrammi generati.\n\nQuesta modalità utilizza una sola immagine iniziale. L'immagine definisce la scena di partenza, anziché fungere da insieme di riferimenti indipendenti per una nuova composizione. Per questa specifica versione non è dichiarata la possibilità di impostare un fotogramma finale separato.\n\nSono accettati JPEG, JPG, PNG e WEBP. Ogni lato dell'immagine in ingresso deve essere di almeno 300 pixel; le proporzioni ammesse vanno da 1:2,5 a 2,5:1 e la dimensione del file può arrivare a 20 MB. Le proporzioni del video finale seguono quelle del primo fotogramma.\n\n### Parametri del video\n\nLa durata si imposta con un numero intero da 3 a 15 secondi. Sono disponibili le risoluzioni 480P, 720P e 1080P; il formato di uscita è MP4, con una frequenza di 24 fotogrammi al secondo. È supportata la generazione di audio insieme al video.\n\nLa descrizione può essere in qualsiasi lingua e contenere fino a 5000 caratteri non cinesi oppure 2500 caratteri cinesi. Se il limite viene superato, la parte in eccesso viene scartata: conviene quindi descrivere le azioni importanti e le caratteristiche del movimento entro questo spazio. Lo stesso seme casuale iniziale può produrre video simili, ma non ne garantisce la corrispondenza fotogramma per fotogramma.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "d212f186bf8ff3b6c370f19ad8dd4b5772cfa084e8a48b37678fe5cad8540c5b", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "it", "methods": [ { "html": "happyhorse-1.1-i2vModello per animare un'immagine: l'immagine iniziale definisce il primo fotogramma, mentre la descrizione guida il movimento successivo. Crea un breve video con la possibilità di generare anche l'audio.
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
HappyHorse-1.1-I2V è un modello di Alibaba che avvia una scena video da un'immagine già pronta. L'immagine diventa il primo fotogramma, mentre il testo può definire ciò che avviene dopo: il movimento del personaggio, i cambiamenti nella scena e la direzione della videocamera. È adatto ad animare un'illustrazione, una fotografia di prodotto o un concept visivo preparato in precedenza.
La descrizione testuale è facoltativa. Se manca, il modello deduce un possibile movimento dal contenuto dell'immagine iniziale. Quando viene fornita, l'immagine di partenza definisce la composizione e l'aspetto degli oggetti, mentre le parole guidano lo sviluppo della scena nel tempo.
Alibaba mette in evidenza la conservazione dell'aspetto dei personaggi, la coerenza visiva, la fluidità del movimento e la combinazione di immagini e audio. Tra gli obiettivi dichiarati figurano anche la stabilità delle scritte e delle texture. Queste proprietà riguardano la progettazione del modello e non implicano la conservazione letterale di ogni pixel in tutti i fotogrammi generati.
Questa modalità utilizza una sola immagine iniziale. L'immagine definisce la scena di partenza, anziché fungere da insieme di riferimenti indipendenti per una nuova composizione. Per questa specifica versione non è dichiarata la possibilità di impostare un fotogramma finale separato.
Sono accettati JPEG, JPG, PNG e WEBP. Ogni lato dell'immagine in ingresso deve essere di almeno 300 pixel; le proporzioni ammesse vanno da 1:2,5 a 2,5:1 e la dimensione del file può arrivare a 20 MB. Le proporzioni del video finale seguono quelle del primo fotogramma.
La durata si imposta con un numero intero da 3 a 15 secondi. Sono disponibili le risoluzioni 480P, 720P e 1080P; il formato di uscita è MP4, con una frequenza di 24 fotogrammi al secondo. È supportata la generazione di audio insieme al video.
La descrizione può essere in qualsiasi lingua e contenere fino a 5000 caratteri non cinesi oppure 2500 caratteri cinesi. Se il limite viene superato, la parte in eccesso viene scartata: conviene quindi descrivere le azioni importanti e le caratteristiche del movimento entro questo spazio. Lo stesso seme casuale iniziale può produrre video simili, ma non ne garantisce la corrispondenza fotogramma per fotogramma.
POST /v1/videos/generationstext, imagevideo| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti happyhorse-1.1-i2v | Predefinito— |
Campoprompt | Tipostring | RequisitoFacoltativo | Valori e limiti Lunghezza minima: 1 | Predefinito— |
Campoduration | Tipointeger | RequisitoFacoltativo | Valori e limiti Minimo: 3 Massimo: 15 Unità: secondi | Predefinito5 |
Camporesolution | Tipostring | RequisitoFacoltativo | Valori e limiti 480P, 720P, 1080P | Predefinito720P |
Camporatio | Tipostring | RequisitoNon supportato | Valori e limiti | Predefinito— |
Campoimage_urls | Tipohttps_url|data_image_url[] | RequisitoObbligatorio | Valori e limiti Numero minimo di elementi: 1 Numero massimo di elementi: 1 Numero massimo di byte decodificati: 20.971.520 Tipi MIME: image/jpeg, image/png, image/webp | Predefinito— |
first_frame_to_video · Obbligatorio: image_urls
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, image_urls |
Parametromaterial_types | Contrattotext, image |
Parametrooptional | Contrattoduration, resolution, ratio, prompt |
Parametroduration_integer_range | Contratto3, 15 |
Parametrodefault_duration | Contratto5 |
Parametroresolution | Contratto480P, 720P, 1080P |
Parametrodefault_resolution | Contratto720P |
Parametroratio | Contratto |
Parametroratio_must_omit | Contrattotrue |
Parametroimage_urls | Contratto{"min_count":1,"max_count":1,"schemes":["https","dati raster in base64"],"max_data_image_bytes":20971520} |
Ciclo di vita: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Le strutture dei metodi e gli ID sono esatti; la capacità del fornitore è distinta dall’ammissione delle richieste.
POST /v1/videos/generationsAiloot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-1.1-i2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nSalva ogni video completato o file restituito; recupera ogni URL di risorsa effettivamente restituito.
Conserva ogni elemento di dati e indice di uscita restituito. content_url indica solo il primo; recupera ogni percorso del contenuto o risorsa effettiva. GET del contenuto senza index non restituisce tutti i risultati.
Consulta l'attività originale esistente; non ripetere mai un invio dall'esito sconosciuto.
| Campo | Tipo |
|---|---|
Campoid | Tipostring |
Campoobject | Tipostring |
Campomodel | Tipostring |
Campostatus | Tipostring |
Campocontent_url | Tiposigned URL |
Campodata[] | Tiposigned URL |
Campousage | Tipoobject |
Camporesult_pending_check | Tipoboolean |
| Risposta | Condizione | Passaggio successivo |
|---|---|---|
Risposta400 · invalid_request_error | CondizioneCampi obbligatori, rappresentazione del materiale o valore del parametro non validi | Passaggio successivoCorreggi i campi indicati prima di una nuova richiesta di creazione. |
Risposta409 · video_not_ready | CondizioneContenuto del risultato originale non ancora disponibile | Passaggio successivoInterroga periodicamente l'ID originale restituito e rispetta Retry-After. |
Rispostaserver_error | CondizioneLa risposta restituita indica che l'operazione o il risultato richiede una verifica | Passaggio successivoConserva l'ID originale di operazione/task restituito, gli header della richiesta e la risposta; continua a leggere l'operazione originale tramite le modalità supportate. Non reinviare la richiesta di creazione. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
Usa i percorsi dei metodi indicati sopra.
happyhorse-i2vModello per animare un'immagine: l'immagine iniziale definisce il primo fotogramma, mentre la descrizione guida il movimento successivo. Crea un breve video con la possibilità di generare anche l'audio.
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
HappyHorse-1.1-I2V è un modello di Alibaba che avvia una scena video da un'immagine già pronta. L'immagine diventa il primo fotogramma, mentre il testo può definire ciò che avviene dopo: il movimento del personaggio, i cambiamenti nella scena e la direzione della videocamera. È adatto ad animare un'illustrazione, una fotografia di prodotto o un concept visivo preparato in precedenza.
La descrizione testuale è facoltativa. Se manca, il modello deduce un possibile movimento dal contenuto dell'immagine iniziale. Quando viene fornita, l'immagine di partenza definisce la composizione e l'aspetto degli oggetti, mentre le parole guidano lo sviluppo della scena nel tempo.
Alibaba mette in evidenza la conservazione dell'aspetto dei personaggi, la coerenza visiva, la fluidità del movimento e la combinazione di immagini e audio. Tra gli obiettivi dichiarati figurano anche la stabilità delle scritte e delle texture. Queste proprietà riguardano la progettazione del modello e non implicano la conservazione letterale di ogni pixel in tutti i fotogrammi generati.
Questa modalità utilizza una sola immagine iniziale. L'immagine definisce la scena di partenza, anziché fungere da insieme di riferimenti indipendenti per una nuova composizione. Per questa specifica versione non è dichiarata la possibilità di impostare un fotogramma finale separato.
Sono accettati JPEG, JPG, PNG e WEBP. Ogni lato dell'immagine in ingresso deve essere di almeno 300 pixel; le proporzioni ammesse vanno da 1:2,5 a 2,5:1 e la dimensione del file può arrivare a 20 MB. Le proporzioni del video finale seguono quelle del primo fotogramma.
La durata si imposta con un numero intero da 3 a 15 secondi. Sono disponibili le risoluzioni 480P, 720P e 1080P; il formato di uscita è MP4, con una frequenza di 24 fotogrammi al secondo. È supportata la generazione di audio insieme al video.
La descrizione può essere in qualsiasi lingua e contenere fino a 5000 caratteri non cinesi oppure 2500 caratteri cinesi. Se il limite viene superato, la parte in eccesso viene scartata: conviene quindi descrivere le azioni importanti e le caratteristiche del movimento entro questo spazio. Lo stesso seme casuale iniziale può produrre video simili, ma non ne garantisce la corrispondenza fotogramma per fotogramma.
POST /v1/videos/generationstext, imagevideo| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti happyhorse-i2v | Predefinito— |
Campoprompt | Tipostring | RequisitoFacoltativo | Valori e limiti Lunghezza minima: 1 | Predefinito— |
Campoduration | Tipointeger | RequisitoFacoltativo | Valori e limiti Minimo: 3 Massimo: 15 Unità: secondi | Predefinito5 |
Camporesolution | Tipostring | RequisitoFacoltativo | Valori e limiti 480P, 720P, 1080P | Predefinito720P |
Camporatio | Tipostring | RequisitoNon supportato | Valori e limiti | Predefinito— |
Campoimage_urls | Tipohttps_url|data_image_url[] | RequisitoObbligatorio | Valori e limiti Numero minimo di elementi: 1 Numero massimo di elementi: 1 Numero massimo di byte decodificati: 20.971.520 Tipi MIME: image/jpeg, image/png, image/webp | Predefinito— |
first_frame_to_video · Obbligatorio: image_urls
| Parametro | Contratto |
|---|---|
Parametromaterial_types | Contrattotext, image |
Parametrorequired | Contrattonull |
Parametrooptional_controls | Contrattonull |
Ciclo di vita: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Le strutture dei metodi e gli ID sono esatti; la capacità del fornitore è distinta dall’ammissione delle richieste.
POST /v1/videos/generationsAiloot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-i2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nSalva ogni video completato o file restituito; recupera ogni URL di risorsa effettivamente restituito.
Conserva ogni elemento di dati e indice di uscita restituito. content_url indica solo il primo; recupera ogni percorso del contenuto o risorsa effettiva. GET del contenuto senza index non restituisce tutti i risultati.
Consulta l'attività originale esistente; non ripetere mai un invio dall'esito sconosciuto.
| Campo | Tipo |
|---|---|
Campoid | Tipostring |
Campoobject | Tipostring |
Campomodel | Tipostring |
Campostatus | Tipostring |
Campocontent_url | Tiposigned URL |
Campodata[] | Tiposigned URL |
Campousage | Tipoobject |
Camporesult_pending_check | Tipoboolean |
| Risposta | Condizione | Passaggio successivo |
|---|---|---|
Risposta400 · invalid_request_error | CondizioneCampi obbligatori, rappresentazione del materiale o valore del parametro non validi | Passaggio successivoCorreggi i campi indicati prima di una nuova richiesta di creazione. |
Risposta409 · video_not_ready | CondizioneContenuto del risultato originale non ancora disponibile | Passaggio successivoInterroga periodicamente l'ID originale restituito e rispetta Retry-After. |
Rispostaserver_error | CondizioneLa risposta restituita indica che l'operazione o il risultato richiede una verifica | Passaggio successivoConserva l'ID originale di operazione/task restituito, gli header della richiesta e la risposta; continua a leggere l'operazione originale tramite le modalità supportate. Non reinviare la richiesta di creazione. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
Usa i percorsi dei metodi indicati sopra.
happyhorse-i2v-latestModello per animare un'immagine: l'immagine iniziale definisce il primo fotogramma, mentre la descrizione guida il movimento successivo. Crea un breve video con la possibilità di generare anche l'audio.
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
HappyHorse-1.1-I2V è un modello di Alibaba che avvia una scena video da un'immagine già pronta. L'immagine diventa il primo fotogramma, mentre il testo può definire ciò che avviene dopo: il movimento del personaggio, i cambiamenti nella scena e la direzione della videocamera. È adatto ad animare un'illustrazione, una fotografia di prodotto o un concept visivo preparato in precedenza.
La descrizione testuale è facoltativa. Se manca, il modello deduce un possibile movimento dal contenuto dell'immagine iniziale. Quando viene fornita, l'immagine di partenza definisce la composizione e l'aspetto degli oggetti, mentre le parole guidano lo sviluppo della scena nel tempo.
Alibaba mette in evidenza la conservazione dell'aspetto dei personaggi, la coerenza visiva, la fluidità del movimento e la combinazione di immagini e audio. Tra gli obiettivi dichiarati figurano anche la stabilità delle scritte e delle texture. Queste proprietà riguardano la progettazione del modello e non implicano la conservazione letterale di ogni pixel in tutti i fotogrammi generati.
Questa modalità utilizza una sola immagine iniziale. L'immagine definisce la scena di partenza, anziché fungere da insieme di riferimenti indipendenti per una nuova composizione. Per questa specifica versione non è dichiarata la possibilità di impostare un fotogramma finale separato.
Sono accettati JPEG, JPG, PNG e WEBP. Ogni lato dell'immagine in ingresso deve essere di almeno 300 pixel; le proporzioni ammesse vanno da 1:2,5 a 2,5:1 e la dimensione del file può arrivare a 20 MB. Le proporzioni del video finale seguono quelle del primo fotogramma.
La durata si imposta con un numero intero da 3 a 15 secondi. Sono disponibili le risoluzioni 480P, 720P e 1080P; il formato di uscita è MP4, con una frequenza di 24 fotogrammi al secondo. È supportata la generazione di audio insieme al video.
La descrizione può essere in qualsiasi lingua e contenere fino a 5000 caratteri non cinesi oppure 2500 caratteri cinesi. Se il limite viene superato, la parte in eccesso viene scartata: conviene quindi descrivere le azioni importanti e le caratteristiche del movimento entro questo spazio. Lo stesso seme casuale iniziale può produrre video simili, ma non ne garantisce la corrispondenza fotogramma per fotogramma.
POST /v1/videos/generationstext, imagevideo| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti happyhorse-i2v-latest | Predefinito— |
Campoprompt | Tipostring | RequisitoFacoltativo | Valori e limiti Lunghezza minima: 1 | Predefinito— |
Campoduration | Tipointeger | RequisitoFacoltativo | Valori e limiti Minimo: 3 Massimo: 15 Unità: secondi | Predefinito5 |
Camporesolution | Tipostring | RequisitoFacoltativo | Valori e limiti 480P, 720P, 1080P | Predefinito720P |
Camporatio | Tipostring | RequisitoNon supportato | Valori e limiti | Predefinito— |
Campoimage_urls | Tipohttps_url|data_image_url[] | RequisitoObbligatorio | Valori e limiti Numero minimo di elementi: 1 Numero massimo di elementi: 1 Numero massimo di byte decodificati: 20.971.520 Tipi MIME: image/jpeg, image/png, image/webp | Predefinito— |
first_frame_to_video · Obbligatorio: image_urls
| Parametro | Contratto |
|---|---|
Parametromaterial_types | Contrattotext, image |
Parametrorequired | Contrattonull |
Parametrooptional_controls | Contrattonull |
Ciclo di vita: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Le strutture dei metodi e gli ID sono esatti; la capacità del fornitore è distinta dall’ammissione delle richieste.
POST /v1/videos/generationsAiloot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-i2v-latest", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nSalva ogni video completato o file restituito; recupera ogni URL di risorsa effettivamente restituito.
Conserva ogni elemento di dati e indice di uscita restituito. content_url indica solo il primo; recupera ogni percorso del contenuto o risorsa effettiva. GET del contenuto senza index non restituisce tutti i risultati.
Consulta l'attività originale esistente; non ripetere mai un invio dall'esito sconosciuto.
| Campo | Tipo |
|---|---|
Campoid | Tipostring |
Campoobject | Tipostring |
Campomodel | Tipostring |
Campostatus | Tipostring |
Campocontent_url | Tiposigned URL |
Campodata[] | Tiposigned URL |
Campousage | Tipoobject |
Camporesult_pending_check | Tipoboolean |
| Risposta | Condizione | Passaggio successivo |
|---|---|---|
Risposta400 · invalid_request_error | CondizioneCampi obbligatori, rappresentazione del materiale o valore del parametro non validi | Passaggio successivoCorreggi i campi indicati prima di una nuova richiesta di creazione. |
Risposta409 · video_not_ready | CondizioneContenuto del risultato originale non ancora disponibile | Passaggio successivoInterroga periodicamente l'ID originale restituito e rispetta Retry-After. |
Rispostaserver_error | CondizioneLa risposta restituita indica che l'operazione o il risultato richiede una verifica | Passaggio successivoConserva l'ID originale di operazione/task restituito, gli header della richiesta e la risposta; continua a leggere l'operazione originale tramite le modalità supportate. Non reinviare la richiesta di creazione. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
Usa i percorsi dei metodi indicati sopra.