HappyHorse-1.1-R2V membuat adegan video baru dari gambar referensi dan instruksi teks. Alibaba merancang model ini untuk mempertahankan karakter, objek, dan gaya visual yang mudah dikenali saat menghasilkan gerakan. Referensi menentukan isi dan tampilan adegan, sedangkan teks menjelaskan bagaimana unsur-unsur tersebut harus berinteraksi.
Anda dapat menggunakan satu hingga sembilan gambar. Gambar tersebut dapat menentukan karakter, objek, lingkungan, atau pendekatan artistik. Dalam deskripsi, Anda dapat menyebutkan nomor referensi dan objek tertentu di dalamnya untuk menghubungkan materi visual dengan bagian tindakan yang sesuai. Ini sangat berguna ketika unsur dari beberapa gambar perlu digabungkan dalam satu komposisi.
Berbeda dengan mode yang menggunakan bingkai awal, referensi di sini menjadi acuan untuk isi adegan baru. Instruksi teks wajib diberikan: teks menghubungkan tampilan objek dengan tindakan, gerakan kamera, dan penataan adegan secara keseluruhan. Produsen menekankan konsistensi visual dan gerakan sinematik; hasilnya tetap merupakan video yang dihasilkan, bukan penyuntingan gambar sumber.
Format yang diterima adalah JPEG, JPG, PNG, dan WEBP dengan ukuran hingga 20 MB per gambar. Sisi pendek gambar harus berukuran setidaknya 400 piksel; materi dengan kualitas 720P atau lebih tinggi disarankan. Masukan mode ini secara khusus terdiri atas gambar dan teks.
Hasil disimpan dalam MP4 dengan laju 24 bingkai per detik. Durasi ditentukan sebagai bilangan bulat dari 3 hingga 15 detik. Resolusi dapat dipilih antara 480P, 720P, dan 1080P; pembuatan suara pengiring didukung.
Tersedia bingkai horizontal, vertikal, dan persegi: 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 baru sejak awal.
Teks dapat menggunakan bahasa apa pun. Batasnya adalah 5000 karakter non-Tionghoa atau 2500 karakter Tionghoa; bagian yang melebihi batas dibuang. Peran referensi, tindakan, dan gerakan yang paling penting harus termuat dalam batas ini. Nilai awal keacakan dapat membantu menghasilkan variasi yang mirip, tetapi tidak menjamin pengulangan video yang persis sama.
", "aboutText": "HappyHorse-1.1-R2V membuat adegan video baru dari gambar referensi dan instruksi teks. Alibaba merancang model ini untuk mempertahankan karakter, objek, dan gaya visual yang mudah dikenali saat menghasilkan gerakan. Referensi menentukan isi dan tampilan adegan, sedangkan teks menjelaskan bagaimana unsur-unsur tersebut harus berinteraksi.\n\n### Peran referensi visual\n\nAnda dapat menggunakan satu hingga sembilan gambar. Gambar tersebut dapat menentukan karakter, objek, lingkungan, atau pendekatan artistik. Dalam deskripsi, Anda dapat menyebutkan nomor referensi dan objek tertentu di dalamnya untuk menghubungkan materi visual dengan bagian tindakan yang sesuai. Ini sangat berguna ketika unsur dari beberapa gambar perlu digabungkan dalam satu komposisi.\n\nBerbeda dengan mode yang menggunakan bingkai awal, referensi di sini menjadi acuan untuk isi adegan baru. Instruksi teks wajib diberikan: teks menghubungkan tampilan objek dengan tindakan, gerakan kamera, dan penataan adegan secara keseluruhan. Produsen menekankan konsistensi visual dan gerakan sinematik; hasilnya tetap merupakan video yang dihasilkan, bukan penyuntingan gambar sumber.\n\nFormat yang diterima adalah JPEG, JPG, PNG, dan WEBP dengan ukuran hingga 20 MB per gambar. Sisi pendek gambar harus berukuran setidaknya 400 piksel; materi dengan kualitas 720P atau lebih tinggi disarankan. Masukan mode ini secara khusus terdiri atas gambar dan teks.\n\n### Durasi, bingkai, dan suara\n\nHasil disimpan dalam MP4 dengan laju 24 bingkai per detik. Durasi ditentukan sebagai bilangan bulat dari 3 hingga 15 detik. Resolusi dapat dipilih antara 480P, 720P, dan 1080P; pembuatan suara pengiring didukung.\n\nTersedia bingkai horizontal, vertikal, dan persegi: 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 baru sejak awal.\n\nTeks dapat menggunakan bahasa apa pun. Batasnya adalah 5000 karakter non-Tionghoa atau 2500 karakter Tionghoa; bagian yang melebihi batas dibuang. Peran referensi, tindakan, dan gerakan yang paling penting harus termuat dalam batas ini. Nilai awal keacakan dapat membantu menghasilkan variasi yang mirip, tetapi tidak menjamin pengulangan video yang persis sama.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "72315a1efe79db4a8eef3484deb54482cfdc08413e84c7007214df83383dae6b", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "id", "methods": [ { "html": "happyhorse-1.1-r2vModel untuk menghasilkan video dari gambar referensi dan skenario teks. Membantu mempertahankan penampilan karakter, objek, dan gaya visual dalam adegan baru.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
HappyHorse-1.1-R2V membuat adegan video baru dari gambar referensi dan instruksi teks. Alibaba merancang model ini untuk mempertahankan karakter, objek, dan gaya visual yang mudah dikenali saat menghasilkan gerakan. Referensi menentukan isi dan tampilan adegan, sedangkan teks menjelaskan bagaimana unsur-unsur tersebut harus berinteraksi.
Anda dapat menggunakan satu hingga sembilan gambar. Gambar tersebut dapat menentukan karakter, objek, lingkungan, atau pendekatan artistik. Dalam deskripsi, Anda dapat menyebutkan nomor referensi dan objek tertentu di dalamnya untuk menghubungkan materi visual dengan bagian tindakan yang sesuai. Ini sangat berguna ketika unsur dari beberapa gambar perlu digabungkan dalam satu komposisi.
Berbeda dengan mode yang menggunakan bingkai awal, referensi di sini menjadi acuan untuk isi adegan baru. Instruksi teks wajib diberikan: teks menghubungkan tampilan objek dengan tindakan, gerakan kamera, dan penataan adegan secara keseluruhan. Produsen menekankan konsistensi visual dan gerakan sinematik; hasilnya tetap merupakan video yang dihasilkan, bukan penyuntingan gambar sumber.
Format yang diterima adalah JPEG, JPG, PNG, dan WEBP dengan ukuran hingga 20 MB per gambar. Sisi pendek gambar harus berukuran setidaknya 400 piksel; materi dengan kualitas 720P atau lebih tinggi disarankan. Masukan mode ini secara khusus terdiri atas gambar dan teks.
Hasil disimpan dalam MP4 dengan laju 24 bingkai per detik. Durasi ditentukan sebagai bilangan bulat dari 3 hingga 15 detik. Resolusi dapat dipilih antara 480P, 720P, dan 1080P; pembuatan suara pengiring didukung.
Tersedia bingkai horizontal, vertikal, dan persegi: 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 baru sejak awal.
Teks dapat menggunakan bahasa apa pun. Batasnya adalah 5000 karakter non-Tionghoa atau 2500 karakter Tionghoa; bagian yang melebihi batas dibuang. Peran referensi, tindakan, dan gerakan yang paling penting harus termuat dalam batas ini. Nilai awal keacakan dapat membantu menghasilkan variasi yang mirip, tetapi tidak menjamin pengulangan video yang persis sama.
POST /v1/videos/generationstext, imagevideo| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan happyhorse-1.1-r2v | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Panjang minimum: 1 | Bawaan— |
Kolomduration | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 3 Maksimum: 15 Satuan: detik | Bawaan5 |
Kolomresolution | Jenisstring | PersyaratanOpsional | Nilai & batasan 480P, 720P, 1080P | Bawaan720P |
Kolomratio | Jenisstring | PersyaratanOpsional | Nilai & batasan 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Bawaan16:9 |
Kolomimage_urls | Jenishttps_url|data_image_url[] | PersyaratanWajib | Nilai & batasan Item minimum: 1 Item maksimum: 9 Byte terdekode maksimum: 20.971.520 Jenis MIME: image/jpeg, image/png, image/webp | Bawaan— |
reference_images_to_video · Wajib: 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} |
Siklus hidup: 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 metode dan ID bersifat eksak; kemampuan pemasok terpisah dari penerimaan permintaan.
POST /v1/videos/generationsAiloot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
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 berkas yang dikembalikan; ambil setiap URL aset yang benar-benar dikembalikan.
Pertahankan setiap item data/indeks keluaran yang dikembalikan. content_url hanya menunjuk yang pertama; ambil setiap jalur konten/aset aktual. GET content tanpa index tidak mencakup semua keluaran.
Baca tugas awal yang sudah ada; jangan pernah kirim ulang pengiriman yang statusnya tidak diketahui.
| Kolom | Jenis |
|---|---|
Kolomid | Jenisstring |
Kolomobject | Jenisstring |
Kolommodel | Jenisstring |
Kolomstatus | Jenisstring |
Kolomcontent_url | Jenissigned URL |
Kolomdata[] | Jenissigned URL |
Kolomusage | Jenisobject |
Kolomresult_pending_check | Jenisboolean |
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons400 · invalid_request_error | KondisiBidang wajib, representasi materi, atau nilai parameter tidak valid | Langkah berikutnyaPerbaiki bidang yang ditunjukkan sebelum permintaan pembuatan baru. |
Respons409 · video_not_ready | KondisiKonten hasil awal belum tersedia | Langkah berikutnyaPeriksa ID awal yang dikembalikan secara berkala dan patuhi Retry-After. |
Responsserver_error | KondisiRespons yang dikembalikan menyatakan bahwa operasi atau hasil perlu diperiksa | Langkah berikutnyaSimpan ID operasi/tugas asli yang dikembalikan, header permintaan, dan respons; lanjutkan pembacaan yang didukung untuk operasi asli tersebut. Jangan kirim ulang permintaan pembuatan. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Gunakan jalur metode yang ditampilkan di atas.
happyhorse-r2vModel untuk menghasilkan video dari gambar referensi dan skenario teks. Membantu mempertahankan penampilan karakter, objek, dan gaya visual dalam adegan baru.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
HappyHorse-1.1-R2V membuat adegan video baru dari gambar referensi dan instruksi teks. Alibaba merancang model ini untuk mempertahankan karakter, objek, dan gaya visual yang mudah dikenali saat menghasilkan gerakan. Referensi menentukan isi dan tampilan adegan, sedangkan teks menjelaskan bagaimana unsur-unsur tersebut harus berinteraksi.
Anda dapat menggunakan satu hingga sembilan gambar. Gambar tersebut dapat menentukan karakter, objek, lingkungan, atau pendekatan artistik. Dalam deskripsi, Anda dapat menyebutkan nomor referensi dan objek tertentu di dalamnya untuk menghubungkan materi visual dengan bagian tindakan yang sesuai. Ini sangat berguna ketika unsur dari beberapa gambar perlu digabungkan dalam satu komposisi.
Berbeda dengan mode yang menggunakan bingkai awal, referensi di sini menjadi acuan untuk isi adegan baru. Instruksi teks wajib diberikan: teks menghubungkan tampilan objek dengan tindakan, gerakan kamera, dan penataan adegan secara keseluruhan. Produsen menekankan konsistensi visual dan gerakan sinematik; hasilnya tetap merupakan video yang dihasilkan, bukan penyuntingan gambar sumber.
Format yang diterima adalah JPEG, JPG, PNG, dan WEBP dengan ukuran hingga 20 MB per gambar. Sisi pendek gambar harus berukuran setidaknya 400 piksel; materi dengan kualitas 720P atau lebih tinggi disarankan. Masukan mode ini secara khusus terdiri atas gambar dan teks.
Hasil disimpan dalam MP4 dengan laju 24 bingkai per detik. Durasi ditentukan sebagai bilangan bulat dari 3 hingga 15 detik. Resolusi dapat dipilih antara 480P, 720P, dan 1080P; pembuatan suara pengiring didukung.
Tersedia bingkai horizontal, vertikal, dan persegi: 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 baru sejak awal.
Teks dapat menggunakan bahasa apa pun. Batasnya adalah 5000 karakter non-Tionghoa atau 2500 karakter Tionghoa; bagian yang melebihi batas dibuang. Peran referensi, tindakan, dan gerakan yang paling penting harus termuat dalam batas ini. Nilai awal keacakan dapat membantu menghasilkan variasi yang mirip, tetapi tidak menjamin pengulangan video yang persis sama.
POST /v1/videos/generationstext, imagevideo| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan happyhorse-r2v | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Panjang minimum: 1 | Bawaan— |
Kolomduration | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 3 Maksimum: 15 Satuan: detik | Bawaan5 |
Kolomresolution | Jenisstring | PersyaratanOpsional | Nilai & batasan 480P, 720P, 1080P | Bawaan720P |
Kolomratio | Jenisstring | PersyaratanOpsional | Nilai & batasan 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Bawaan16:9 |
Kolomimage_urls | Jenishttps_url|data_image_url[] | PersyaratanWajib | Nilai & batasan Item minimum: 1 Item maksimum: 9 Byte terdekode maksimum: 20.971.520 Jenis MIME: image/jpeg, image/png, image/webp | Bawaan— |
reference_images_to_video · Wajib: prompt, image_urls
| Parameter | Kontrak |
|---|---|
Parametermaterial_types | Kontraktext, image |
Parameterrequired | Kontraknull |
Parameteroptional_controls | Kontraknull |
Siklus hidup: 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 metode dan ID bersifat eksak; kemampuan pemasok terpisah dari penerimaan permintaan.
POST /v1/videos/generationsAiloot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
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 berkas yang dikembalikan; ambil setiap URL aset yang benar-benar dikembalikan.
Pertahankan setiap item data/indeks keluaran yang dikembalikan. content_url hanya menunjuk yang pertama; ambil setiap jalur konten/aset aktual. GET content tanpa index tidak mencakup semua keluaran.
Baca tugas awal yang sudah ada; jangan pernah kirim ulang pengiriman yang statusnya tidak diketahui.
| Kolom | Jenis |
|---|---|
Kolomid | Jenisstring |
Kolomobject | Jenisstring |
Kolommodel | Jenisstring |
Kolomstatus | Jenisstring |
Kolomcontent_url | Jenissigned URL |
Kolomdata[] | Jenissigned URL |
Kolomusage | Jenisobject |
Kolomresult_pending_check | Jenisboolean |
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons400 · invalid_request_error | KondisiBidang wajib, representasi materi, atau nilai parameter tidak valid | Langkah berikutnyaPerbaiki bidang yang ditunjukkan sebelum permintaan pembuatan baru. |
Respons409 · video_not_ready | KondisiKonten hasil awal belum tersedia | Langkah berikutnyaPeriksa ID awal yang dikembalikan secara berkala dan patuhi Retry-After. |
Responsserver_error | KondisiRespons yang dikembalikan menyatakan bahwa operasi atau hasil perlu diperiksa | Langkah berikutnyaSimpan ID operasi/tugas asli yang dikembalikan, header permintaan, dan respons; lanjutkan pembacaan yang didukung untuk operasi asli tersebut. Jangan kirim ulang permintaan pembuatan. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Gunakan jalur metode yang ditampilkan di atas.
happyhorse-r2v-latestModel untuk menghasilkan video dari gambar referensi dan skenario teks. Membantu mempertahankan penampilan karakter, objek, dan gaya visual dalam adegan baru.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
HappyHorse-1.1-R2V membuat adegan video baru dari gambar referensi dan instruksi teks. Alibaba merancang model ini untuk mempertahankan karakter, objek, dan gaya visual yang mudah dikenali saat menghasilkan gerakan. Referensi menentukan isi dan tampilan adegan, sedangkan teks menjelaskan bagaimana unsur-unsur tersebut harus berinteraksi.
Anda dapat menggunakan satu hingga sembilan gambar. Gambar tersebut dapat menentukan karakter, objek, lingkungan, atau pendekatan artistik. Dalam deskripsi, Anda dapat menyebutkan nomor referensi dan objek tertentu di dalamnya untuk menghubungkan materi visual dengan bagian tindakan yang sesuai. Ini sangat berguna ketika unsur dari beberapa gambar perlu digabungkan dalam satu komposisi.
Berbeda dengan mode yang menggunakan bingkai awal, referensi di sini menjadi acuan untuk isi adegan baru. Instruksi teks wajib diberikan: teks menghubungkan tampilan objek dengan tindakan, gerakan kamera, dan penataan adegan secara keseluruhan. Produsen menekankan konsistensi visual dan gerakan sinematik; hasilnya tetap merupakan video yang dihasilkan, bukan penyuntingan gambar sumber.
Format yang diterima adalah JPEG, JPG, PNG, dan WEBP dengan ukuran hingga 20 MB per gambar. Sisi pendek gambar harus berukuran setidaknya 400 piksel; materi dengan kualitas 720P atau lebih tinggi disarankan. Masukan mode ini secara khusus terdiri atas gambar dan teks.
Hasil disimpan dalam MP4 dengan laju 24 bingkai per detik. Durasi ditentukan sebagai bilangan bulat dari 3 hingga 15 detik. Resolusi dapat dipilih antara 480P, 720P, dan 1080P; pembuatan suara pengiring didukung.
Tersedia bingkai horizontal, vertikal, dan persegi: 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 baru sejak awal.
Teks dapat menggunakan bahasa apa pun. Batasnya adalah 5000 karakter non-Tionghoa atau 2500 karakter Tionghoa; bagian yang melebihi batas dibuang. Peran referensi, tindakan, dan gerakan yang paling penting harus termuat dalam batas ini. Nilai awal keacakan dapat membantu menghasilkan variasi yang mirip, tetapi tidak menjamin pengulangan video yang persis sama.
POST /v1/videos/generationstext, imagevideo| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan happyhorse-r2v-latest | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Panjang minimum: 1 | Bawaan— |
Kolomduration | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 3 Maksimum: 15 Satuan: detik | Bawaan5 |
Kolomresolution | Jenisstring | PersyaratanOpsional | Nilai & batasan 480P, 720P, 1080P | Bawaan720P |
Kolomratio | Jenisstring | PersyaratanOpsional | Nilai & batasan 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Bawaan16:9 |
Kolomimage_urls | Jenishttps_url|data_image_url[] | PersyaratanWajib | Nilai & batasan Item minimum: 1 Item maksimum: 9 Byte terdekode maksimum: 20.971.520 Jenis MIME: image/jpeg, image/png, image/webp | Bawaan— |
reference_images_to_video · Wajib: prompt, image_urls
| Parameter | Kontrak |
|---|---|
Parametermaterial_types | Kontraktext, image |
Parameterrequired | Kontraknull |
Parameteroptional_controls | Kontraknull |
Siklus hidup: 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 metode dan ID bersifat eksak; kemampuan pemasok terpisah dari penerimaan permintaan.
POST /v1/videos/generationsAiloot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
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 berkas yang dikembalikan; ambil setiap URL aset yang benar-benar dikembalikan.
Pertahankan setiap item data/indeks keluaran yang dikembalikan. content_url hanya menunjuk yang pertama; ambil setiap jalur konten/aset aktual. GET content tanpa index tidak mencakup semua keluaran.
Baca tugas awal yang sudah ada; jangan pernah kirim ulang pengiriman yang statusnya tidak diketahui.
| Kolom | Jenis |
|---|---|
Kolomid | Jenisstring |
Kolomobject | Jenisstring |
Kolommodel | Jenisstring |
Kolomstatus | Jenisstring |
Kolomcontent_url | Jenissigned URL |
Kolomdata[] | Jenissigned URL |
Kolomusage | Jenisobject |
Kolomresult_pending_check | Jenisboolean |
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons400 · invalid_request_error | KondisiBidang wajib, representasi materi, atau nilai parameter tidak valid | Langkah berikutnyaPerbaiki bidang yang ditunjukkan sebelum permintaan pembuatan baru. |
Respons409 · video_not_ready | KondisiKonten hasil awal belum tersedia | Langkah berikutnyaPeriksa ID awal yang dikembalikan secara berkala dan patuhi Retry-After. |
Responsserver_error | KondisiRespons yang dikembalikan menyatakan bahwa operasi atau hasil perlu diperiksa | Langkah berikutnyaSimpan ID operasi/tugas asli yang dikembalikan, header permintaan, dan respons; lanjutkan pembacaan yang didukung untuk operasi asli tersebut. Jangan kirim ulang permintaan pembuatan. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Gunakan jalur metode yang ditampilkan di atas.