HappyHorse-1.1-T2V è un modello di Alibaba per creare brevi scene video da testo. La descrizione definisce personaggi, azioni, ambientazione e stile visivo; questa modalità non richiede un'immagine iniziale. Il modello genera il video e può creare anche l'audio che lo accompagna.
Il produttore mette in evidenza la comprensione del significato della scena, la regia cinematografica e l'espressività del movimento. Il testo può definire l'atmosfera, le azioni del personaggio, il comportamento degli oggetti e la dinamica fisica. Si può così costruire una scena attorno a ciò che deve accadere, per poi guidarla attraverso la luce, l'angolazione e il movimento della videocamera.
L'istruzione è obbligatoria e può essere in qualsiasi lingua. Può contenere fino a 5000 caratteri non cinesi oppure 2500 caratteri cinesi; la parte in eccesso viene scartata. L'azione, l'ambiente e i dettagli visivi importanti devono essere descritti entro questo spazio. Questa impostazione lascia al modello la possibilità di creare una nuova scena, anziché fornirgli un primo fotogramma già pronto.
In questa modalità il testo è il principale strumento di controllo. L'aspetto specifico di un personaggio o di un oggetto può essere descritto a parole; la possibilità di trasmetterlo tramite immagini separate appartiene a un'altra modalità della famiglia. Il risultato dipende dall'intera istruzione: lo stesso seme casuale iniziale aiuta quindi a ottenere varianti simili, ma non garantisce una riproduzione esatta.
Per HappyHorse-1.1, la durata del video si imposta con un numero intero da 3 a 15 secondi. Sono supportate le risoluzioni 480P, 720P e 1080P. Il file finale è in formato MP4 a 24 fotogrammi al secondo. Il modello può generare l'audio insieme alle immagini, collegandolo a ciò che avviene nella scena.
La forma dell'inquadratura può essere definita in anticipo. Sono disponibili 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 e 21:9: dall'inquadratura cinematografica ampia al video verticale allungato. Risoluzione, formato e durata determinano le dimensioni del risultato; contenuto e movimento sono definiti dal testo.
Questa variante è pensata per creare una nuova scena da un'idea espressa a parole. È adatta a un breve episodio, a un'idea visiva o a un video d'atmosfera la cui regia deve essere descritta nel testo.
", "aboutText": "HappyHorse-1.1-T2V è un modello di Alibaba per creare brevi scene video da testo. La descrizione definisce personaggi, azioni, ambientazione e stile visivo; questa modalità non richiede un'immagine iniziale. Il modello genera il video e può creare anche l'audio che lo accompagna.\n\nIl produttore mette in evidenza la comprensione del significato della scena, la regia cinematografica e l'espressività del movimento. Il testo può definire l'atmosfera, le azioni del personaggio, il comportamento degli oggetti e la dinamica fisica. Si può così costruire una scena attorno a ciò che deve accadere, per poi guidarla attraverso la luce, l'angolazione e il movimento della videocamera.\n\n### La regia attraverso le parole\n\nL'istruzione è obbligatoria e può essere in qualsiasi lingua. Può contenere fino a 5000 caratteri non cinesi oppure 2500 caratteri cinesi; la parte in eccesso viene scartata. L'azione, l'ambiente e i dettagli visivi importanti devono essere descritti entro questo spazio. Questa impostazione lascia al modello la possibilità di creare una nuova scena, anziché fornirgli un primo fotogramma già pronto.\n\nIn questa modalità il testo è il principale strumento di controllo. L'aspetto specifico di un personaggio o di un oggetto può essere descritto a parole; la possibilità di trasmetterlo tramite immagini separate appartiene a un'altra modalità della famiglia. Il risultato dipende dall'intera istruzione: lo stesso seme casuale iniziale aiuta quindi a ottenere varianti simili, ma non garantisce una riproduzione esatta.\n\n### Video e audio\n\nPer HappyHorse-1.1, la durata del video si imposta con un numero intero da 3 a 15 secondi. Sono supportate le risoluzioni 480P, 720P e 1080P. Il file finale è in formato MP4 a 24 fotogrammi al secondo. Il modello può generare l'audio insieme alle immagini, collegandolo a ciò che avviene nella scena.\n\nLa forma dell'inquadratura può essere definita in anticipo. Sono disponibili 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 e 21:9: dall'inquadratura cinematografica ampia al video verticale allungato. Risoluzione, formato e durata determinano le dimensioni del risultato; contenuto e movimento sono definiti dal testo.\n\nQuesta variante è pensata per creare una nuova scena da un'idea espressa a parole. È adatta a un breve episodio, a un'idea visiva o a un video d'atmosfera la cui regia deve essere descritta nel testo.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "2d42e55a608d00a6c4304bb7c2f5c47eff0d2010f89c40731b20984925b42189", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "it", "methods": [ { "html": "happyhorse-1.1-t2vModello per creare brevi video con audio da una descrizione testuale. È adatto a scene in cui movimento, composizione e stile visivo vengono definiti con le parole.
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-T2V è un modello di Alibaba per creare brevi scene video da testo. La descrizione definisce personaggi, azioni, ambientazione e stile visivo; questa modalità non richiede un'immagine iniziale. Il modello genera il video e può creare anche l'audio che lo accompagna.
Il produttore mette in evidenza la comprensione del significato della scena, la regia cinematografica e l'espressività del movimento. Il testo può definire l'atmosfera, le azioni del personaggio, il comportamento degli oggetti e la dinamica fisica. Si può così costruire una scena attorno a ciò che deve accadere, per poi guidarla attraverso la luce, l'angolazione e il movimento della videocamera.
L'istruzione è obbligatoria e può essere in qualsiasi lingua. Può contenere fino a 5000 caratteri non cinesi oppure 2500 caratteri cinesi; la parte in eccesso viene scartata. L'azione, l'ambiente e i dettagli visivi importanti devono essere descritti entro questo spazio. Questa impostazione lascia al modello la possibilità di creare una nuova scena, anziché fornirgli un primo fotogramma già pronto.
In questa modalità il testo è il principale strumento di controllo. L'aspetto specifico di un personaggio o di un oggetto può essere descritto a parole; la possibilità di trasmetterlo tramite immagini separate appartiene a un'altra modalità della famiglia. Il risultato dipende dall'intera istruzione: lo stesso seme casuale iniziale aiuta quindi a ottenere varianti simili, ma non garantisce una riproduzione esatta.
Per HappyHorse-1.1, la durata del video si imposta con un numero intero da 3 a 15 secondi. Sono supportate le risoluzioni 480P, 720P e 1080P. Il file finale è in formato MP4 a 24 fotogrammi al secondo. Il modello può generare l'audio insieme alle immagini, collegandolo a ciò che avviene nella scena.
La forma dell'inquadratura può essere definita in anticipo. Sono disponibili 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 e 21:9: dall'inquadratura cinematografica ampia al video verticale allungato. Risoluzione, formato e durata determinano le dimensioni del risultato; contenuto e movimento sono definiti dal testo.
Questa variante è pensata per creare una nuova scena da un'idea espressa a parole. È adatta a un breve episodio, a un'idea visiva o a un video d'atmosfera la cui regia deve essere descritta nel testo.
POST /v1/videos/generationstextvideo| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti happyhorse-1.1-t2v | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | 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 | RequisitoFacoltativo | Valori e limiti 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Predefinito16:9 |
Campoimage_urls | Tipohttps_url|data_image_url[] | RequisitoFacoltativo | Valori e limiti Numero minimo di elementi: 0 Numero massimo di elementi: 0 Numero massimo di byte decodificati: 20.971.520 Tipi MIME: image/jpeg, image/png, image/webp | Predefinito— |
Da testo a video · Obbligatorio: prompt
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, prompt |
Parametromaterial_types | Contrattotext |
Parametrooptional | Contrattoduration, resolution, ratio |
Parametroduration_integer_range | Contratto3, 15 |
Parametrodefault_duration | Contratto5 |
Parametroresolution | Contratto480P, 720P, 1080P |
Parametrodefault_resolution | Contratto720P |
Parametroratio | Contratto16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 |
Parametroratio_must_omit | Contrattofalse |
Parametroimage_urls | Contratto{"max_count":0} |
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_PROMPT_FILE:?Set your actual UTF-8 scene brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-1.1-t2v", "prompt": "", "duration": 5, "resolution": "720P", "ratio": "16:9"}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\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\nprint(json.dumps(json.loads(Path("result.json").read_text()),ensure_ascii=False,indent=2))\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-t2v, happyhorse-t2v, happyhorse-t2v-latest
Usa i percorsi dei metodi indicati sopra.
happyhorse-t2vModello per creare brevi video con audio da una descrizione testuale. È adatto a scene in cui movimento, composizione e stile visivo vengono definiti con le parole.
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-T2V è un modello di Alibaba per creare brevi scene video da testo. La descrizione definisce personaggi, azioni, ambientazione e stile visivo; questa modalità non richiede un'immagine iniziale. Il modello genera il video e può creare anche l'audio che lo accompagna.
Il produttore mette in evidenza la comprensione del significato della scena, la regia cinematografica e l'espressività del movimento. Il testo può definire l'atmosfera, le azioni del personaggio, il comportamento degli oggetti e la dinamica fisica. Si può così costruire una scena attorno a ciò che deve accadere, per poi guidarla attraverso la luce, l'angolazione e il movimento della videocamera.
L'istruzione è obbligatoria e può essere in qualsiasi lingua. Può contenere fino a 5000 caratteri non cinesi oppure 2500 caratteri cinesi; la parte in eccesso viene scartata. L'azione, l'ambiente e i dettagli visivi importanti devono essere descritti entro questo spazio. Questa impostazione lascia al modello la possibilità di creare una nuova scena, anziché fornirgli un primo fotogramma già pronto.
In questa modalità il testo è il principale strumento di controllo. L'aspetto specifico di un personaggio o di un oggetto può essere descritto a parole; la possibilità di trasmetterlo tramite immagini separate appartiene a un'altra modalità della famiglia. Il risultato dipende dall'intera istruzione: lo stesso seme casuale iniziale aiuta quindi a ottenere varianti simili, ma non garantisce una riproduzione esatta.
Per HappyHorse-1.1, la durata del video si imposta con un numero intero da 3 a 15 secondi. Sono supportate le risoluzioni 480P, 720P e 1080P. Il file finale è in formato MP4 a 24 fotogrammi al secondo. Il modello può generare l'audio insieme alle immagini, collegandolo a ciò che avviene nella scena.
La forma dell'inquadratura può essere definita in anticipo. Sono disponibili 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 e 21:9: dall'inquadratura cinematografica ampia al video verticale allungato. Risoluzione, formato e durata determinano le dimensioni del risultato; contenuto e movimento sono definiti dal testo.
Questa variante è pensata per creare una nuova scena da un'idea espressa a parole. È adatta a un breve episodio, a un'idea visiva o a un video d'atmosfera la cui regia deve essere descritta nel testo.
POST /v1/videos/generationstextvideo| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti happyhorse-t2v | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | 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 | RequisitoFacoltativo | Valori e limiti 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Predefinito16:9 |
Campoimage_urls | Tipohttps_url|data_image_url[] | RequisitoFacoltativo | Valori e limiti Numero minimo di elementi: 0 Numero massimo di elementi: 0 Numero massimo di byte decodificati: 20.971.520 Tipi MIME: image/jpeg, image/png, image/webp | Predefinito— |
Da testo a video · Obbligatorio: prompt
| Parametro | Contratto |
|---|---|
Parametromaterial_types | Contrattotext |
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_PROMPT_FILE:?Set your actual UTF-8 scene brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-t2v", "prompt": "", "duration": 5, "resolution": "720P", "ratio": "16:9"}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\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\nprint(json.dumps(json.loads(Path("result.json").read_text()),ensure_ascii=False,indent=2))\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-t2v, happyhorse-t2v, happyhorse-t2v-latest
Usa i percorsi dei metodi indicati sopra.
happyhorse-t2v-latestModello per creare brevi video con audio da una descrizione testuale. È adatto a scene in cui movimento, composizione e stile visivo vengono definiti con le parole.
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-T2V è un modello di Alibaba per creare brevi scene video da testo. La descrizione definisce personaggi, azioni, ambientazione e stile visivo; questa modalità non richiede un'immagine iniziale. Il modello genera il video e può creare anche l'audio che lo accompagna.
Il produttore mette in evidenza la comprensione del significato della scena, la regia cinematografica e l'espressività del movimento. Il testo può definire l'atmosfera, le azioni del personaggio, il comportamento degli oggetti e la dinamica fisica. Si può così costruire una scena attorno a ciò che deve accadere, per poi guidarla attraverso la luce, l'angolazione e il movimento della videocamera.
L'istruzione è obbligatoria e può essere in qualsiasi lingua. Può contenere fino a 5000 caratteri non cinesi oppure 2500 caratteri cinesi; la parte in eccesso viene scartata. L'azione, l'ambiente e i dettagli visivi importanti devono essere descritti entro questo spazio. Questa impostazione lascia al modello la possibilità di creare una nuova scena, anziché fornirgli un primo fotogramma già pronto.
In questa modalità il testo è il principale strumento di controllo. L'aspetto specifico di un personaggio o di un oggetto può essere descritto a parole; la possibilità di trasmetterlo tramite immagini separate appartiene a un'altra modalità della famiglia. Il risultato dipende dall'intera istruzione: lo stesso seme casuale iniziale aiuta quindi a ottenere varianti simili, ma non garantisce una riproduzione esatta.
Per HappyHorse-1.1, la durata del video si imposta con un numero intero da 3 a 15 secondi. Sono supportate le risoluzioni 480P, 720P e 1080P. Il file finale è in formato MP4 a 24 fotogrammi al secondo. Il modello può generare l'audio insieme alle immagini, collegandolo a ciò che avviene nella scena.
La forma dell'inquadratura può essere definita in anticipo. Sono disponibili 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 e 21:9: dall'inquadratura cinematografica ampia al video verticale allungato. Risoluzione, formato e durata determinano le dimensioni del risultato; contenuto e movimento sono definiti dal testo.
Questa variante è pensata per creare una nuova scena da un'idea espressa a parole. È adatta a un breve episodio, a un'idea visiva o a un video d'atmosfera la cui regia deve essere descritta nel testo.
POST /v1/videos/generationstextvideo| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti happyhorse-t2v-latest | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | 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 | RequisitoFacoltativo | Valori e limiti 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Predefinito16:9 |
Campoimage_urls | Tipohttps_url|data_image_url[] | RequisitoFacoltativo | Valori e limiti Numero minimo di elementi: 0 Numero massimo di elementi: 0 Numero massimo di byte decodificati: 20.971.520 Tipi MIME: image/jpeg, image/png, image/webp | Predefinito— |
Da testo a video · Obbligatorio: prompt
| Parametro | Contratto |
|---|---|
Parametromaterial_types | Contrattotext |
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_PROMPT_FILE:?Set your actual UTF-8 scene brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-t2v-latest", "prompt": "", "duration": 5, "resolution": "720P", "ratio": "16:9"}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\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\nprint(json.dumps(json.loads(Path("result.json").read_text()),ensure_ascii=False,indent=2))\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-t2v, happyhorse-t2v, happyhorse-t2v-latest
Usa i percorsi dei metodi indicati sopra.