HappyHorse-1.1-I2V je model Alibaba, který začíná videoscénu hotovým obrázkem. Obrázek se stane prvním snímkem a text může určit následný děj: pohyb postavy, změny ve scéně a směr pohybu kamery. Hodí se k oživení ilustrace, produktové fotografie nebo předem připraveného vizuálního konceptu.
Textový popis je nepovinný. Pokud chybí, model sám odvodí možný pohyb z obsahu počátečního obrázku. Při výslovném zadání určuje vstupní obrázek kompozici a vzhled objektů, zatímco slova řídí vývoj scény v čase.
Alibaba zdůrazňuje zachování vzhledu postavy, vizuální konzistenci, plynulost pohybu a spojení obrazu se zvukem. Mezi deklarované vlastnosti patří také stálost nápisů a textur. Tyto vlastnosti vyjadřují záměr modelu a neznamenají doslovné zachování každého pixelu ve všech vygenerovaných snímcích.
V tomto režimu se používá jeden počáteční obrázek. Určuje výchozí scénu, nikoli soubor nezávislých vzorů pro novou kompozici. Možnost zadat samostatný závěrečný snímek pro tuto konkrétní verzi nebyla deklarována.
Přijímány jsou JPEG, JPG, PNG a WEBP. Každá strana vstupního obrázku musí mít alespoň 300 pixelů; povolený poměr stran je od 1:2,5 do 2,5:1 a velikost souboru do 20 MB. Poměr stran hotového videa odpovídá prvnímu snímku.
Délka se volí jako celé číslo od 3 do 15 sekund. Dostupná jsou rozlišení 480P, 720P a 1080P; výstupním formátem je MP4 a snímková frekvence činí 24 snímků za sekundu. Podporováno je vytváření zvukového doprovodu spolu s obrazem videa.
Popis může být v libovolném jazyce a obsahovat až 5000 nečínských nebo 2500 čínských znaků. Při překročení limitu se přebytečná část zahodí, proto je vhodné popsat důležité děje a vlastnosti pohybu v mezích zadání. Stejná počáteční hodnota náhodného semínka může vést k podobným videím, ale nezaručuje jejich shodu snímek po snímku.
", "aboutText": "HappyHorse-1.1-I2V je model Alibaba, který začíná videoscénu hotovým obrázkem. Obrázek se stane prvním snímkem a text může určit následný děj: pohyb postavy, změny ve scéně a směr pohybu kamery. Hodí se k oživení ilustrace, produktové fotografie nebo předem připraveného vizuálního konceptu.\n\nTextový popis je nepovinný. Pokud chybí, model sám odvodí možný pohyb z obsahu počátečního obrázku. Při výslovném zadání určuje vstupní obrázek kompozici a vzhled objektů, zatímco slova řídí vývoj scény v čase.\n\n### Od prvního snímku k pohybu\n\nAlibaba zdůrazňuje zachování vzhledu postavy, vizuální konzistenci, plynulost pohybu a spojení obrazu se zvukem. Mezi deklarované vlastnosti patří také stálost nápisů a textur. Tyto vlastnosti vyjadřují záměr modelu a neznamenají doslovné zachování každého pixelu ve všech vygenerovaných snímcích.\n\nV tomto režimu se používá jeden počáteční obrázek. Určuje výchozí scénu, nikoli soubor nezávislých vzorů pro novou kompozici. Možnost zadat samostatný závěrečný snímek pro tuto konkrétní verzi nebyla deklarována.\n\nPřijímány jsou JPEG, JPG, PNG a WEBP. Každá strana vstupního obrázku musí mít alespoň 300 pixelů; povolený poměr stran je od 1:2,5 do 2,5:1 a velikost souboru do 20 MB. Poměr stran hotového videa odpovídá prvnímu snímku.\n\n### Parametry videa\n\nDélka se volí jako celé číslo od 3 do 15 sekund. Dostupná jsou rozlišení 480P, 720P a 1080P; výstupním formátem je MP4 a snímková frekvence činí 24 snímků za sekundu. Podporováno je vytváření zvukového doprovodu spolu s obrazem videa.\n\nPopis může být v libovolném jazyce a obsahovat až 5000 nečínských nebo 2500 čínských znaků. Při překročení limitu se přebytečná část zahodí, proto je vhodné popsat důležité děje a vlastnosti pohybu v mezích zadání. Stejná počáteční hodnota náhodného semínka může vést k podobným videím, ale nezaručuje jejich shodu snímek po snímku.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "4066f75ce61c42febe538f5833db5069fd7f2229cbc39e7a678929f26b5f402d", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "cs", "methods": [ { "html": "happyhorse-1.1-i2vModel pro oživení obrázku: výchozí obrázek určuje první snímek a popis usměrňuje další pohyb. Vytváří krátké video s možností zvukového doprovodu.
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
HappyHorse-1.1-I2V je model Alibaba, který začíná videoscénu hotovým obrázkem. Obrázek se stane prvním snímkem a text může určit následný děj: pohyb postavy, změny ve scéně a směr pohybu kamery. Hodí se k oživení ilustrace, produktové fotografie nebo předem připraveného vizuálního konceptu.
Textový popis je nepovinný. Pokud chybí, model sám odvodí možný pohyb z obsahu počátečního obrázku. Při výslovném zadání určuje vstupní obrázek kompozici a vzhled objektů, zatímco slova řídí vývoj scény v čase.
Alibaba zdůrazňuje zachování vzhledu postavy, vizuální konzistenci, plynulost pohybu a spojení obrazu se zvukem. Mezi deklarované vlastnosti patří také stálost nápisů a textur. Tyto vlastnosti vyjadřují záměr modelu a neznamenají doslovné zachování každého pixelu ve všech vygenerovaných snímcích.
V tomto režimu se používá jeden počáteční obrázek. Určuje výchozí scénu, nikoli soubor nezávislých vzorů pro novou kompozici. Možnost zadat samostatný závěrečný snímek pro tuto konkrétní verzi nebyla deklarována.
Přijímány jsou JPEG, JPG, PNG a WEBP. Každá strana vstupního obrázku musí mít alespoň 300 pixelů; povolený poměr stran je od 1:2,5 do 2,5:1 a velikost souboru do 20 MB. Poměr stran hotového videa odpovídá prvnímu snímku.
Délka se volí jako celé číslo od 3 do 15 sekund. Dostupná jsou rozlišení 480P, 720P a 1080P; výstupním formátem je MP4 a snímková frekvence činí 24 snímků za sekundu. Podporováno je vytváření zvukového doprovodu spolu s obrazem videa.
Popis může být v libovolném jazyce a obsahovat až 5000 nečínských nebo 2500 čínských znaků. Při překročení limitu se přebytečná část zahodí, proto je vhodné popsat důležité děje a vlastnosti pohybu v mezích zadání. Stejná počáteční hodnota náhodného semínka může vést k podobným videím, ale nezaručuje jejich shodu snímek po snímku.
POST /v1/videos/generationstext, imagevideo| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity happyhorse-1.1-i2v | Výchozí— |
Poleprompt | Typstring | PožadavekVolitelné | Hodnoty a limity Minimální délka: 1 | Výchozí— |
Poleduration | Typinteger | PožadavekVolitelné | Hodnoty a limity Minimum: 3 Maximum: 15 Jednotka: sekundy | Výchozí5 |
Poleresolution | Typstring | PožadavekVolitelné | Hodnoty a limity 480P, 720P, 1080P | Výchozí720P |
Poleratio | Typstring | PožadavekNepodporováno | Hodnoty a limity | Výchozí— |
Poleimage_urls | Typhttps_url|data_image_url[] | PožadavekPovinné | Hodnoty a limity Minimální počet položek: 1 Maximální počet položek: 1 Maximální počet dekódovaných bajtů: 20 971 520 Typy MIME: image/jpeg, image/png, image/webp | Výchozí— |
first_frame_to_video · Povinné: image_urls
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, image_urls |
Parametrmaterial_types | Kontrakttext, image |
Parametroptional | Kontraktduration, resolution, ratio, prompt |
Parametrduration_integer_range | Kontrakt3, 15 |
Parametrdefault_duration | Kontrakt5 |
Parametrresolution | Kontrakt480P, 720P, 1080P |
Parametrdefault_resolution | Kontrakt720P |
Parametrratio | Kontrakt |
Parametrratio_must_omit | Kontrakttrue |
Parametrimage_urls | Kontrakt{"min_count":1,"max_count":1,"schemes":["https","rastrová data v base64"],"max_data_image_bytes":20971520} |
Životní cyklus: 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
Struktury metod a ID jsou přesné; schopnosti dodavatele jsou oddělené od připuštění požadavku.
POST /v1/videos/generationsAiloot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
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\nUložte každé dokončené video či vrácený soubor; stáhněte obsah každé skutečně vrácené URL souboru.
Zachovejte každou vrácenou datovou položku a index výstupu. content_url označuje pouze první; načtěte každou skutečnou cestu obsahu či soubor. GET obsahu bez indexu nepředstavuje všechny výstupy.
Načítejte existující původní úlohu; odeslání s neznámým výsledkem nikdy neopakujte.
| Pole | Typ |
|---|---|
Poleid | Typstring |
Poleobject | Typstring |
Polemodel | Typstring |
Polestatus | Typstring |
Polecontent_url | Typsigned URL |
Poledata[] | Typsigned URL |
Poleusage | Typobject |
Poleresult_pending_check | Typboolean |
| Odpověď | Podmínka | Další krok |
|---|---|---|
Odpověď400 · invalid_request_error | PodmínkaNeplatná povinná pole, reprezentace podkladů nebo hodnota parametru | Další krokPřed novým požadavkem na vytvoření opravte uvedená pole. |
Odpověď409 · video_not_ready | PodmínkaObsah původního výsledku zatím není dostupný | Další krokDotazujte se na původní vrácené ID a dodržujte Retry-After. |
Odpověďserver_error | PodmínkaVrácená odpověď uvádí, že operaci nebo výsledek je třeba zkontrolovat | Další krokUchovejte původní vrácené ID operace nebo úlohy, hlavičky požadavku a odpověď; pokračujte v podporovaném načítání údajů o této původní operaci. Požadavek na vytvoření znovu neodesílejte. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
Použijte cesty metod uvedené výše.
happyhorse-i2vModel pro oživení obrázku: výchozí obrázek určuje první snímek a popis usměrňuje další pohyb. Vytváří krátké video s možností zvukového doprovodu.
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
HappyHorse-1.1-I2V je model Alibaba, který začíná videoscénu hotovým obrázkem. Obrázek se stane prvním snímkem a text může určit následný děj: pohyb postavy, změny ve scéně a směr pohybu kamery. Hodí se k oživení ilustrace, produktové fotografie nebo předem připraveného vizuálního konceptu.
Textový popis je nepovinný. Pokud chybí, model sám odvodí možný pohyb z obsahu počátečního obrázku. Při výslovném zadání určuje vstupní obrázek kompozici a vzhled objektů, zatímco slova řídí vývoj scény v čase.
Alibaba zdůrazňuje zachování vzhledu postavy, vizuální konzistenci, plynulost pohybu a spojení obrazu se zvukem. Mezi deklarované vlastnosti patří také stálost nápisů a textur. Tyto vlastnosti vyjadřují záměr modelu a neznamenají doslovné zachování každého pixelu ve všech vygenerovaných snímcích.
V tomto režimu se používá jeden počáteční obrázek. Určuje výchozí scénu, nikoli soubor nezávislých vzorů pro novou kompozici. Možnost zadat samostatný závěrečný snímek pro tuto konkrétní verzi nebyla deklarována.
Přijímány jsou JPEG, JPG, PNG a WEBP. Každá strana vstupního obrázku musí mít alespoň 300 pixelů; povolený poměr stran je od 1:2,5 do 2,5:1 a velikost souboru do 20 MB. Poměr stran hotového videa odpovídá prvnímu snímku.
Délka se volí jako celé číslo od 3 do 15 sekund. Dostupná jsou rozlišení 480P, 720P a 1080P; výstupním formátem je MP4 a snímková frekvence činí 24 snímků za sekundu. Podporováno je vytváření zvukového doprovodu spolu s obrazem videa.
Popis může být v libovolném jazyce a obsahovat až 5000 nečínských nebo 2500 čínských znaků. Při překročení limitu se přebytečná část zahodí, proto je vhodné popsat důležité děje a vlastnosti pohybu v mezích zadání. Stejná počáteční hodnota náhodného semínka může vést k podobným videím, ale nezaručuje jejich shodu snímek po snímku.
POST /v1/videos/generationstext, imagevideo| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity happyhorse-i2v | Výchozí— |
Poleprompt | Typstring | PožadavekVolitelné | Hodnoty a limity Minimální délka: 1 | Výchozí— |
Poleduration | Typinteger | PožadavekVolitelné | Hodnoty a limity Minimum: 3 Maximum: 15 Jednotka: sekundy | Výchozí5 |
Poleresolution | Typstring | PožadavekVolitelné | Hodnoty a limity 480P, 720P, 1080P | Výchozí720P |
Poleratio | Typstring | PožadavekNepodporováno | Hodnoty a limity | Výchozí— |
Poleimage_urls | Typhttps_url|data_image_url[] | PožadavekPovinné | Hodnoty a limity Minimální počet položek: 1 Maximální počet položek: 1 Maximální počet dekódovaných bajtů: 20 971 520 Typy MIME: image/jpeg, image/png, image/webp | Výchozí— |
first_frame_to_video · Povinné: image_urls
| Parametr | Kontrakt |
|---|---|
Parametrmaterial_types | Kontrakttext, image |
Parametrrequired | Kontraktnull |
Parametroptional_controls | Kontraktnull |
Životní cyklus: 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
Struktury metod a ID jsou přesné; schopnosti dodavatele jsou oddělené od připuštění požadavku.
POST /v1/videos/generationsAiloot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
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\nUložte každé dokončené video či vrácený soubor; stáhněte obsah každé skutečně vrácené URL souboru.
Zachovejte každou vrácenou datovou položku a index výstupu. content_url označuje pouze první; načtěte každou skutečnou cestu obsahu či soubor. GET obsahu bez indexu nepředstavuje všechny výstupy.
Načítejte existující původní úlohu; odeslání s neznámým výsledkem nikdy neopakujte.
| Pole | Typ |
|---|---|
Poleid | Typstring |
Poleobject | Typstring |
Polemodel | Typstring |
Polestatus | Typstring |
Polecontent_url | Typsigned URL |
Poledata[] | Typsigned URL |
Poleusage | Typobject |
Poleresult_pending_check | Typboolean |
| Odpověď | Podmínka | Další krok |
|---|---|---|
Odpověď400 · invalid_request_error | PodmínkaNeplatná povinná pole, reprezentace podkladů nebo hodnota parametru | Další krokPřed novým požadavkem na vytvoření opravte uvedená pole. |
Odpověď409 · video_not_ready | PodmínkaObsah původního výsledku zatím není dostupný | Další krokDotazujte se na původní vrácené ID a dodržujte Retry-After. |
Odpověďserver_error | PodmínkaVrácená odpověď uvádí, že operaci nebo výsledek je třeba zkontrolovat | Další krokUchovejte původní vrácené ID operace nebo úlohy, hlavičky požadavku a odpověď; pokračujte v podporovaném načítání údajů o této původní operaci. Požadavek na vytvoření znovu neodesílejte. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
Použijte cesty metod uvedené výše.
happyhorse-i2v-latestModel pro oživení obrázku: výchozí obrázek určuje první snímek a popis usměrňuje další pohyb. Vytváří krátké video s možností zvukového doprovodu.
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
HappyHorse-1.1-I2V je model Alibaba, který začíná videoscénu hotovým obrázkem. Obrázek se stane prvním snímkem a text může určit následný děj: pohyb postavy, změny ve scéně a směr pohybu kamery. Hodí se k oživení ilustrace, produktové fotografie nebo předem připraveného vizuálního konceptu.
Textový popis je nepovinný. Pokud chybí, model sám odvodí možný pohyb z obsahu počátečního obrázku. Při výslovném zadání určuje vstupní obrázek kompozici a vzhled objektů, zatímco slova řídí vývoj scény v čase.
Alibaba zdůrazňuje zachování vzhledu postavy, vizuální konzistenci, plynulost pohybu a spojení obrazu se zvukem. Mezi deklarované vlastnosti patří také stálost nápisů a textur. Tyto vlastnosti vyjadřují záměr modelu a neznamenají doslovné zachování každého pixelu ve všech vygenerovaných snímcích.
V tomto režimu se používá jeden počáteční obrázek. Určuje výchozí scénu, nikoli soubor nezávislých vzorů pro novou kompozici. Možnost zadat samostatný závěrečný snímek pro tuto konkrétní verzi nebyla deklarována.
Přijímány jsou JPEG, JPG, PNG a WEBP. Každá strana vstupního obrázku musí mít alespoň 300 pixelů; povolený poměr stran je od 1:2,5 do 2,5:1 a velikost souboru do 20 MB. Poměr stran hotového videa odpovídá prvnímu snímku.
Délka se volí jako celé číslo od 3 do 15 sekund. Dostupná jsou rozlišení 480P, 720P a 1080P; výstupním formátem je MP4 a snímková frekvence činí 24 snímků za sekundu. Podporováno je vytváření zvukového doprovodu spolu s obrazem videa.
Popis může být v libovolném jazyce a obsahovat až 5000 nečínských nebo 2500 čínských znaků. Při překročení limitu se přebytečná část zahodí, proto je vhodné popsat důležité děje a vlastnosti pohybu v mezích zadání. Stejná počáteční hodnota náhodného semínka může vést k podobným videím, ale nezaručuje jejich shodu snímek po snímku.
POST /v1/videos/generationstext, imagevideo| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity happyhorse-i2v-latest | Výchozí— |
Poleprompt | Typstring | PožadavekVolitelné | Hodnoty a limity Minimální délka: 1 | Výchozí— |
Poleduration | Typinteger | PožadavekVolitelné | Hodnoty a limity Minimum: 3 Maximum: 15 Jednotka: sekundy | Výchozí5 |
Poleresolution | Typstring | PožadavekVolitelné | Hodnoty a limity 480P, 720P, 1080P | Výchozí720P |
Poleratio | Typstring | PožadavekNepodporováno | Hodnoty a limity | Výchozí— |
Poleimage_urls | Typhttps_url|data_image_url[] | PožadavekPovinné | Hodnoty a limity Minimální počet položek: 1 Maximální počet položek: 1 Maximální počet dekódovaných bajtů: 20 971 520 Typy MIME: image/jpeg, image/png, image/webp | Výchozí— |
first_frame_to_video · Povinné: image_urls
| Parametr | Kontrakt |
|---|---|
Parametrmaterial_types | Kontrakttext, image |
Parametrrequired | Kontraktnull |
Parametroptional_controls | Kontraktnull |
Životní cyklus: 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
Struktury metod a ID jsou přesné; schopnosti dodavatele jsou oddělené od připuštění požadavku.
POST /v1/videos/generationsAiloot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
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\nUložte každé dokončené video či vrácený soubor; stáhněte obsah každé skutečně vrácené URL souboru.
Zachovejte každou vrácenou datovou položku a index výstupu. content_url označuje pouze první; načtěte každou skutečnou cestu obsahu či soubor. GET obsahu bez indexu nepředstavuje všechny výstupy.
Načítejte existující původní úlohu; odeslání s neznámým výsledkem nikdy neopakujte.
| Pole | Typ |
|---|---|
Poleid | Typstring |
Poleobject | Typstring |
Polemodel | Typstring |
Polestatus | Typstring |
Polecontent_url | Typsigned URL |
Poledata[] | Typsigned URL |
Poleusage | Typobject |
Poleresult_pending_check | Typboolean |
| Odpověď | Podmínka | Další krok |
|---|---|---|
Odpověď400 · invalid_request_error | PodmínkaNeplatná povinná pole, reprezentace podkladů nebo hodnota parametru | Další krokPřed novým požadavkem na vytvoření opravte uvedená pole. |
Odpověď409 · video_not_ready | PodmínkaObsah původního výsledku zatím není dostupný | Další krokDotazujte se na původní vrácené ID a dodržujte Retry-After. |
Odpověďserver_error | PodmínkaVrácená odpověď uvádí, že operaci nebo výsledek je třeba zkontrolovat | Další krokUchovejte původní vrácené ID operace nebo úlohy, hlavičky požadavku a odpověď; pokračujte v podporovaném načítání údajů o této původní operaci. Požadavek na vytvoření znovu neodesílejte. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
Použijte cesty metod uvedené výše.