HappyHorse-1.1-R2V skapar en ny videoscen utifrån referensbilder och en textinstruktion. Alibaba har inriktat modellen på att bevara igenkännbara karaktärer, objekt och visuell stil när rörelser genereras. Referenserna anger scenens innehåll och utseende, medan texten beskriver hur delarna ska samverka.
Från en till nio bilder kan användas. De kan ange en karaktär, ett föremål, en omgivning eller ett konstnärligt uttryck. I beskrivningen går det att ange referensens nummer och ett visst objekt i den för att knyta bildmaterialet till rätt del av handlingen. Det är särskilt användbart när delar från flera bilder ska förenas i en komposition.
Till skillnad från läget med en startbildruta fungerar referenserna här som stöd för den nya scenens innehåll. Textinstruktionen är obligatorisk: den kopplar objektens utseende till handlingen, kamerarörelserna och den övergripande iscensättningen. Tillverkaren framhåller visuell sammanhållning och filmiska rörelser. Resultatet är fortfarande genererat material, inte ett montage av ursprungsbilderna.
JPEG, JPG, PNG och WEBP accepteras med en storlek på högst 20 MB per fil. Bildens kortsida måste vara minst 400 pixlar. Material på nivån 720P eller högre rekommenderas. Indata i det här läget består just av bilder och text.
Resultatet sparas i MP4 med 24 bildrutor per sekund. Längden anges som ett heltal från 3 till 15 sekunder. Upplösningen kan väljas mellan 480P, 720P och 1080P. Generering av ljud stöds.
Liggande, stående och kvadratiska bilder finns tillgängliga: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 och 21:9. Valet av format hjälper till att i förväg bestämma den nya scenens utrymme för komposition.
Texten kan vara på vilket språk som helst. Gränsen är 5000 icke-kinesiska eller 2500 kinesiska tecken, och den överskjutande delen tas bort. Referensernas viktigaste roller, handlingen och rörelserna måste rymmas inom detta. Ett inledande slumpfrö kan styra hur lika varianterna blir, men garanterar inte en exakt upprepning av en video.
", "aboutText": "HappyHorse-1.1-R2V skapar en ny videoscen utifrån referensbilder och en textinstruktion. Alibaba har inriktat modellen på att bevara igenkännbara karaktärer, objekt och visuell stil när rörelser genereras. Referenserna anger scenens innehåll och utseende, medan texten beskriver hur delarna ska samverka.\n\n### Referensbildernas roller\n\nFrån en till nio bilder kan användas. De kan ange en karaktär, ett föremål, en omgivning eller ett konstnärligt uttryck. I beskrivningen går det att ange referensens nummer och ett visst objekt i den för att knyta bildmaterialet till rätt del av handlingen. Det är särskilt användbart när delar från flera bilder ska förenas i en komposition.\n\nTill skillnad från läget med en startbildruta fungerar referenserna här som stöd för den nya scenens innehåll. Textinstruktionen är obligatorisk: den kopplar objektens utseende till handlingen, kamerarörelserna och den övergripande iscensättningen. Tillverkaren framhåller visuell sammanhållning och filmiska rörelser. Resultatet är fortfarande genererat material, inte ett montage av ursprungsbilderna.\n\nJPEG, JPG, PNG och WEBP accepteras med en storlek på högst 20 MB per fil. Bildens kortsida måste vara minst 400 pixlar. Material på nivån 720P eller högre rekommenderas. Indata i det här läget består just av bilder och text.\n\n### Längd, bild och ljud\n\nResultatet sparas i MP4 med 24 bildrutor per sekund. Längden anges som ett heltal från 3 till 15 sekunder. Upplösningen kan väljas mellan 480P, 720P och 1080P. Generering av ljud stöds.\n\nLiggande, stående och kvadratiska bilder finns tillgängliga: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 och 21:9. Valet av format hjälper till att i förväg bestämma den nya scenens utrymme för komposition.\n\nTexten kan vara på vilket språk som helst. Gränsen är 5000 icke-kinesiska eller 2500 kinesiska tecken, och den överskjutande delen tas bort. Referensernas viktigaste roller, handlingen och rörelserna måste rymmas inom detta. Ett inledande slumpfrö kan styra hur lika varianterna blir, men garanterar inte en exakt upprepning av en video.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "b246715d76135e4600106ae4aad1b82f2e09f8baa3702adbd24646bbeb54d319", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "sv", "methods": [ { "html": "happyhorse-1.1-r2vModell för videogenerering utifrån referensbilder och ett textbaserat manus. Hjälper till att bevara karaktärers och föremåls utseende samt den visuella stilen i en ny scen.
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
HappyHorse-1.1-R2V skapar en ny videoscen utifrån referensbilder och en textinstruktion. Alibaba har inriktat modellen på att bevara igenkännbara karaktärer, objekt och visuell stil när rörelser genereras. Referenserna anger scenens innehåll och utseende, medan texten beskriver hur delarna ska samverka.
Från en till nio bilder kan användas. De kan ange en karaktär, ett föremål, en omgivning eller ett konstnärligt uttryck. I beskrivningen går det att ange referensens nummer och ett visst objekt i den för att knyta bildmaterialet till rätt del av handlingen. Det är särskilt användbart när delar från flera bilder ska förenas i en komposition.
Till skillnad från läget med en startbildruta fungerar referenserna här som stöd för den nya scenens innehåll. Textinstruktionen är obligatorisk: den kopplar objektens utseende till handlingen, kamerarörelserna och den övergripande iscensättningen. Tillverkaren framhåller visuell sammanhållning och filmiska rörelser. Resultatet är fortfarande genererat material, inte ett montage av ursprungsbilderna.
JPEG, JPG, PNG och WEBP accepteras med en storlek på högst 20 MB per fil. Bildens kortsida måste vara minst 400 pixlar. Material på nivån 720P eller högre rekommenderas. Indata i det här läget består just av bilder och text.
Resultatet sparas i MP4 med 24 bildrutor per sekund. Längden anges som ett heltal från 3 till 15 sekunder. Upplösningen kan väljas mellan 480P, 720P och 1080P. Generering av ljud stöds.
Liggande, stående och kvadratiska bilder finns tillgängliga: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 och 21:9. Valet av format hjälper till att i förväg bestämma den nya scenens utrymme för komposition.
Texten kan vara på vilket språk som helst. Gränsen är 5000 icke-kinesiska eller 2500 kinesiska tecken, och den överskjutande delen tas bort. Referensernas viktigaste roller, handlingen och rörelserna måste rymmas inom detta. Ett inledande slumpfrö kan styra hur lika varianterna blir, men garanterar inte en exakt upprepning av en video.
POST /v1/videos/generationstext, imagevideo| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser happyhorse-1.1-r2v | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser Minsta längd: 1 | Standard— |
Fältduration | Typinteger | KravValfritt | Värden & gränser Minimum: 3 Maximum: 15 Enhet: sekunder | Standard5 |
Fältresolution | Typstring | KravValfritt | Värden & gränser 480P, 720P, 1080P | Standard720P |
Fältratio | Typstring | KravValfritt | Värden & gränser 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Standard16:9 |
Fältimage_urls | Typhttps_url|data_image_url[] | KravObligatoriskt | Värden & gränser Minsta antal objekt: 1 Maximalt antal objekt: 9 Maximalt antal avkodade byte: 20 971 520 MIME-typer: image/jpeg, image/png, image/webp | Standard— |
reference_images_to_video · Krävs: prompt, image_urls
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, prompt, image_urls |
Parametermaterial_types | Avtaltext, image |
Parameteroptional | Avtalduration, resolution, ratio |
Parameterduration_integer_range | Avtal3, 15 |
Parameterdefault_duration | Avtal5 |
Parameterresolution | Avtal480P, 720P, 1080P |
Parameterdefault_resolution | Avtal720P |
Parameterratio | Avtal16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 |
Parameterratio_must_omit | Avtalfalse |
Parameterimage_urls | Avtal{"min_count":1,"max_count":9,"schemes":["https","data för rasterbild i base64"],"max_data_image_bytes":20971520} |
Livscykel: 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
Metodernas strukturer och ID:n är exakta; leverantörens funktioner är åtskilda från att begäran tillåts.
POST /v1/videos/generationsAiloot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
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\nSpara varje färdig video eller returnerad fil; hämta varje faktiskt returnerad resurs-URL.
Bevara varje returnerad datapost och utdataindex. content_url avser endast det första; hämta varje faktisk innehållssökväg och tillgång. GET av innehåll utan index omfattar inte alla resultat.
Läs det befintliga ursprungliga jobbet; skicka aldrig en oklar sändning igen.
| Fält | Typ |
|---|---|
Fältid | Typstring |
Fältobject | Typstring |
Fältmodel | Typstring |
Fältstatus | Typstring |
Fältcontent_url | Typsigned URL |
Fältdata[] | Typsigned URL |
Fältusage | Typobject |
Fältresult_pending_check | Typboolean |
| Svar | Villkor | Nästa steg |
|---|---|---|
Svar400 · invalid_request_error | VillkorOgiltiga obligatoriska fält, ogiltig representation av underlaget eller ogiltigt parametervärde | Nästa stegKorrigera de angivna fälten före en ny begäran om att skapa. |
Svar409 · video_not_ready | VillkorDet ursprungliga resultatinnehållet är ännu inte tillgängligt | Nästa stegKontrollera det ursprungliga returnerade ID:t och följ Retry-After. |
Svarserver_error | VillkorDet returnerade svaret anger att operationen eller resultatet behöver kontrolleras | Nästa stegSpara det ursprungliga operations- eller uppgifts-ID som returnerades, förfrågans headers och svaret. Fortsätt att läsa den ursprungliga operationen med de läsmetoder som stöds. Skicka inte skapandeförfrågan igen. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Använd metodsökvägarna som visas ovan.
happyhorse-r2vModell för videogenerering utifrån referensbilder och ett textbaserat manus. Hjälper till att bevara karaktärers och föremåls utseende samt den visuella stilen i en ny scen.
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
HappyHorse-1.1-R2V skapar en ny videoscen utifrån referensbilder och en textinstruktion. Alibaba har inriktat modellen på att bevara igenkännbara karaktärer, objekt och visuell stil när rörelser genereras. Referenserna anger scenens innehåll och utseende, medan texten beskriver hur delarna ska samverka.
Från en till nio bilder kan användas. De kan ange en karaktär, ett föremål, en omgivning eller ett konstnärligt uttryck. I beskrivningen går det att ange referensens nummer och ett visst objekt i den för att knyta bildmaterialet till rätt del av handlingen. Det är särskilt användbart när delar från flera bilder ska förenas i en komposition.
Till skillnad från läget med en startbildruta fungerar referenserna här som stöd för den nya scenens innehåll. Textinstruktionen är obligatorisk: den kopplar objektens utseende till handlingen, kamerarörelserna och den övergripande iscensättningen. Tillverkaren framhåller visuell sammanhållning och filmiska rörelser. Resultatet är fortfarande genererat material, inte ett montage av ursprungsbilderna.
JPEG, JPG, PNG och WEBP accepteras med en storlek på högst 20 MB per fil. Bildens kortsida måste vara minst 400 pixlar. Material på nivån 720P eller högre rekommenderas. Indata i det här läget består just av bilder och text.
Resultatet sparas i MP4 med 24 bildrutor per sekund. Längden anges som ett heltal från 3 till 15 sekunder. Upplösningen kan väljas mellan 480P, 720P och 1080P. Generering av ljud stöds.
Liggande, stående och kvadratiska bilder finns tillgängliga: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 och 21:9. Valet av format hjälper till att i förväg bestämma den nya scenens utrymme för komposition.
Texten kan vara på vilket språk som helst. Gränsen är 5000 icke-kinesiska eller 2500 kinesiska tecken, och den överskjutande delen tas bort. Referensernas viktigaste roller, handlingen och rörelserna måste rymmas inom detta. Ett inledande slumpfrö kan styra hur lika varianterna blir, men garanterar inte en exakt upprepning av en video.
POST /v1/videos/generationstext, imagevideo| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser happyhorse-r2v | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser Minsta längd: 1 | Standard— |
Fältduration | Typinteger | KravValfritt | Värden & gränser Minimum: 3 Maximum: 15 Enhet: sekunder | Standard5 |
Fältresolution | Typstring | KravValfritt | Värden & gränser 480P, 720P, 1080P | Standard720P |
Fältratio | Typstring | KravValfritt | Värden & gränser 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Standard16:9 |
Fältimage_urls | Typhttps_url|data_image_url[] | KravObligatoriskt | Värden & gränser Minsta antal objekt: 1 Maximalt antal objekt: 9 Maximalt antal avkodade byte: 20 971 520 MIME-typer: image/jpeg, image/png, image/webp | Standard— |
reference_images_to_video · Krävs: prompt, image_urls
| Parameter | Avtal |
|---|---|
Parametermaterial_types | Avtaltext, image |
Parameterrequired | Avtalnull |
Parameteroptional_controls | Avtalnull |
Livscykel: 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
Metodernas strukturer och ID:n är exakta; leverantörens funktioner är åtskilda från att begäran tillåts.
POST /v1/videos/generationsAiloot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
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\nSpara varje färdig video eller returnerad fil; hämta varje faktiskt returnerad resurs-URL.
Bevara varje returnerad datapost och utdataindex. content_url avser endast det första; hämta varje faktisk innehållssökväg och tillgång. GET av innehåll utan index omfattar inte alla resultat.
Läs det befintliga ursprungliga jobbet; skicka aldrig en oklar sändning igen.
| Fält | Typ |
|---|---|
Fältid | Typstring |
Fältobject | Typstring |
Fältmodel | Typstring |
Fältstatus | Typstring |
Fältcontent_url | Typsigned URL |
Fältdata[] | Typsigned URL |
Fältusage | Typobject |
Fältresult_pending_check | Typboolean |
| Svar | Villkor | Nästa steg |
|---|---|---|
Svar400 · invalid_request_error | VillkorOgiltiga obligatoriska fält, ogiltig representation av underlaget eller ogiltigt parametervärde | Nästa stegKorrigera de angivna fälten före en ny begäran om att skapa. |
Svar409 · video_not_ready | VillkorDet ursprungliga resultatinnehållet är ännu inte tillgängligt | Nästa stegKontrollera det ursprungliga returnerade ID:t och följ Retry-After. |
Svarserver_error | VillkorDet returnerade svaret anger att operationen eller resultatet behöver kontrolleras | Nästa stegSpara det ursprungliga operations- eller uppgifts-ID som returnerades, förfrågans headers och svaret. Fortsätt att läsa den ursprungliga operationen med de läsmetoder som stöds. Skicka inte skapandeförfrågan igen. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Använd metodsökvägarna som visas ovan.
happyhorse-r2v-latestModell för videogenerering utifrån referensbilder och ett textbaserat manus. Hjälper till att bevara karaktärers och föremåls utseende samt den visuella stilen i en ny scen.
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
HappyHorse-1.1-R2V skapar en ny videoscen utifrån referensbilder och en textinstruktion. Alibaba har inriktat modellen på att bevara igenkännbara karaktärer, objekt och visuell stil när rörelser genereras. Referenserna anger scenens innehåll och utseende, medan texten beskriver hur delarna ska samverka.
Från en till nio bilder kan användas. De kan ange en karaktär, ett föremål, en omgivning eller ett konstnärligt uttryck. I beskrivningen går det att ange referensens nummer och ett visst objekt i den för att knyta bildmaterialet till rätt del av handlingen. Det är särskilt användbart när delar från flera bilder ska förenas i en komposition.
Till skillnad från läget med en startbildruta fungerar referenserna här som stöd för den nya scenens innehåll. Textinstruktionen är obligatorisk: den kopplar objektens utseende till handlingen, kamerarörelserna och den övergripande iscensättningen. Tillverkaren framhåller visuell sammanhållning och filmiska rörelser. Resultatet är fortfarande genererat material, inte ett montage av ursprungsbilderna.
JPEG, JPG, PNG och WEBP accepteras med en storlek på högst 20 MB per fil. Bildens kortsida måste vara minst 400 pixlar. Material på nivån 720P eller högre rekommenderas. Indata i det här läget består just av bilder och text.
Resultatet sparas i MP4 med 24 bildrutor per sekund. Längden anges som ett heltal från 3 till 15 sekunder. Upplösningen kan väljas mellan 480P, 720P och 1080P. Generering av ljud stöds.
Liggande, stående och kvadratiska bilder finns tillgängliga: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 och 21:9. Valet av format hjälper till att i förväg bestämma den nya scenens utrymme för komposition.
Texten kan vara på vilket språk som helst. Gränsen är 5000 icke-kinesiska eller 2500 kinesiska tecken, och den överskjutande delen tas bort. Referensernas viktigaste roller, handlingen och rörelserna måste rymmas inom detta. Ett inledande slumpfrö kan styra hur lika varianterna blir, men garanterar inte en exakt upprepning av en video.
POST /v1/videos/generationstext, imagevideo| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser happyhorse-r2v-latest | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser Minsta längd: 1 | Standard— |
Fältduration | Typinteger | KravValfritt | Värden & gränser Minimum: 3 Maximum: 15 Enhet: sekunder | Standard5 |
Fältresolution | Typstring | KravValfritt | Värden & gränser 480P, 720P, 1080P | Standard720P |
Fältratio | Typstring | KravValfritt | Värden & gränser 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Standard16:9 |
Fältimage_urls | Typhttps_url|data_image_url[] | KravObligatoriskt | Värden & gränser Minsta antal objekt: 1 Maximalt antal objekt: 9 Maximalt antal avkodade byte: 20 971 520 MIME-typer: image/jpeg, image/png, image/webp | Standard— |
reference_images_to_video · Krävs: prompt, image_urls
| Parameter | Avtal |
|---|---|
Parametermaterial_types | Avtaltext, image |
Parameterrequired | Avtalnull |
Parameteroptional_controls | Avtalnull |
Livscykel: 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
Metodernas strukturer och ID:n är exakta; leverantörens funktioner är åtskilda från att begäran tillåts.
POST /v1/videos/generationsAiloot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
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\nSpara varje färdig video eller returnerad fil; hämta varje faktiskt returnerad resurs-URL.
Bevara varje returnerad datapost och utdataindex. content_url avser endast det första; hämta varje faktisk innehållssökväg och tillgång. GET av innehåll utan index omfattar inte alla resultat.
Läs det befintliga ursprungliga jobbet; skicka aldrig en oklar sändning igen.
| Fält | Typ |
|---|---|
Fältid | Typstring |
Fältobject | Typstring |
Fältmodel | Typstring |
Fältstatus | Typstring |
Fältcontent_url | Typsigned URL |
Fältdata[] | Typsigned URL |
Fältusage | Typobject |
Fältresult_pending_check | Typboolean |
| Svar | Villkor | Nästa steg |
|---|---|---|
Svar400 · invalid_request_error | VillkorOgiltiga obligatoriska fält, ogiltig representation av underlaget eller ogiltigt parametervärde | Nästa stegKorrigera de angivna fälten före en ny begäran om att skapa. |
Svar409 · video_not_ready | VillkorDet ursprungliga resultatinnehållet är ännu inte tillgängligt | Nästa stegKontrollera det ursprungliga returnerade ID:t och följ Retry-After. |
Svarserver_error | VillkorDet returnerade svaret anger att operationen eller resultatet behöver kontrolleras | Nästa stegSpara det ursprungliga operations- eller uppgifts-ID som returnerades, förfrågans headers och svaret. Fortsätt att läsa den ursprungliga operationen med de läsmetoder som stöds. Skicka inte skapandeförfrågan igen. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Använd metodsökvägarna som visas ovan.