HappyHorse-1.1-I2V adalah model Alibaba yang memulai adegan video dari gambar yang sudah ada. Gambar menjadi bingkai pertama, sedangkan teks dapat menentukan tindakan berikutnya: gerakan tokoh, perubahan adegan, dan arah kamera. Cocok untuk menghidupkan ilustrasi, foto produk, atau konsep visual yang telah disiapkan.
Deskripsi teks bersifat opsional. Jika tidak diberikan, model menyimpulkan gerakan yang mungkin dari isi gambar awal. Saat deskripsi diberikan secara eksplisit, gambar sumber menentukan komposisi dan penampilan objek, sedangkan kata-kata mengarahkan perkembangan adegan dari waktu ke waktu.
Alibaba menyoroti pelestarian tampilan karakter, keselarasan visual, gerakan yang halus, serta perpaduan gambar dan suara. Sasaran yang diklaim juga mencakup kestabilan tulisan dan tekstur. Sifat-sifat ini menjelaskan tujuan rancangan model dan tidak berarti setiap piksel akan dipertahankan secara persis pada semua bingkai yang dihasilkan.
Mode ini menggunakan satu gambar awal. Gambar tersebut menentukan adegan awal, bukan sekumpulan contoh terpisah untuk komposisi baru. Kemampuan menentukan bingkai akhir secara terpisah tidak dinyatakan untuk versi ini.
JPEG, JPG, PNG, dan WEBP diterima. Setiap sisi gambar input harus minimal 300 piksel; rasio aspek yang diizinkan dari 1:2,5 hingga 2,5:1, ukuran file hingga 20 MB. Rasio aspek video hasil mengikuti bingkai pertama.
Durasi dipilih sebagai bilangan bulat dari 3 hingga 15 detik. Tersedia resolusi 480P, 720P, dan 1080P; format output MP4 dengan 24 bingkai per detik. Pembuatan audio pengiring bersama video didukung.
Deskripsi dapat menggunakan bahasa apa pun dan memuat hingga 5000 karakter non-Tionghoa atau 2500 karakter Tionghoa. Jika batas terlampaui, bagian berlebih dibuang, jadi tindakan penting dan detail gerakan sebaiknya dijelaskan dalam batas tersebut. Nilai seed acak awal yang sama dapat menghasilkan video yang mirip, tetapi tidak menjamin kecocokan bingkai demi bingkai.
", "aboutText": "HappyHorse-1.1-I2V adalah model Alibaba yang memulai adegan video dari gambar yang sudah ada. Gambar menjadi bingkai pertama, sedangkan teks dapat menentukan tindakan berikutnya: gerakan tokoh, perubahan adegan, dan arah kamera. Cocok untuk menghidupkan ilustrasi, foto produk, atau konsep visual yang telah disiapkan.\n\nDeskripsi teks bersifat opsional. Jika tidak diberikan, model menyimpulkan gerakan yang mungkin dari isi gambar awal. Saat deskripsi diberikan secara eksplisit, gambar sumber menentukan komposisi dan penampilan objek, sedangkan kata-kata mengarahkan perkembangan adegan dari waktu ke waktu.\n\n### Dari bingkai pertama ke gerakan\n\nAlibaba menyoroti pelestarian tampilan karakter, keselarasan visual, gerakan yang halus, serta perpaduan gambar dan suara. Sasaran yang diklaim juga mencakup kestabilan tulisan dan tekstur. Sifat-sifat ini menjelaskan tujuan rancangan model dan tidak berarti setiap piksel akan dipertahankan secara persis pada semua bingkai yang dihasilkan.\n\nMode ini menggunakan satu gambar awal. Gambar tersebut menentukan adegan awal, bukan sekumpulan contoh terpisah untuk komposisi baru. Kemampuan menentukan bingkai akhir secara terpisah tidak dinyatakan untuk versi ini.\n\nJPEG, JPG, PNG, dan WEBP diterima. Setiap sisi gambar input harus minimal 300 piksel; rasio aspek yang diizinkan dari 1:2,5 hingga 2,5:1, ukuran file hingga 20 MB. Rasio aspek video hasil mengikuti bingkai pertama.\n\n### Parameter video\n\nDurasi dipilih sebagai bilangan bulat dari 3 hingga 15 detik. Tersedia resolusi 480P, 720P, dan 1080P; format output MP4 dengan 24 bingkai per detik. Pembuatan audio pengiring bersama video didukung.\n\nDeskripsi dapat menggunakan bahasa apa pun dan memuat hingga 5000 karakter non-Tionghoa atau 2500 karakter Tionghoa. Jika batas terlampaui, bagian berlebih dibuang, jadi tindakan penting dan detail gerakan sebaiknya dijelaskan dalam batas tersebut. Nilai seed acak awal yang sama dapat menghasilkan video yang mirip, tetapi tidak menjamin kecocokan bingkai demi bingkai.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "db6e995ecb6198630e57f0b631f2d8b994bc7ad97cf6dd2dff0ed2b13d9b6fcd", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "id", "methods": [ { "html": "happyhorse-1.1-i2vModel untuk menghidupkan gambar: gambar sumber menjadi bingkai pertama, sedangkan deskripsi mengarahkan gerakan selanjutnya. Menghasilkan video pendek dengan opsi audio pengiring.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
HappyHorse-1.1-I2V adalah model Alibaba yang memulai adegan video dari gambar yang sudah ada. Gambar menjadi bingkai pertama, sedangkan teks dapat menentukan tindakan berikutnya: gerakan tokoh, perubahan adegan, dan arah kamera. Cocok untuk menghidupkan ilustrasi, foto produk, atau konsep visual yang telah disiapkan.
Deskripsi teks bersifat opsional. Jika tidak diberikan, model menyimpulkan gerakan yang mungkin dari isi gambar awal. Saat deskripsi diberikan secara eksplisit, gambar sumber menentukan komposisi dan penampilan objek, sedangkan kata-kata mengarahkan perkembangan adegan dari waktu ke waktu.
Alibaba menyoroti pelestarian tampilan karakter, keselarasan visual, gerakan yang halus, serta perpaduan gambar dan suara. Sasaran yang diklaim juga mencakup kestabilan tulisan dan tekstur. Sifat-sifat ini menjelaskan tujuan rancangan model dan tidak berarti setiap piksel akan dipertahankan secara persis pada semua bingkai yang dihasilkan.
Mode ini menggunakan satu gambar awal. Gambar tersebut menentukan adegan awal, bukan sekumpulan contoh terpisah untuk komposisi baru. Kemampuan menentukan bingkai akhir secara terpisah tidak dinyatakan untuk versi ini.
JPEG, JPG, PNG, dan WEBP diterima. Setiap sisi gambar input harus minimal 300 piksel; rasio aspek yang diizinkan dari 1:2,5 hingga 2,5:1, ukuran file hingga 20 MB. Rasio aspek video hasil mengikuti bingkai pertama.
Durasi dipilih sebagai bilangan bulat dari 3 hingga 15 detik. Tersedia resolusi 480P, 720P, dan 1080P; format output MP4 dengan 24 bingkai per detik. Pembuatan audio pengiring bersama video didukung.
Deskripsi dapat menggunakan bahasa apa pun dan memuat hingga 5000 karakter non-Tionghoa atau 2500 karakter Tionghoa. Jika batas terlampaui, bagian berlebih dibuang, jadi tindakan penting dan detail gerakan sebaiknya dijelaskan dalam batas tersebut. Nilai seed acak awal yang sama dapat menghasilkan video yang mirip, tetapi tidak menjamin kecocokan bingkai demi bingkai.
POST /v1/videos/generationstext, imagevideo| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan happyhorse-1.1-i2v | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanOpsional | 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 | PersyaratanTidak didukung | Nilai & batasan | Bawaan— |
Kolomimage_urls | Jenishttps_url|data_image_url[] | PersyaratanWajib | Nilai & batasan Item minimum: 1 Item maksimum: 1 Byte terdekode maksimum: 20.971.520 Jenis MIME: image/jpeg, image/png, image/webp | Bawaan— |
first_frame_to_video · Wajib: 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} |
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_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 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-i2v, happyhorse-i2v, happyhorse-i2v-latest
Gunakan jalur metode yang ditampilkan di atas.
happyhorse-i2vModel untuk menghidupkan gambar: gambar sumber menjadi bingkai pertama, sedangkan deskripsi mengarahkan gerakan selanjutnya. Menghasilkan video pendek dengan opsi audio pengiring.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
HappyHorse-1.1-I2V adalah model Alibaba yang memulai adegan video dari gambar yang sudah ada. Gambar menjadi bingkai pertama, sedangkan teks dapat menentukan tindakan berikutnya: gerakan tokoh, perubahan adegan, dan arah kamera. Cocok untuk menghidupkan ilustrasi, foto produk, atau konsep visual yang telah disiapkan.
Deskripsi teks bersifat opsional. Jika tidak diberikan, model menyimpulkan gerakan yang mungkin dari isi gambar awal. Saat deskripsi diberikan secara eksplisit, gambar sumber menentukan komposisi dan penampilan objek, sedangkan kata-kata mengarahkan perkembangan adegan dari waktu ke waktu.
Alibaba menyoroti pelestarian tampilan karakter, keselarasan visual, gerakan yang halus, serta perpaduan gambar dan suara. Sasaran yang diklaim juga mencakup kestabilan tulisan dan tekstur. Sifat-sifat ini menjelaskan tujuan rancangan model dan tidak berarti setiap piksel akan dipertahankan secara persis pada semua bingkai yang dihasilkan.
Mode ini menggunakan satu gambar awal. Gambar tersebut menentukan adegan awal, bukan sekumpulan contoh terpisah untuk komposisi baru. Kemampuan menentukan bingkai akhir secara terpisah tidak dinyatakan untuk versi ini.
JPEG, JPG, PNG, dan WEBP diterima. Setiap sisi gambar input harus minimal 300 piksel; rasio aspek yang diizinkan dari 1:2,5 hingga 2,5:1, ukuran file hingga 20 MB. Rasio aspek video hasil mengikuti bingkai pertama.
Durasi dipilih sebagai bilangan bulat dari 3 hingga 15 detik. Tersedia resolusi 480P, 720P, dan 1080P; format output MP4 dengan 24 bingkai per detik. Pembuatan audio pengiring bersama video didukung.
Deskripsi dapat menggunakan bahasa apa pun dan memuat hingga 5000 karakter non-Tionghoa atau 2500 karakter Tionghoa. Jika batas terlampaui, bagian berlebih dibuang, jadi tindakan penting dan detail gerakan sebaiknya dijelaskan dalam batas tersebut. Nilai seed acak awal yang sama dapat menghasilkan video yang mirip, tetapi tidak menjamin kecocokan bingkai demi bingkai.
POST /v1/videos/generationstext, imagevideo| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan happyhorse-i2v | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanOpsional | 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 | PersyaratanTidak didukung | Nilai & batasan | Bawaan— |
Kolomimage_urls | Jenishttps_url|data_image_url[] | PersyaratanWajib | Nilai & batasan Item minimum: 1 Item maksimum: 1 Byte terdekode maksimum: 20.971.520 Jenis MIME: image/jpeg, image/png, image/webp | Bawaan— |
first_frame_to_video · Wajib: 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_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 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-i2v, happyhorse-i2v, happyhorse-i2v-latest
Gunakan jalur metode yang ditampilkan di atas.
happyhorse-i2v-latestModel untuk menghidupkan gambar: gambar sumber menjadi bingkai pertama, sedangkan deskripsi mengarahkan gerakan selanjutnya. Menghasilkan video pendek dengan opsi audio pengiring.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
HappyHorse-1.1-I2V adalah model Alibaba yang memulai adegan video dari gambar yang sudah ada. Gambar menjadi bingkai pertama, sedangkan teks dapat menentukan tindakan berikutnya: gerakan tokoh, perubahan adegan, dan arah kamera. Cocok untuk menghidupkan ilustrasi, foto produk, atau konsep visual yang telah disiapkan.
Deskripsi teks bersifat opsional. Jika tidak diberikan, model menyimpulkan gerakan yang mungkin dari isi gambar awal. Saat deskripsi diberikan secara eksplisit, gambar sumber menentukan komposisi dan penampilan objek, sedangkan kata-kata mengarahkan perkembangan adegan dari waktu ke waktu.
Alibaba menyoroti pelestarian tampilan karakter, keselarasan visual, gerakan yang halus, serta perpaduan gambar dan suara. Sasaran yang diklaim juga mencakup kestabilan tulisan dan tekstur. Sifat-sifat ini menjelaskan tujuan rancangan model dan tidak berarti setiap piksel akan dipertahankan secara persis pada semua bingkai yang dihasilkan.
Mode ini menggunakan satu gambar awal. Gambar tersebut menentukan adegan awal, bukan sekumpulan contoh terpisah untuk komposisi baru. Kemampuan menentukan bingkai akhir secara terpisah tidak dinyatakan untuk versi ini.
JPEG, JPG, PNG, dan WEBP diterima. Setiap sisi gambar input harus minimal 300 piksel; rasio aspek yang diizinkan dari 1:2,5 hingga 2,5:1, ukuran file hingga 20 MB. Rasio aspek video hasil mengikuti bingkai pertama.
Durasi dipilih sebagai bilangan bulat dari 3 hingga 15 detik. Tersedia resolusi 480P, 720P, dan 1080P; format output MP4 dengan 24 bingkai per detik. Pembuatan audio pengiring bersama video didukung.
Deskripsi dapat menggunakan bahasa apa pun dan memuat hingga 5000 karakter non-Tionghoa atau 2500 karakter Tionghoa. Jika batas terlampaui, bagian berlebih dibuang, jadi tindakan penting dan detail gerakan sebaiknya dijelaskan dalam batas tersebut. Nilai seed acak awal yang sama dapat menghasilkan video yang mirip, tetapi tidak menjamin kecocokan bingkai demi bingkai.
POST /v1/videos/generationstext, imagevideo| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan happyhorse-i2v-latest | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanOpsional | 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 | PersyaratanTidak didukung | Nilai & batasan | Bawaan— |
Kolomimage_urls | Jenishttps_url|data_image_url[] | PersyaratanWajib | Nilai & batasan Item minimum: 1 Item maksimum: 1 Byte terdekode maksimum: 20.971.520 Jenis MIME: image/jpeg, image/png, image/webp | Bawaan— |
first_frame_to_video · Wajib: 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_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 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-i2v, happyhorse-i2v, happyhorse-i2v-latest
Gunakan jalur metode yang ditampilkan di atas.