HappyHorse-1.1-I2V ialah model Alibaba yang memulakan adegan video daripada imej sedia ada. Imej itu menjadi bingkai pertama, manakala teks boleh menentukan tindakan seterusnya: pergerakan watak, perubahan dalam adegan dan arah kamera. Ini sesuai untuk menghidupkan ilustrasi, foto produk atau konsep visual yang telah disediakan terlebih dahulu.
Penerangan teks tidak wajib. Jika tiada penerangan, model menentukan sendiri pergerakan yang mungkin berdasarkan kandungan imej awal. Apabila dinyatakan secara jelas, imej asal menentukan komposisi dan rupa objek, manakala kata-kata mengarahkan perkembangan adegan sepanjang masa.
Alibaba menekankan pengekalan rupa watak, keselarasan visual, kelancaran pergerakan serta gabungan imej dengan audio. Antara aspek yang dinyatakan juga ialah kestabilan tulisan dan tekstur. Ciri-ciri ini merujuk kepada reka bentuk model dan tidak bermakna setiap piksel dikekalkan secara harfiah dalam semua bingkai yang dijana.
Mod ini menggunakan satu imej awal. Imej itu menentukan adegan permulaan, bukannya satu set contoh bebas untuk komposisi baharu. Keupayaan menetapkan bingkai akhir yang berasingan tidak dinyatakan bagi versi khusus ini.
JPEG, JPG, PNG dan WEBP diterima. Setiap sisi imej input mesti sekurang-kurangnya 300 piksel; nisbah aspek yang dibenarkan ialah dari 1:2,5 hingga 2,5:1, dengan saiz fail sehingga 20 MB. Nisbah aspek video yang dihasilkan mengikut bingkai pertama.
Tempoh dipilih sebagai nombor bulat dari 3 hingga 15 saat. Tahap resolusi 480P, 720P dan 1080P tersedia; format output ialah MP4, dengan kadar 24 bingkai sesaat. Penjanaan iringan audio bersama video disokong.
Penerangan boleh menggunakan apa-apa bahasa dan mengandungi sehingga 5000 aksara bukan Cina atau 2500 aksara Cina. Jika had dilampaui, bahagian berlebihan dipotong, jadi tindakan penting dan ciri pergerakan perlu dirumuskan dalam had tugasan. Nilai benih rawak awal yang sama boleh menghasilkan klip yang serupa, tetapi tidak menjamin padanan setiap bingkai.
", "aboutText": "HappyHorse-1.1-I2V ialah model Alibaba yang memulakan adegan video daripada imej sedia ada. Imej itu menjadi bingkai pertama, manakala teks boleh menentukan tindakan seterusnya: pergerakan watak, perubahan dalam adegan dan arah kamera. Ini sesuai untuk menghidupkan ilustrasi, foto produk atau konsep visual yang telah disediakan terlebih dahulu.\n\nPenerangan teks tidak wajib. Jika tiada penerangan, model menentukan sendiri pergerakan yang mungkin berdasarkan kandungan imej awal. Apabila dinyatakan secara jelas, imej asal menentukan komposisi dan rupa objek, manakala kata-kata mengarahkan perkembangan adegan sepanjang masa.\n\n### Daripada bingkai pertama kepada pergerakan\n\nAlibaba menekankan pengekalan rupa watak, keselarasan visual, kelancaran pergerakan serta gabungan imej dengan audio. Antara aspek yang dinyatakan juga ialah kestabilan tulisan dan tekstur. Ciri-ciri ini merujuk kepada reka bentuk model dan tidak bermakna setiap piksel dikekalkan secara harfiah dalam semua bingkai yang dijana.\n\nMod ini menggunakan satu imej awal. Imej itu menentukan adegan permulaan, bukannya satu set contoh bebas untuk komposisi baharu. Keupayaan menetapkan bingkai akhir yang berasingan tidak dinyatakan bagi versi khusus ini.\n\nJPEG, JPG, PNG dan WEBP diterima. Setiap sisi imej input mesti sekurang-kurangnya 300 piksel; nisbah aspek yang dibenarkan ialah dari 1:2,5 hingga 2,5:1, dengan saiz fail sehingga 20 MB. Nisbah aspek video yang dihasilkan mengikut bingkai pertama.\n\n### Parameter klip\n\nTempoh dipilih sebagai nombor bulat dari 3 hingga 15 saat. Tahap resolusi 480P, 720P dan 1080P tersedia; format output ialah MP4, dengan kadar 24 bingkai sesaat. Penjanaan iringan audio bersama video disokong.\n\nPenerangan boleh menggunakan apa-apa bahasa dan mengandungi sehingga 5000 aksara bukan Cina atau 2500 aksara Cina. Jika had dilampaui, bahagian berlebihan dipotong, jadi tindakan penting dan ciri pergerakan perlu dirumuskan dalam had tugasan. Nilai benih rawak awal yang sama boleh menghasilkan klip yang serupa, tetapi tidak menjamin padanan setiap bingkai.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "9e48eca4c9dafbfbd9512fd194562160ddb2fa64f2607c23a9b2ccb4d935f080", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ms", "methods": [ { "html": "happyhorse-1.1-i2vModel yang menghidupkan imej: imej asal menentukan bingkai pertama, manakala penerangan mengarahkan pergerakan seterusnya. Menghasilkan klip video pendek dengan pilihan iringan audio.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
HappyHorse-1.1-I2V ialah model Alibaba yang memulakan adegan video daripada imej sedia ada. Imej itu menjadi bingkai pertama, manakala teks boleh menentukan tindakan seterusnya: pergerakan watak, perubahan dalam adegan dan arah kamera. Ini sesuai untuk menghidupkan ilustrasi, foto produk atau konsep visual yang telah disediakan terlebih dahulu.
Penerangan teks tidak wajib. Jika tiada penerangan, model menentukan sendiri pergerakan yang mungkin berdasarkan kandungan imej awal. Apabila dinyatakan secara jelas, imej asal menentukan komposisi dan rupa objek, manakala kata-kata mengarahkan perkembangan adegan sepanjang masa.
Alibaba menekankan pengekalan rupa watak, keselarasan visual, kelancaran pergerakan serta gabungan imej dengan audio. Antara aspek yang dinyatakan juga ialah kestabilan tulisan dan tekstur. Ciri-ciri ini merujuk kepada reka bentuk model dan tidak bermakna setiap piksel dikekalkan secara harfiah dalam semua bingkai yang dijana.
Mod ini menggunakan satu imej awal. Imej itu menentukan adegan permulaan, bukannya satu set contoh bebas untuk komposisi baharu. Keupayaan menetapkan bingkai akhir yang berasingan tidak dinyatakan bagi versi khusus ini.
JPEG, JPG, PNG dan WEBP diterima. Setiap sisi imej input mesti sekurang-kurangnya 300 piksel; nisbah aspek yang dibenarkan ialah dari 1:2,5 hingga 2,5:1, dengan saiz fail sehingga 20 MB. Nisbah aspek video yang dihasilkan mengikut bingkai pertama.
Tempoh dipilih sebagai nombor bulat dari 3 hingga 15 saat. Tahap resolusi 480P, 720P dan 1080P tersedia; format output ialah MP4, dengan kadar 24 bingkai sesaat. Penjanaan iringan audio bersama video disokong.
Penerangan boleh menggunakan apa-apa bahasa dan mengandungi sehingga 5000 aksara bukan Cina atau 2500 aksara Cina. Jika had dilampaui, bahagian berlebihan dipotong, jadi tindakan penting dan ciri pergerakan perlu dirumuskan dalam had tugasan. Nilai benih rawak awal yang sama boleh menghasilkan klip yang serupa, tetapi tidak menjamin padanan setiap bingkai.
POST /v1/videos/generationstext, imagevideo| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had happyhorse-1.1-i2v | Lalai— |
Medanprompt | Jenisstring | KeperluanPilihan | 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 | KeperluanTidak disokong | Nilai & had | Lalai— |
Medanimage_urls | Jenishttps_url|data_image_url[] | KeperluanDiperlukan | Nilai & had Item minimum: 1 Item maksimum: 1 Bait ternyahkod maksimum: 20,971,520 Jenis MIME: image/jpeg, image/png, image/webp | Lalai— |
first_frame_to_video · Diperlukan: image_urls
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, image_urls |
Parametermaterial_types | Kontraktext, image |
Parameteroptional | Kontrakduration, resolution, ratio, prompt |
Parameterduration_integer_range | Kontrak3, 15 |
Parameterdefault_duration | Kontrak5 |
Parameterresolution | Kontrak480P, 720P, 1080P |
Parameterdefault_resolution | Kontrak720P |
Parameterratio | Kontrak |
Parameterratio_must_omit | Kontraktrue |
Parameterimage_urls | Kontrak{"min_count":1,"max_count":1,"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_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-1.1-i2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\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-i2v, happyhorse-i2v, happyhorse-i2v-latest
Gunakan laluan kaedah yang dipaparkan di atas.
happyhorse-i2vModel yang menghidupkan imej: imej asal menentukan bingkai pertama, manakala penerangan mengarahkan pergerakan seterusnya. Menghasilkan klip video pendek dengan pilihan iringan audio.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
HappyHorse-1.1-I2V ialah model Alibaba yang memulakan adegan video daripada imej sedia ada. Imej itu menjadi bingkai pertama, manakala teks boleh menentukan tindakan seterusnya: pergerakan watak, perubahan dalam adegan dan arah kamera. Ini sesuai untuk menghidupkan ilustrasi, foto produk atau konsep visual yang telah disediakan terlebih dahulu.
Penerangan teks tidak wajib. Jika tiada penerangan, model menentukan sendiri pergerakan yang mungkin berdasarkan kandungan imej awal. Apabila dinyatakan secara jelas, imej asal menentukan komposisi dan rupa objek, manakala kata-kata mengarahkan perkembangan adegan sepanjang masa.
Alibaba menekankan pengekalan rupa watak, keselarasan visual, kelancaran pergerakan serta gabungan imej dengan audio. Antara aspek yang dinyatakan juga ialah kestabilan tulisan dan tekstur. Ciri-ciri ini merujuk kepada reka bentuk model dan tidak bermakna setiap piksel dikekalkan secara harfiah dalam semua bingkai yang dijana.
Mod ini menggunakan satu imej awal. Imej itu menentukan adegan permulaan, bukannya satu set contoh bebas untuk komposisi baharu. Keupayaan menetapkan bingkai akhir yang berasingan tidak dinyatakan bagi versi khusus ini.
JPEG, JPG, PNG dan WEBP diterima. Setiap sisi imej input mesti sekurang-kurangnya 300 piksel; nisbah aspek yang dibenarkan ialah dari 1:2,5 hingga 2,5:1, dengan saiz fail sehingga 20 MB. Nisbah aspek video yang dihasilkan mengikut bingkai pertama.
Tempoh dipilih sebagai nombor bulat dari 3 hingga 15 saat. Tahap resolusi 480P, 720P dan 1080P tersedia; format output ialah MP4, dengan kadar 24 bingkai sesaat. Penjanaan iringan audio bersama video disokong.
Penerangan boleh menggunakan apa-apa bahasa dan mengandungi sehingga 5000 aksara bukan Cina atau 2500 aksara Cina. Jika had dilampaui, bahagian berlebihan dipotong, jadi tindakan penting dan ciri pergerakan perlu dirumuskan dalam had tugasan. Nilai benih rawak awal yang sama boleh menghasilkan klip yang serupa, tetapi tidak menjamin padanan setiap bingkai.
POST /v1/videos/generationstext, imagevideo| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had happyhorse-i2v | Lalai— |
Medanprompt | Jenisstring | KeperluanPilihan | 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 | KeperluanTidak disokong | Nilai & had | Lalai— |
Medanimage_urls | Jenishttps_url|data_image_url[] | KeperluanDiperlukan | Nilai & had Item minimum: 1 Item maksimum: 1 Bait ternyahkod maksimum: 20,971,520 Jenis MIME: image/jpeg, image/png, image/webp | Lalai— |
first_frame_to_video · Diperlukan: 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_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-i2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\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-i2v, happyhorse-i2v, happyhorse-i2v-latest
Gunakan laluan kaedah yang dipaparkan di atas.
happyhorse-i2v-latestModel yang menghidupkan imej: imej asal menentukan bingkai pertama, manakala penerangan mengarahkan pergerakan seterusnya. Menghasilkan klip video pendek dengan pilihan iringan audio.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
HappyHorse-1.1-I2V ialah model Alibaba yang memulakan adegan video daripada imej sedia ada. Imej itu menjadi bingkai pertama, manakala teks boleh menentukan tindakan seterusnya: pergerakan watak, perubahan dalam adegan dan arah kamera. Ini sesuai untuk menghidupkan ilustrasi, foto produk atau konsep visual yang telah disediakan terlebih dahulu.
Penerangan teks tidak wajib. Jika tiada penerangan, model menentukan sendiri pergerakan yang mungkin berdasarkan kandungan imej awal. Apabila dinyatakan secara jelas, imej asal menentukan komposisi dan rupa objek, manakala kata-kata mengarahkan perkembangan adegan sepanjang masa.
Alibaba menekankan pengekalan rupa watak, keselarasan visual, kelancaran pergerakan serta gabungan imej dengan audio. Antara aspek yang dinyatakan juga ialah kestabilan tulisan dan tekstur. Ciri-ciri ini merujuk kepada reka bentuk model dan tidak bermakna setiap piksel dikekalkan secara harfiah dalam semua bingkai yang dijana.
Mod ini menggunakan satu imej awal. Imej itu menentukan adegan permulaan, bukannya satu set contoh bebas untuk komposisi baharu. Keupayaan menetapkan bingkai akhir yang berasingan tidak dinyatakan bagi versi khusus ini.
JPEG, JPG, PNG dan WEBP diterima. Setiap sisi imej input mesti sekurang-kurangnya 300 piksel; nisbah aspek yang dibenarkan ialah dari 1:2,5 hingga 2,5:1, dengan saiz fail sehingga 20 MB. Nisbah aspek video yang dihasilkan mengikut bingkai pertama.
Tempoh dipilih sebagai nombor bulat dari 3 hingga 15 saat. Tahap resolusi 480P, 720P dan 1080P tersedia; format output ialah MP4, dengan kadar 24 bingkai sesaat. Penjanaan iringan audio bersama video disokong.
Penerangan boleh menggunakan apa-apa bahasa dan mengandungi sehingga 5000 aksara bukan Cina atau 2500 aksara Cina. Jika had dilampaui, bahagian berlebihan dipotong, jadi tindakan penting dan ciri pergerakan perlu dirumuskan dalam had tugasan. Nilai benih rawak awal yang sama boleh menghasilkan klip yang serupa, tetapi tidak menjamin padanan setiap bingkai.
POST /v1/videos/generationstext, imagevideo| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had happyhorse-i2v-latest | Lalai— |
Medanprompt | Jenisstring | KeperluanPilihan | 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 | KeperluanTidak disokong | Nilai & had | Lalai— |
Medanimage_urls | Jenishttps_url|data_image_url[] | KeperluanDiperlukan | Nilai & had Item minimum: 1 Item maksimum: 1 Bait ternyahkod maksimum: 20,971,520 Jenis MIME: image/jpeg, image/png, image/webp | Lalai— |
first_frame_to_video · Diperlukan: 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_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-i2v-latest", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\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-i2v, happyhorse-i2v, happyhorse-i2v-latest
Gunakan laluan kaedah yang dipaparkan di atas.