HappyHorse-1.1-R2V menghasilkan adegan video baharu daripada imej rujukan dan arahan teks. Alibaba menumpukan model ini pada pengekalan watak yang dapat dikenali, objek dan gaya visual ketika menjana pergerakan. Rujukan menentukan kandungan dan rupa adegan, manakala teks menerangkan cara unsur-unsur ini perlu berinteraksi.
Satu hingga sembilan imej boleh digunakan. Imej-imej itu boleh menentukan watak, objek, persekitaran atau gaya artistik. Dalam penerangan, nombor rujukan dan objek tertentu di dalamnya boleh disebut untuk mengaitkan bahan visual dengan bahagian tindakan yang dikehendaki. Ini amat berguna apabila unsur daripada beberapa imej perlu digabungkan dalam satu komposisi.
Berbeza daripada mod bingkai awal, rujukan di sini menjadi panduan kandungan adegan baharu. Arahan teks wajib diberikan: arahan itu menghubungkan rupa objek dengan tindakan, pergerakan kamera dan penyusunan keseluruhan adegan. Pengeluar menekankan keselarasan visual dan pergerakan sinematik; hasilnya tetap berupa penjanaan, bukannya penyuntingan imej asal menjadi montaj.
JPEG, JPG, PNG dan WEBP dengan saiz sehingga 20 MB setiap satu diterima. Sisi pendek imej mesti sekurang-kurangnya 400 piksel; bahan pada tahap 720P atau lebih tinggi disyorkan. Input mod ini terdiri khusus daripada imej dan teks.
Hasil disimpan dalam MP4 pada kadar 24 bingkai sesaat. Tempoh ditetapkan sebagai nombor bulat dari 3 hingga 15 saat. Resolusi boleh dipilih antara 480P, 720P dan 1080P; penjanaan iringan audio disokong.
Bingkai mendatar, menegak dan segi empat sama tersedia: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 dan 21:9. Pemilihan format membantu menentukan ruang komposisi adegan baharu terlebih dahulu.
Teks boleh menggunakan apa-apa bahasa. Hadnya ialah 5000 aksara bukan Cina atau 2500 aksara Cina; bahagian berlebihan dipotong. Peranan rujukan, tindakan dan pergerakan yang paling penting mesti dimuatkan dalam had ini. Nilai benih rawak awal boleh membantu menghasilkan variasi yang serupa, tetapi tidak menjamin penghasilan semula klip yang sama secara tepat.
", "aboutText": "HappyHorse-1.1-R2V menghasilkan adegan video baharu daripada imej rujukan dan arahan teks. Alibaba menumpukan model ini pada pengekalan watak yang dapat dikenali, objek dan gaya visual ketika menjana pergerakan. Rujukan menentukan kandungan dan rupa adegan, manakala teks menerangkan cara unsur-unsur ini perlu berinteraksi.\n\n### Peranan contoh visual\n\nSatu hingga sembilan imej boleh digunakan. Imej-imej itu boleh menentukan watak, objek, persekitaran atau gaya artistik. Dalam penerangan, nombor rujukan dan objek tertentu di dalamnya boleh disebut untuk mengaitkan bahan visual dengan bahagian tindakan yang dikehendaki. Ini amat berguna apabila unsur daripada beberapa imej perlu digabungkan dalam satu komposisi.\n\nBerbeza daripada mod bingkai awal, rujukan di sini menjadi panduan kandungan adegan baharu. Arahan teks wajib diberikan: arahan itu menghubungkan rupa objek dengan tindakan, pergerakan kamera dan penyusunan keseluruhan adegan. Pengeluar menekankan keselarasan visual dan pergerakan sinematik; hasilnya tetap berupa penjanaan, bukannya penyuntingan imej asal menjadi montaj.\n\nJPEG, JPG, PNG dan WEBP dengan saiz sehingga 20 MB setiap satu diterima. Sisi pendek imej mesti sekurang-kurangnya 400 piksel; bahan pada tahap 720P atau lebih tinggi disyorkan. Input mod ini terdiri khusus daripada imej dan teks.\n\n### Tempoh, bingkai dan audio\n\nHasil disimpan dalam MP4 pada kadar 24 bingkai sesaat. Tempoh ditetapkan sebagai nombor bulat dari 3 hingga 15 saat. Resolusi boleh dipilih antara 480P, 720P dan 1080P; penjanaan iringan audio disokong.\n\nBingkai mendatar, menegak dan segi empat sama tersedia: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 dan 21:9. Pemilihan format membantu menentukan ruang komposisi adegan baharu terlebih dahulu.\n\nTeks boleh menggunakan apa-apa bahasa. Hadnya ialah 5000 aksara bukan Cina atau 2500 aksara Cina; bahagian berlebihan dipotong. Peranan rujukan, tindakan dan pergerakan yang paling penting mesti dimuatkan dalam had ini. Nilai benih rawak awal boleh membantu menghasilkan variasi yang serupa, tetapi tidak menjamin penghasilan semula klip yang sama secara tepat.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "a17270ee9ce1b16be81e2a210fa963ff55411d639f411d3b1de617e9cb81045b", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ms", "methods": [ { "html": "happyhorse-1.1-r2vModel penjanaan video daripada imej rujukan dan skrip teks. Membantu mengekalkan rupa watak, objek dan gaya visual dalam adegan baharu.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
HappyHorse-1.1-R2V menghasilkan adegan video baharu daripada imej rujukan dan arahan teks. Alibaba menumpukan model ini pada pengekalan watak yang dapat dikenali, objek dan gaya visual ketika menjana pergerakan. Rujukan menentukan kandungan dan rupa adegan, manakala teks menerangkan cara unsur-unsur ini perlu berinteraksi.
Satu hingga sembilan imej boleh digunakan. Imej-imej itu boleh menentukan watak, objek, persekitaran atau gaya artistik. Dalam penerangan, nombor rujukan dan objek tertentu di dalamnya boleh disebut untuk mengaitkan bahan visual dengan bahagian tindakan yang dikehendaki. Ini amat berguna apabila unsur daripada beberapa imej perlu digabungkan dalam satu komposisi.
Berbeza daripada mod bingkai awal, rujukan di sini menjadi panduan kandungan adegan baharu. Arahan teks wajib diberikan: arahan itu menghubungkan rupa objek dengan tindakan, pergerakan kamera dan penyusunan keseluruhan adegan. Pengeluar menekankan keselarasan visual dan pergerakan sinematik; hasilnya tetap berupa penjanaan, bukannya penyuntingan imej asal menjadi montaj.
JPEG, JPG, PNG dan WEBP dengan saiz sehingga 20 MB setiap satu diterima. Sisi pendek imej mesti sekurang-kurangnya 400 piksel; bahan pada tahap 720P atau lebih tinggi disyorkan. Input mod ini terdiri khusus daripada imej dan teks.
Hasil disimpan dalam MP4 pada kadar 24 bingkai sesaat. Tempoh ditetapkan sebagai nombor bulat dari 3 hingga 15 saat. Resolusi boleh dipilih antara 480P, 720P dan 1080P; penjanaan iringan audio disokong.
Bingkai mendatar, menegak dan segi empat sama tersedia: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 dan 21:9. Pemilihan format membantu menentukan ruang komposisi adegan baharu terlebih dahulu.
Teks boleh menggunakan apa-apa bahasa. Hadnya ialah 5000 aksara bukan Cina atau 2500 aksara Cina; bahagian berlebihan dipotong. Peranan rujukan, tindakan dan pergerakan yang paling penting mesti dimuatkan dalam had ini. Nilai benih rawak awal boleh membantu menghasilkan variasi yang serupa, tetapi tidak menjamin penghasilan semula klip yang sama secara tepat.
POST /v1/videos/generationstext, imagevideo| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had happyhorse-1.1-r2v | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had Panjang minimum: 1 | Lalai— |
Medanduration | Jenisinteger | KeperluanPilihan | Nilai & had Minimum: 3 Maksimum: 15 Unit: saat | Lalai5 |
Medanresolution | Jenisstring | KeperluanPilihan | Nilai & had 480P, 720P, 1080P | Lalai720P |
Medanratio | Jenisstring | KeperluanPilihan | Nilai & had 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Lalai16:9 |
Medanimage_urls | Jenishttps_url|data_image_url[] | KeperluanDiperlukan | Nilai & had Item minimum: 1 Item maksimum: 9 Bait ternyahkod maksimum: 20,971,520 Jenis MIME: image/jpeg, image/png, image/webp | Lalai— |
reference_images_to_video · Diperlukan: prompt, image_urls
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt, image_urls |
Parametermaterial_types | Kontraktext, image |
Parameteroptional | Kontrakduration, resolution, ratio |
Parameterduration_integer_range | Kontrak3, 15 |
Parameterdefault_duration | Kontrak5 |
Parameterresolution | Kontrak480P, 720P, 1080P |
Parameterdefault_resolution | Kontrak720P |
Parameterratio | Kontrak16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 |
Parameterratio_must_omit | Kontrakfalse |
Parameterimage_urls | Kontrak{"min_count":1,"max_count":9,"schemes":["https","data raster dalam base64"],"max_data_image_bytes":20971520} |
Kitar hayat: 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
Struktur kaedah dan ID adalah tepat; keupayaan pembekal berasingan daripada penerimaan permintaan.
POST /v1/videos/generationsAiloot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →
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\nSimpan setiap video yang selesai atau fail yang dikembalikan; dapatkan setiap URL aset yang benar-benar dikembalikan.
Kekalkan setiap item data/indeks output yang dikembalikan. content_url hanya merujuk yang pertama; dapatkan setiap laluan kandungan/aset sebenar. GET kandungan tanpa index tidak merangkumi semua output.
Baca tugas asal yang sedia ada; jangan sekali-kali hantar semula penghantaran yang tidak diketahui hasilnya.
| Medan | Jenis |
|---|---|
Medanid | Jenisstring |
Medanobject | Jenisstring |
Medanmodel | Jenisstring |
Medanstatus | Jenisstring |
Medancontent_url | Jenissigned URL |
Medandata[] | Jenissigned URL |
Medanusage | Jenisobject |
Medanresult_pending_check | Jenisboolean |
| Respons | Syarat | Langkah seterusnya |
|---|---|---|
Respons400 · invalid_request_error | SyaratMedan wajib, perwakilan bahan atau nilai parameter tidak sah | Langkah seterusnyaBetulkan medan yang ditunjukkan sebelum permintaan penciptaan baharu. |
Respons409 · video_not_ready | SyaratKandungan hasil asal belum tersedia | Langkah seterusnyaSemak ID asal yang dikembalikan secara berkala dan patuhi Retry-After. |
Responsserver_error | SyaratRespons yang dikembalikan menyatakan bahawa operasi atau hasil memerlukan semakan | Langkah seterusnyaSimpan ID operasi/tugas asal yang dikembalikan, pengepala permintaan dan respons; teruskan pembacaan yang disokong bagi operasi asal tersebut. Jangan hantar semula permintaan penciptaan. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Gunakan laluan kaedah yang dipaparkan di atas.
happyhorse-r2vModel penjanaan video daripada imej rujukan dan skrip teks. Membantu mengekalkan rupa watak, objek dan gaya visual dalam adegan baharu.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
HappyHorse-1.1-R2V menghasilkan adegan video baharu daripada imej rujukan dan arahan teks. Alibaba menumpukan model ini pada pengekalan watak yang dapat dikenali, objek dan gaya visual ketika menjana pergerakan. Rujukan menentukan kandungan dan rupa adegan, manakala teks menerangkan cara unsur-unsur ini perlu berinteraksi.
Satu hingga sembilan imej boleh digunakan. Imej-imej itu boleh menentukan watak, objek, persekitaran atau gaya artistik. Dalam penerangan, nombor rujukan dan objek tertentu di dalamnya boleh disebut untuk mengaitkan bahan visual dengan bahagian tindakan yang dikehendaki. Ini amat berguna apabila unsur daripada beberapa imej perlu digabungkan dalam satu komposisi.
Berbeza daripada mod bingkai awal, rujukan di sini menjadi panduan kandungan adegan baharu. Arahan teks wajib diberikan: arahan itu menghubungkan rupa objek dengan tindakan, pergerakan kamera dan penyusunan keseluruhan adegan. Pengeluar menekankan keselarasan visual dan pergerakan sinematik; hasilnya tetap berupa penjanaan, bukannya penyuntingan imej asal menjadi montaj.
JPEG, JPG, PNG dan WEBP dengan saiz sehingga 20 MB setiap satu diterima. Sisi pendek imej mesti sekurang-kurangnya 400 piksel; bahan pada tahap 720P atau lebih tinggi disyorkan. Input mod ini terdiri khusus daripada imej dan teks.
Hasil disimpan dalam MP4 pada kadar 24 bingkai sesaat. Tempoh ditetapkan sebagai nombor bulat dari 3 hingga 15 saat. Resolusi boleh dipilih antara 480P, 720P dan 1080P; penjanaan iringan audio disokong.
Bingkai mendatar, menegak dan segi empat sama tersedia: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 dan 21:9. Pemilihan format membantu menentukan ruang komposisi adegan baharu terlebih dahulu.
Teks boleh menggunakan apa-apa bahasa. Hadnya ialah 5000 aksara bukan Cina atau 2500 aksara Cina; bahagian berlebihan dipotong. Peranan rujukan, tindakan dan pergerakan yang paling penting mesti dimuatkan dalam had ini. Nilai benih rawak awal boleh membantu menghasilkan variasi yang serupa, tetapi tidak menjamin penghasilan semula klip yang sama secara tepat.
POST /v1/videos/generationstext, imagevideo| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had happyhorse-r2v | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had Panjang minimum: 1 | Lalai— |
Medanduration | Jenisinteger | KeperluanPilihan | Nilai & had Minimum: 3 Maksimum: 15 Unit: saat | Lalai5 |
Medanresolution | Jenisstring | KeperluanPilihan | Nilai & had 480P, 720P, 1080P | Lalai720P |
Medanratio | Jenisstring | KeperluanPilihan | Nilai & had 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Lalai16:9 |
Medanimage_urls | Jenishttps_url|data_image_url[] | KeperluanDiperlukan | Nilai & had Item minimum: 1 Item maksimum: 9 Bait ternyahkod maksimum: 20,971,520 Jenis MIME: image/jpeg, image/png, image/webp | Lalai— |
reference_images_to_video · Diperlukan: prompt, image_urls
| Parameter | Kontrak |
|---|---|
Parametermaterial_types | Kontraktext, image |
Parameterrequired | Kontraknull |
Parameteroptional_controls | Kontraknull |
Kitar hayat: 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
Struktur kaedah dan ID adalah tepat; keupayaan pembekal berasingan daripada penerimaan permintaan.
POST /v1/videos/generationsAiloot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →
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\nSimpan setiap video yang selesai atau fail yang dikembalikan; dapatkan setiap URL aset yang benar-benar dikembalikan.
Kekalkan setiap item data/indeks output yang dikembalikan. content_url hanya merujuk yang pertama; dapatkan setiap laluan kandungan/aset sebenar. GET kandungan tanpa index tidak merangkumi semua output.
Baca tugas asal yang sedia ada; jangan sekali-kali hantar semula penghantaran yang tidak diketahui hasilnya.
| Medan | Jenis |
|---|---|
Medanid | Jenisstring |
Medanobject | Jenisstring |
Medanmodel | Jenisstring |
Medanstatus | Jenisstring |
Medancontent_url | Jenissigned URL |
Medandata[] | Jenissigned URL |
Medanusage | Jenisobject |
Medanresult_pending_check | Jenisboolean |
| Respons | Syarat | Langkah seterusnya |
|---|---|---|
Respons400 · invalid_request_error | SyaratMedan wajib, perwakilan bahan atau nilai parameter tidak sah | Langkah seterusnyaBetulkan medan yang ditunjukkan sebelum permintaan penciptaan baharu. |
Respons409 · video_not_ready | SyaratKandungan hasil asal belum tersedia | Langkah seterusnyaSemak ID asal yang dikembalikan secara berkala dan patuhi Retry-After. |
Responsserver_error | SyaratRespons yang dikembalikan menyatakan bahawa operasi atau hasil memerlukan semakan | Langkah seterusnyaSimpan ID operasi/tugas asal yang dikembalikan, pengepala permintaan dan respons; teruskan pembacaan yang disokong bagi operasi asal tersebut. Jangan hantar semula permintaan penciptaan. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Gunakan laluan kaedah yang dipaparkan di atas.
happyhorse-r2v-latestModel penjanaan video daripada imej rujukan dan skrip teks. Membantu mengekalkan rupa watak, objek dan gaya visual dalam adegan baharu.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
HappyHorse-1.1-R2V menghasilkan adegan video baharu daripada imej rujukan dan arahan teks. Alibaba menumpukan model ini pada pengekalan watak yang dapat dikenali, objek dan gaya visual ketika menjana pergerakan. Rujukan menentukan kandungan dan rupa adegan, manakala teks menerangkan cara unsur-unsur ini perlu berinteraksi.
Satu hingga sembilan imej boleh digunakan. Imej-imej itu boleh menentukan watak, objek, persekitaran atau gaya artistik. Dalam penerangan, nombor rujukan dan objek tertentu di dalamnya boleh disebut untuk mengaitkan bahan visual dengan bahagian tindakan yang dikehendaki. Ini amat berguna apabila unsur daripada beberapa imej perlu digabungkan dalam satu komposisi.
Berbeza daripada mod bingkai awal, rujukan di sini menjadi panduan kandungan adegan baharu. Arahan teks wajib diberikan: arahan itu menghubungkan rupa objek dengan tindakan, pergerakan kamera dan penyusunan keseluruhan adegan. Pengeluar menekankan keselarasan visual dan pergerakan sinematik; hasilnya tetap berupa penjanaan, bukannya penyuntingan imej asal menjadi montaj.
JPEG, JPG, PNG dan WEBP dengan saiz sehingga 20 MB setiap satu diterima. Sisi pendek imej mesti sekurang-kurangnya 400 piksel; bahan pada tahap 720P atau lebih tinggi disyorkan. Input mod ini terdiri khusus daripada imej dan teks.
Hasil disimpan dalam MP4 pada kadar 24 bingkai sesaat. Tempoh ditetapkan sebagai nombor bulat dari 3 hingga 15 saat. Resolusi boleh dipilih antara 480P, 720P dan 1080P; penjanaan iringan audio disokong.
Bingkai mendatar, menegak dan segi empat sama tersedia: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 dan 21:9. Pemilihan format membantu menentukan ruang komposisi adegan baharu terlebih dahulu.
Teks boleh menggunakan apa-apa bahasa. Hadnya ialah 5000 aksara bukan Cina atau 2500 aksara Cina; bahagian berlebihan dipotong. Peranan rujukan, tindakan dan pergerakan yang paling penting mesti dimuatkan dalam had ini. Nilai benih rawak awal boleh membantu menghasilkan variasi yang serupa, tetapi tidak menjamin penghasilan semula klip yang sama secara tepat.
POST /v1/videos/generationstext, imagevideo| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had happyhorse-r2v-latest | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had Panjang minimum: 1 | Lalai— |
Medanduration | Jenisinteger | KeperluanPilihan | Nilai & had Minimum: 3 Maksimum: 15 Unit: saat | Lalai5 |
Medanresolution | Jenisstring | KeperluanPilihan | Nilai & had 480P, 720P, 1080P | Lalai720P |
Medanratio | Jenisstring | KeperluanPilihan | Nilai & had 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Lalai16:9 |
Medanimage_urls | Jenishttps_url|data_image_url[] | KeperluanDiperlukan | Nilai & had Item minimum: 1 Item maksimum: 9 Bait ternyahkod maksimum: 20,971,520 Jenis MIME: image/jpeg, image/png, image/webp | Lalai— |
reference_images_to_video · Diperlukan: prompt, image_urls
| Parameter | Kontrak |
|---|---|
Parametermaterial_types | Kontraktext, image |
Parameterrequired | Kontraknull |
Parameteroptional_controls | Kontraknull |
Kitar hayat: 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
Struktur kaedah dan ID adalah tepat; keupayaan pembekal berasingan daripada penerimaan permintaan.
POST /v1/videos/generationsAiloot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →
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\nSimpan setiap video yang selesai atau fail yang dikembalikan; dapatkan setiap URL aset yang benar-benar dikembalikan.
Kekalkan setiap item data/indeks output yang dikembalikan. content_url hanya merujuk yang pertama; dapatkan setiap laluan kandungan/aset sebenar. GET kandungan tanpa index tidak merangkumi semua output.
Baca tugas asal yang sedia ada; jangan sekali-kali hantar semula penghantaran yang tidak diketahui hasilnya.
| Medan | Jenis |
|---|---|
Medanid | Jenisstring |
Medanobject | Jenisstring |
Medanmodel | Jenisstring |
Medanstatus | Jenisstring |
Medancontent_url | Jenissigned URL |
Medandata[] | Jenissigned URL |
Medanusage | Jenisobject |
Medanresult_pending_check | Jenisboolean |
| Respons | Syarat | Langkah seterusnya |
|---|---|---|
Respons400 · invalid_request_error | SyaratMedan wajib, perwakilan bahan atau nilai parameter tidak sah | Langkah seterusnyaBetulkan medan yang ditunjukkan sebelum permintaan penciptaan baharu. |
Respons409 · video_not_ready | SyaratKandungan hasil asal belum tersedia | Langkah seterusnyaSemak ID asal yang dikembalikan secara berkala dan patuhi Retry-After. |
Responsserver_error | SyaratRespons yang dikembalikan menyatakan bahawa operasi atau hasil memerlukan semakan | Langkah seterusnyaSimpan ID operasi/tugas asal yang dikembalikan, pengepala permintaan dan respons; teruskan pembacaan yang disokong bagi operasi asal tersebut. Jangan hantar semula permintaan penciptaan. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Gunakan laluan kaedah yang dipaparkan di atas.