A HappyHorse-1.1-R2V referenciaképek és szöveges utasítás alapján készít új videojelenetet. Az Alibaba a felismerhető szereplők, objektumok és vizuális stílus megőrzésére tervezte a modellt a mozgás generálása során. A referenciák a jelenet tartalmát és megjelenését határozzák meg, a szöveg pedig azt írja le, hogyan lépjenek kölcsönhatásba ezek az elemek.
Egy és kilenc közötti számú kép használható. Megadhatják a szereplőt, a tárgyat, a környezetet vagy a művészi megjelenítést. A leírásban hivatkozni lehet a referencia sorszámára és a rajta látható konkrét objektumra, így a vizuális anyag összekapcsolható a cselekmény megfelelő részével. Ez különösen hasznos, ha több kép elemeit kell egy kompozícióban egyesíteni.
A kezdőképkockás móddal szemben a referenciák itt az új jelenet tartalmának támpontjai. A szöveges utasítás kötelező: összekapcsolja az objektumok megjelenését a cselekménnyel, a kameramozgással és a teljes jelenet beállításával. A gyártó a vizuális összhangot és a filmszerű mozgást emeli ki; az eredmény generálás útján jön létre, nem a kiinduló képek összevágásával.
JPEG, JPG, PNG és WEBP fogadható el, egyenként legfeljebb 20 MB méretben. A kép rövidebb oldalának legalább 400 pixelesnek kell lennie; 720P vagy nagyobb felbontású anyagok ajánlottak. E mód bemenete kifejezetten képekből és szövegből áll.
Az eredmény MP4 formátumban, másodpercenként 24 képkockával kerül mentésre. Az időtartam 3 és 15 másodperc közötti egész számként adható meg. A felbontás 480P, 720P vagy 1080P lehet; hang generálása is támogatott.
Fekvő, álló és négyzetes képarányok érhetők el: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 és 21:9. A formátum kiválasztásával előre meghatározható az új jelenet kompozíciós tere.
A szöveg bármilyen nyelvű lehet. A korlát 5000 nem kínai vagy 2500 kínai karakter, a többlet levágásra kerül. A referenciák legfontosabb szerepeinek, a cselekménynek és a mozgásnak ezen a kereten belül kell elférniük. A kezdő véletlenmag befolyásolhatja a változatok hasonlóságát, de nem garantálja egy adott videó pontos megismétlését.
", "aboutText": "A HappyHorse-1.1-R2V referenciaképek és szöveges utasítás alapján készít új videojelenetet. Az Alibaba a felismerhető szereplők, objektumok és vizuális stílus megőrzésére tervezte a modellt a mozgás generálása során. A referenciák a jelenet tartalmát és megjelenését határozzák meg, a szöveg pedig azt írja le, hogyan lépjenek kölcsönhatásba ezek az elemek.\n\n### A vizuális minták szerepe\n\nEgy és kilenc közötti számú kép használható. Megadhatják a szereplőt, a tárgyat, a környezetet vagy a művészi megjelenítést. A leírásban hivatkozni lehet a referencia sorszámára és a rajta látható konkrét objektumra, így a vizuális anyag összekapcsolható a cselekmény megfelelő részével. Ez különösen hasznos, ha több kép elemeit kell egy kompozícióban egyesíteni.\n\nA kezdőképkockás móddal szemben a referenciák itt az új jelenet tartalmának támpontjai. A szöveges utasítás kötelező: összekapcsolja az objektumok megjelenését a cselekménnyel, a kameramozgással és a teljes jelenet beállításával. A gyártó a vizuális összhangot és a filmszerű mozgást emeli ki; az eredmény generálás útján jön létre, nem a kiinduló képek összevágásával.\n\nJPEG, JPG, PNG és WEBP fogadható el, egyenként legfeljebb 20 MB méretben. A kép rövidebb oldalának legalább 400 pixelesnek kell lennie; 720P vagy nagyobb felbontású anyagok ajánlottak. E mód bemenete kifejezetten képekből és szövegből áll.\n\n### Időtartam, képarány és hang\n\nAz eredmény MP4 formátumban, másodpercenként 24 képkockával kerül mentésre. Az időtartam 3 és 15 másodperc közötti egész számként adható meg. A felbontás 480P, 720P vagy 1080P lehet; hang generálása is támogatott.\n\nFekvő, álló és négyzetes képarányok érhetők el: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 és 21:9. A formátum kiválasztásával előre meghatározható az új jelenet kompozíciós tere.\n\nA szöveg bármilyen nyelvű lehet. A korlát 5000 nem kínai vagy 2500 kínai karakter, a többlet levágásra kerül. A referenciák legfontosabb szerepeinek, a cselekménynek és a mozgásnak ezen a kereten belül kell elférniük. A kezdő véletlenmag befolyásolhatja a változatok hasonlóságát, de nem garantálja egy adott videó pontos megismétlését.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "d801617d781c7ef52fe73db122785c5d29b54268dd3b263e3acaca50d484d604", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "hu", "methods": [ { "html": "happyhorse-1.1-r2vReferenciaképek és szöveges forgatókönyv alapján videót generáló modell. Segít megőrizni a szereplők megjelenését, a tárgyakat és a vizuális stílust egy új jelenetben.
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A HappyHorse-1.1-R2V referenciaképek és szöveges utasítás alapján készít új videojelenetet. Az Alibaba a felismerhető szereplők, objektumok és vizuális stílus megőrzésére tervezte a modellt a mozgás generálása során. A referenciák a jelenet tartalmát és megjelenését határozzák meg, a szöveg pedig azt írja le, hogyan lépjenek kölcsönhatásba ezek az elemek.
Egy és kilenc közötti számú kép használható. Megadhatják a szereplőt, a tárgyat, a környezetet vagy a művészi megjelenítést. A leírásban hivatkozni lehet a referencia sorszámára és a rajta látható konkrét objektumra, így a vizuális anyag összekapcsolható a cselekmény megfelelő részével. Ez különösen hasznos, ha több kép elemeit kell egy kompozícióban egyesíteni.
A kezdőképkockás móddal szemben a referenciák itt az új jelenet tartalmának támpontjai. A szöveges utasítás kötelező: összekapcsolja az objektumok megjelenését a cselekménnyel, a kameramozgással és a teljes jelenet beállításával. A gyártó a vizuális összhangot és a filmszerű mozgást emeli ki; az eredmény generálás útján jön létre, nem a kiinduló képek összevágásával.
JPEG, JPG, PNG és WEBP fogadható el, egyenként legfeljebb 20 MB méretben. A kép rövidebb oldalának legalább 400 pixelesnek kell lennie; 720P vagy nagyobb felbontású anyagok ajánlottak. E mód bemenete kifejezetten képekből és szövegből áll.
Az eredmény MP4 formátumban, másodpercenként 24 képkockával kerül mentésre. Az időtartam 3 és 15 másodperc közötti egész számként adható meg. A felbontás 480P, 720P vagy 1080P lehet; hang generálása is támogatott.
Fekvő, álló és négyzetes képarányok érhetők el: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 és 21:9. A formátum kiválasztásával előre meghatározható az új jelenet kompozíciós tere.
A szöveg bármilyen nyelvű lehet. A korlát 5000 nem kínai vagy 2500 kínai karakter, a többlet levágásra kerül. A referenciák legfontosabb szerepeinek, a cselekménynek és a mozgásnak ezen a kereten belül kell elférniük. A kezdő véletlenmag befolyásolhatja a változatok hasonlóságát, de nem garantálja egy adott videó pontos megismétlését.
POST /v1/videos/generationstext, imagevideo| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok happyhorse-1.1-r2v | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok Minimális hossz: 1 | Alapértelmezett— |
Meződuration | Típusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: 3 Maximum: 15 Egység: másodperc | Alapértelmezett5 |
Mezőresolution | Típusstring | KövetelményOpcionális | Értékek és korlátok 480P, 720P, 1080P | Alapértelmezett720P |
Mezőratio | Típusstring | KövetelményOpcionális | Értékek és korlátok 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Alapértelmezett16:9 |
Mezőimage_urls | Típushttps_url|data_image_url[] | KövetelményKötelező | Értékek és korlátok Minimális elemszám: 1 Maximális elemszám: 9 Maximális dekódolt bájtszám: 20 971 520 MIME-típusok: image/jpeg, image/png, image/webp | Alapértelmezett— |
reference_images_to_video · Kötelező: prompt, image_urls
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt, image_urls |
Paramétermaterial_types | Szerződéstext, image |
Paraméteroptional | Szerződésduration, resolution, ratio |
Paraméterduration_integer_range | Szerződés3, 15 |
Paraméterdefault_duration | Szerződés5 |
Paraméterresolution | Szerződés480P, 720P, 1080P |
Paraméterdefault_resolution | Szerződés720P |
Paraméterratio | Szerződés16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 |
Paraméterratio_must_omit | Szerződésfalse |
Paraméterimage_urls | Szerződés{"min_count":1,"max_count":9,"schemes":["https","raszteres képadatok base64 formában"],"max_data_image_bytes":20971520} |
Életciklus: 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
A metódusok szerkezete és azonosítói pontosak; a beszállítói képesség különbözik a kérelmek befogadásától.
POST /v1/videos/generationsAz Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URLS_FILE:?Set a JSON file containing your actual reference-image URLs}"\nexport AILOOT_IMAGE_URLS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-1.1-r2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nf=Path(os.environ["AILOOT_IMAGE_URLS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual reference URL JSON file")\nurls=json.loads(f.read_text())\nif not isinstance(urls,list) or not 1<=len(urls)<=9:raise SystemExit("Provide one to nine reference-image URLs")\nfor u in urls:\n z=urlsplit(u) if isinstance(u,str) else None\n if not z or z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Each reference must be an actual HTTPS image URL")\np["image_urls"]=urls\np["ratio"]="16:9"\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\nMentsen minden elkészült videót és visszaadott fájlt; töltse le az összes ténylegesen visszaadott médiafájl URL-jének tartalmát.
Őrizzen meg minden visszaadott adatelemet és kimeneti indexet. A content_url csak az elsőt jelöli; kérje le az összes tényleges tartalomútvonalat és médiaállományt. Az index nélküli GET content nem adja vissza az összes kimenetet.
A meglévő eredeti feladatot kérdezze le; ismeretlen kimenetelű küldést soha ne küldjön be újra.
| Mező | Típus |
|---|---|
Mezőid | Típusstring |
Mezőobject | Típusstring |
Mezőmodel | Típusstring |
Mezőstatus | Típusstring |
Mezőcontent_url | Típussigned URL |
Meződata[] | Típussigned URL |
Mezőusage | Típusobject |
Mezőresult_pending_check | Típusboolean |
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételÉrvénytelen kötelező mezők, az anyag érvénytelen reprezentációja vagy érvénytelen paraméterérték | Következő lépésJavítsa a jelzett mezőket egy új létrehozási kérés előtt. |
Válasz409 · video_not_ready | FeltételAz eredeti eredmény tartalma még nem érhető el | Következő lépésKérdezze le az eredetileg visszaadott azonosítót, és tartsa be a Retry-After előírását. |
Válaszserver_error | FeltételA visszaadott válasz szerint a művelet vagy az eredmény ellenőrzést igényel | Következő lépésŐrizze meg az eredetileg visszaadott művelet- vagy feladatazonosítót, a kérés fejléceit és a választ; folytassa az eredeti művelet támogatott lekérdezéseit. Ne küldje be újra a létrehozási kérést. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Használja a fent látható metódusútvonalakat.
happyhorse-r2vReferenciaképek és szöveges forgatókönyv alapján videót generáló modell. Segít megőrizni a szereplők megjelenését, a tárgyakat és a vizuális stílust egy új jelenetben.
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A HappyHorse-1.1-R2V referenciaképek és szöveges utasítás alapján készít új videojelenetet. Az Alibaba a felismerhető szereplők, objektumok és vizuális stílus megőrzésére tervezte a modellt a mozgás generálása során. A referenciák a jelenet tartalmát és megjelenését határozzák meg, a szöveg pedig azt írja le, hogyan lépjenek kölcsönhatásba ezek az elemek.
Egy és kilenc közötti számú kép használható. Megadhatják a szereplőt, a tárgyat, a környezetet vagy a művészi megjelenítést. A leírásban hivatkozni lehet a referencia sorszámára és a rajta látható konkrét objektumra, így a vizuális anyag összekapcsolható a cselekmény megfelelő részével. Ez különösen hasznos, ha több kép elemeit kell egy kompozícióban egyesíteni.
A kezdőképkockás móddal szemben a referenciák itt az új jelenet tartalmának támpontjai. A szöveges utasítás kötelező: összekapcsolja az objektumok megjelenését a cselekménnyel, a kameramozgással és a teljes jelenet beállításával. A gyártó a vizuális összhangot és a filmszerű mozgást emeli ki; az eredmény generálás útján jön létre, nem a kiinduló képek összevágásával.
JPEG, JPG, PNG és WEBP fogadható el, egyenként legfeljebb 20 MB méretben. A kép rövidebb oldalának legalább 400 pixelesnek kell lennie; 720P vagy nagyobb felbontású anyagok ajánlottak. E mód bemenete kifejezetten képekből és szövegből áll.
Az eredmény MP4 formátumban, másodpercenként 24 képkockával kerül mentésre. Az időtartam 3 és 15 másodperc közötti egész számként adható meg. A felbontás 480P, 720P vagy 1080P lehet; hang generálása is támogatott.
Fekvő, álló és négyzetes képarányok érhetők el: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 és 21:9. A formátum kiválasztásával előre meghatározható az új jelenet kompozíciós tere.
A szöveg bármilyen nyelvű lehet. A korlát 5000 nem kínai vagy 2500 kínai karakter, a többlet levágásra kerül. A referenciák legfontosabb szerepeinek, a cselekménynek és a mozgásnak ezen a kereten belül kell elférniük. A kezdő véletlenmag befolyásolhatja a változatok hasonlóságát, de nem garantálja egy adott videó pontos megismétlését.
POST /v1/videos/generationstext, imagevideo| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok happyhorse-r2v | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok Minimális hossz: 1 | Alapértelmezett— |
Meződuration | Típusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: 3 Maximum: 15 Egység: másodperc | Alapértelmezett5 |
Mezőresolution | Típusstring | KövetelményOpcionális | Értékek és korlátok 480P, 720P, 1080P | Alapértelmezett720P |
Mezőratio | Típusstring | KövetelményOpcionális | Értékek és korlátok 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Alapértelmezett16:9 |
Mezőimage_urls | Típushttps_url|data_image_url[] | KövetelményKötelező | Értékek és korlátok Minimális elemszám: 1 Maximális elemszám: 9 Maximális dekódolt bájtszám: 20 971 520 MIME-típusok: image/jpeg, image/png, image/webp | Alapértelmezett— |
reference_images_to_video · Kötelező: prompt, image_urls
| Paraméter | Szerződés |
|---|---|
Paramétermaterial_types | Szerződéstext, image |
Paraméterrequired | Szerződésnull |
Paraméteroptional_controls | Szerződésnull |
Életciklus: 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
A metódusok szerkezete és azonosítói pontosak; a beszállítói képesség különbözik a kérelmek befogadásától.
POST /v1/videos/generationsAz Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URLS_FILE:?Set a JSON file containing your actual reference-image URLs}"\nexport AILOOT_IMAGE_URLS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-r2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nf=Path(os.environ["AILOOT_IMAGE_URLS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual reference URL JSON file")\nurls=json.loads(f.read_text())\nif not isinstance(urls,list) or not 1<=len(urls)<=9:raise SystemExit("Provide one to nine reference-image URLs")\nfor u in urls:\n z=urlsplit(u) if isinstance(u,str) else None\n if not z or z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Each reference must be an actual HTTPS image URL")\np["image_urls"]=urls\np["ratio"]="16:9"\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\nMentsen minden elkészült videót és visszaadott fájlt; töltse le az összes ténylegesen visszaadott médiafájl URL-jének tartalmát.
Őrizzen meg minden visszaadott adatelemet és kimeneti indexet. A content_url csak az elsőt jelöli; kérje le az összes tényleges tartalomútvonalat és médiaállományt. Az index nélküli GET content nem adja vissza az összes kimenetet.
A meglévő eredeti feladatot kérdezze le; ismeretlen kimenetelű küldést soha ne küldjön be újra.
| Mező | Típus |
|---|---|
Mezőid | Típusstring |
Mezőobject | Típusstring |
Mezőmodel | Típusstring |
Mezőstatus | Típusstring |
Mezőcontent_url | Típussigned URL |
Meződata[] | Típussigned URL |
Mezőusage | Típusobject |
Mezőresult_pending_check | Típusboolean |
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételÉrvénytelen kötelező mezők, az anyag érvénytelen reprezentációja vagy érvénytelen paraméterérték | Következő lépésJavítsa a jelzett mezőket egy új létrehozási kérés előtt. |
Válasz409 · video_not_ready | FeltételAz eredeti eredmény tartalma még nem érhető el | Következő lépésKérdezze le az eredetileg visszaadott azonosítót, és tartsa be a Retry-After előírását. |
Válaszserver_error | FeltételA visszaadott válasz szerint a művelet vagy az eredmény ellenőrzést igényel | Következő lépésŐrizze meg az eredetileg visszaadott művelet- vagy feladatazonosítót, a kérés fejléceit és a választ; folytassa az eredeti művelet támogatott lekérdezéseit. Ne küldje be újra a létrehozási kérést. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Használja a fent látható metódusútvonalakat.
happyhorse-r2v-latestReferenciaképek és szöveges forgatókönyv alapján videót generáló modell. Segít megőrizni a szereplők megjelenését, a tárgyakat és a vizuális stílust egy új jelenetben.
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A HappyHorse-1.1-R2V referenciaképek és szöveges utasítás alapján készít új videojelenetet. Az Alibaba a felismerhető szereplők, objektumok és vizuális stílus megőrzésére tervezte a modellt a mozgás generálása során. A referenciák a jelenet tartalmát és megjelenését határozzák meg, a szöveg pedig azt írja le, hogyan lépjenek kölcsönhatásba ezek az elemek.
Egy és kilenc közötti számú kép használható. Megadhatják a szereplőt, a tárgyat, a környezetet vagy a művészi megjelenítést. A leírásban hivatkozni lehet a referencia sorszámára és a rajta látható konkrét objektumra, így a vizuális anyag összekapcsolható a cselekmény megfelelő részével. Ez különösen hasznos, ha több kép elemeit kell egy kompozícióban egyesíteni.
A kezdőképkockás móddal szemben a referenciák itt az új jelenet tartalmának támpontjai. A szöveges utasítás kötelező: összekapcsolja az objektumok megjelenését a cselekménnyel, a kameramozgással és a teljes jelenet beállításával. A gyártó a vizuális összhangot és a filmszerű mozgást emeli ki; az eredmény generálás útján jön létre, nem a kiinduló képek összevágásával.
JPEG, JPG, PNG és WEBP fogadható el, egyenként legfeljebb 20 MB méretben. A kép rövidebb oldalának legalább 400 pixelesnek kell lennie; 720P vagy nagyobb felbontású anyagok ajánlottak. E mód bemenete kifejezetten képekből és szövegből áll.
Az eredmény MP4 formátumban, másodpercenként 24 képkockával kerül mentésre. Az időtartam 3 és 15 másodperc közötti egész számként adható meg. A felbontás 480P, 720P vagy 1080P lehet; hang generálása is támogatott.
Fekvő, álló és négyzetes képarányok érhetők el: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 és 21:9. A formátum kiválasztásával előre meghatározható az új jelenet kompozíciós tere.
A szöveg bármilyen nyelvű lehet. A korlát 5000 nem kínai vagy 2500 kínai karakter, a többlet levágásra kerül. A referenciák legfontosabb szerepeinek, a cselekménynek és a mozgásnak ezen a kereten belül kell elférniük. A kezdő véletlenmag befolyásolhatja a változatok hasonlóságát, de nem garantálja egy adott videó pontos megismétlését.
POST /v1/videos/generationstext, imagevideo| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok happyhorse-r2v-latest | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok Minimális hossz: 1 | Alapértelmezett— |
Meződuration | Típusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: 3 Maximum: 15 Egység: másodperc | Alapértelmezett5 |
Mezőresolution | Típusstring | KövetelményOpcionális | Értékek és korlátok 480P, 720P, 1080P | Alapértelmezett720P |
Mezőratio | Típusstring | KövetelményOpcionális | Értékek és korlátok 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Alapértelmezett16:9 |
Mezőimage_urls | Típushttps_url|data_image_url[] | KövetelményKötelező | Értékek és korlátok Minimális elemszám: 1 Maximális elemszám: 9 Maximális dekódolt bájtszám: 20 971 520 MIME-típusok: image/jpeg, image/png, image/webp | Alapértelmezett— |
reference_images_to_video · Kötelező: prompt, image_urls
| Paraméter | Szerződés |
|---|---|
Paramétermaterial_types | Szerződéstext, image |
Paraméterrequired | Szerződésnull |
Paraméteroptional_controls | Szerződésnull |
Életciklus: 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
A metódusok szerkezete és azonosítói pontosak; a beszállítói képesség különbözik a kérelmek befogadásától.
POST /v1/videos/generationsAz Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URLS_FILE:?Set a JSON file containing your actual reference-image URLs}"\nexport AILOOT_IMAGE_URLS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-r2v-latest", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nf=Path(os.environ["AILOOT_IMAGE_URLS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual reference URL JSON file")\nurls=json.loads(f.read_text())\nif not isinstance(urls,list) or not 1<=len(urls)<=9:raise SystemExit("Provide one to nine reference-image URLs")\nfor u in urls:\n z=urlsplit(u) if isinstance(u,str) else None\n if not z or z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Each reference must be an actual HTTPS image URL")\np["image_urls"]=urls\np["ratio"]="16:9"\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\nMentsen minden elkészült videót és visszaadott fájlt; töltse le az összes ténylegesen visszaadott médiafájl URL-jének tartalmát.
Őrizzen meg minden visszaadott adatelemet és kimeneti indexet. A content_url csak az elsőt jelöli; kérje le az összes tényleges tartalomútvonalat és médiaállományt. Az index nélküli GET content nem adja vissza az összes kimenetet.
A meglévő eredeti feladatot kérdezze le; ismeretlen kimenetelű küldést soha ne küldjön be újra.
| Mező | Típus |
|---|---|
Mezőid | Típusstring |
Mezőobject | Típusstring |
Mezőmodel | Típusstring |
Mezőstatus | Típusstring |
Mezőcontent_url | Típussigned URL |
Meződata[] | Típussigned URL |
Mezőusage | Típusobject |
Mezőresult_pending_check | Típusboolean |
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételÉrvénytelen kötelező mezők, az anyag érvénytelen reprezentációja vagy érvénytelen paraméterérték | Következő lépésJavítsa a jelzett mezőket egy új létrehozási kérés előtt. |
Válasz409 · video_not_ready | FeltételAz eredeti eredmény tartalma még nem érhető el | Következő lépésKérdezze le az eredetileg visszaadott azonosítót, és tartsa be a Retry-After előírását. |
Válaszserver_error | FeltételA visszaadott válasz szerint a művelet vagy az eredmény ellenőrzést igényel | Következő lépésŐrizze meg az eredetileg visszaadott művelet- vagy feladatazonosítót, a kérés fejléceit és a választ; folytassa az eredeti művelet támogatott lekérdezéseit. Ne küldje be újra a létrehozási kérést. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Használja a fent látható metódusútvonalakat.