Gunakan vidu-q1-reference dengan model dan prompt di /v1/videos. Permintaan menyediakan image sebagai string atau array hingga sepuluh string, end_image, aspect_ratio, duration, dan resolution. Pilih empat atau delapan detik, 360p, 720p, atau 1080p, serta pembingkaian 16:9, 1:1, atau 9:16.
Jelaskan adegan yang membuat subjek referensi tetap dapat dikenali. Saat memberikan gambar, tentukan peran setiap referensi dan detail subjek yang perlu dipertahankan. Berikan instruksi terpisah untuk aksi dan arahan kamera, lalu tetapkan pose akhir atau pembingkaian. Simpan gambar pilihan, prompt, dan gambar akhir opsional bersama permintaan agar video yang selesai dapat dibandingkan dengan materi yang sama.
Kirim adegan satu kali melalui /v1/videos dan simpan ID permintaan yang dikembalikan. Lakukan polling pada operasi yang sama melalui /v1/videos/{request_id}, lalu simpan setiap keluaran video yang selesai dan respons lengkap. Tinjau seluruh aksi dan komposisi akhir terhadap materi serta brief yang diberikan.
", "aboutText": "Gunakan vidu-q1-reference dengan model dan prompt di /v1/videos. Permintaan menyediakan image sebagai string atau array hingga sepuluh string, end_image, aspect_ratio, duration, dan resolution. Pilih empat atau delapan detik, 360p, 720p, atau 1080p, serta pembingkaian 16:9, 1:1, atau 9:16.\n\nJelaskan adegan yang membuat subjek referensi tetap dapat dikenali. Saat memberikan gambar, tentukan peran setiap referensi dan detail subjek yang perlu dipertahankan. Berikan instruksi terpisah untuk aksi dan arahan kamera, lalu tetapkan pose akhir atau pembingkaian. Simpan gambar pilihan, prompt, dan gambar akhir opsional bersama permintaan agar video yang selesai dapat dibandingkan dengan materi yang sama.\n\nKirim adegan satu kali melalui /v1/videos dan simpan ID permintaan yang dikembalikan. Lakukan polling pada operasi yang sama melalui /v1/videos/{request_id}, lalu simpan setiap keluaran video yang selesai dan respons lengkap. Tinjau seluruh aksi dan komposisi akhir terhadap materi serta brief yang diberikan.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "434d3058522f1ad4871a4513c0886946f61d3e596ca9b2c612c96ced77fa512e", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "id", "methods": [ { "html": "vidu-q1-referenceVidu Q1 Reference memadukan brief video tertulis dengan referensi gambar opsional dan gambar akhir. Pilih pembingkaian, resolusi, dan durasi empat atau delapan detik melalui Ailoot.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Gunakan vidu-q1-reference dengan model dan prompt di /v1/videos. Permintaan menyediakan image sebagai string atau array hingga sepuluh string, end_image, aspect_ratio, duration, dan resolution. Pilih empat atau delapan detik, 360p, 720p, atau 1080p, serta pembingkaian 16:9, 1:1, atau 9:16.
Jelaskan adegan yang membuat subjek referensi tetap dapat dikenali. Saat memberikan gambar, tentukan peran setiap referensi dan detail subjek yang perlu dipertahankan. Berikan instruksi terpisah untuk aksi dan arahan kamera, lalu tetapkan pose akhir atau pembingkaian. Simpan gambar pilihan, prompt, dan gambar akhir opsional bersama permintaan agar video yang selesai dapat dibandingkan dengan materi yang sama.
Kirim adegan satu kali melalui /v1/videos dan simpan ID permintaan yang dikembalikan. Lakukan polling pada operasi yang sama melalui /v1/videos/{request_id}, lalu simpan setiap keluaran video yang selesai dan respons lengkap. Tinjau seluruh aksi dan komposisi akhir terhadap materi serta brief yang diberikan.
POST /v1/videostext, imagevideo| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan vidu-q1-reference Kondisi: Gunakan pemilih perutean Ailoot ini persis seperti yang ditampilkan. | Bawaan— |
Kolomaspect_ratio | Jenisstring | PersyaratanOpsional | Nilai & batasan 16:9, 1:1, 9:16 Kondisi: Gunakan kolom yang didokumentasikan dan pilihan yang tercantum untuk model yang dipilih; jangan sertakan nilai opsional yang tidak ditentukan. | Bawaan— |
Kolomduration | Jenisinteger | PersyaratanOpsional | Nilai & batasan 4, 8 Kondisi: Gunakan kolom yang didokumentasikan dan pilihan yang tercantum untuk model yang dipilih; jangan sertakan nilai opsional yang tidak ditentukan. | Bawaan— |
Kolomend_image | Jenisstring | PersyaratanOpsional | Nilai & batasan Kondisi: Gunakan kolom yang didokumentasikan dan pilihan yang tercantum untuk model yang dipilih; jangan sertakan nilai opsional yang tidak ditentukan. | Bawaan— |
Kolomimage | Jenisstring or array<string> | PersyaratanOpsional | Nilai & batasan Kondisi: Berikan URL gambar Anda yang sebenarnya dan dapat diakses. Daftar hanya diterima jika skema parameter menetapkan larik. | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Kondisi: Gunakan kolom yang didokumentasikan dan pilihan yang tercantum untuk model yang dipilih; jangan sertakan nilai opsional yang tidak ditentukan. | Bawaan— |
Kolomresolution | Jenisstring | PersyaratanOpsional | Nilai & batasan 360p, 720p, 1080p Kondisi: Gunakan kolom yang didokumentasikan dan pilihan yang tercantum untuk model yang dipilih; jangan sertakan nilai opsional yang tidak ditentukan. | Bawaan— |
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt |
Parameteroptional | Kontrakaspect_ratio, duration, end_image, image, resolution |
Parametermaterial_types | Kontraktext, image |
Parameterconditions | KontrakGunakan pemilih perutean Ailoot ini persis seperti yang ditampilkan., Gunakan kolom yang didokumentasikan dan pilihan yang tercantum untuk model yang dipilih; jangan sertakan nilai opsional yang tidak ditentukan., Gunakan kolom yang didokumentasikan dan pilihan yang tercantum untuk model yang dipilih; jangan sertakan nilai opsional yang tidak ditentukan., Gunakan kolom yang didokumentasikan dan pilihan yang tercantum untuk model yang dipilih; jangan sertakan nilai opsional yang tidak ditentukan., Berikan URL gambar Anda yang sebenarnya dan dapat diakses. Daftar hanya diterima jika skema parameter menetapkan larik., Gunakan kolom yang didokumentasikan dan pilihan yang tercantum untuk model yang dipilih; jangan sertakan nilai opsional yang tidak ditentukan., Gunakan kolom yang didokumentasikan dan pilihan yang tercantum untuk model yang dipilih; jangan sertakan nilai opsional yang tidak ditentukan. |
Alias metode: /v1/videos/generations
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/media/assets
GET /v1/media/assets/{asset_id}
Tarif yang ditampilkan memperkirakan biaya sebelum pembuatan. Biaya akhir dihitung dari biaya yang tercatat untuk proses pembuatan awal. Durasi keluaran yang terukur dan kuantitas perkiraan bukanlah kuantitas akhir yang ditagihkan.
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Jumlah perkiraan | Jumlah penagihan | Biaya |
|---|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Jumlah perkiraan— | Jumlah penagihan— | Biaya Masukan · Token masukan · Perkiraan hanya untuk perbandingan — / 1K token Keluaran · Token keluaran · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Pembacaan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache, 1 jam · Perkiraan hanya untuk perbandingan — / 1K token |
| KonfigurasiPer permintaan | Jadwal tarif— | Jumlah perkiraan— | Jumlah penagihansatu permintaan | Biaya Masukan · Perkiraan hanya untuk perbandingan $0.8 per permintaan |
| KonfigurasiPerkiraan biaya pembuatan | Jadwal tarif— | Jumlah perkiraanestimasi satu kali pembuatan | Jumlah penagihan— | Biaya Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $0.8 estimasi sebelum pembuatan Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai. |
Ailoot 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}"\nexport AILOOT_API_KEY\n: "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "vidu-q1-reference", "prompt": "A cat is walking on grass.", "image": "YOUR_ACCESSIBLE_IMAGE_URL"}')\np['image']=os.environ['AILOOT_IMAGE_URL']\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 \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_STATUS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("result.json").read_text())\nu=urljoin("https://api.ailoot.ai",r["polling_url"])\np=urlsplit(u)\nif p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:\n raise SystemExit("Unexpected returned polling URL; preserve the response")\nsubprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)\n# Read this same original polling_url again while pending.\n# Preserve unknown/result_pending_check; do not repeat creation.\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("status.json").read_text())\nroles={}\ndef visit(v,path=""):\n if isinstance(v,dict):\n for k,x in v.items(): visit(x,path+"/"+k)\n elif isinstance(v,list):\n for i,x in enumerate(v): visit(x,path+"/"+str(i))\n elif isinstance(v,str):\n u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)\n if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):\n roles.setdefault(u,[]).append(path)\nvisit(r)\nif not roles: raise SystemExit("No completed owned assets; retain the original status")\nmanifest=[]\nfor i,(u,paths) in enumerate(roles.items()):\n target=Path(f"asset-{i}.bin")\n subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)\n raw=target.read_bytes()\n if not raw: raise SystemExit("Empty asset; retain original status and metadata")\n ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\\x89PNG\\r\\n\\x1a\\n" else "jpg" if raw[:3]==b"\\xff\\xd8\\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"\n name=f"asset-{i}.{ext}"\n if target.name!=name: target.rename(name)\n manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})\nPath("asset-manifest.json").write_text(json.dumps(manifest,indent=2))\nprint("Saved",len(manifest),"unique owned assets; every response role retained")\nPY_ASSETS\nGET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Simpan setiap video yang selesai atau berkas yang dikembalikan; ambil setiap URL aset yang benar-benar dikembalikan.
Simpan respons dan header secara utuh, pengenal asli, setiap keluaran aktual, dan semua bidang penggunaan/akuntansi. Simpan setiap aset unik milik Ailoot dan pertahankan setiap peran yang menunjuk kepadanya.
Simpan id tugas atau operasi publik yang dikembalikan beserta semua header. Baca hanya tugas awal; unknown atau result_pending_check tidak mengizinkan pembuatan lain.
| Kolom | Jenis |
|---|---|
Kolomid | Jenisstring |
Kolompolling_url | Jenisstring |
Kolomprovider_task_id | Jenisstring |
Kolomtask_id | Jenisstring |
Kolomstatus | Jenisstring |
Kolomvideo_url | Jenisstring |
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons400 · invalid_request_error | KondisiKolom wajib, pemilih model, tipe, atau bentuk masukan tidak valid. | Langkah berikutnyaPeriksa rincian validasi yang dikembalikan sebelum menyiapkan permintaan terpisah. |
Respons | KondisiPermintaan atau hasil asli tidak diketahui atau perlu diperiksa. | Langkah berikutnyaSimpan pengenal dan header asli; baca hanya catatan status/pustaka yang didukung. Jangan kirim ulang permintaan pembuatan. |
Ailoot Ultra vidu-q1-reference
/v1/videos/generations