Higgsfield: DOP Preview
DOP Preview mengubah gambar yang diberikan menjadi video menggunakan alur templat gerakan yang didokumentasikan. Pilihan model dop-preview yang tepat mendukung satu atau dua efek, dengan kontrol strength, prompt, dan seed disimpan bersama hasil yang selesai.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
DOP Preview menggerakkan gambar yang diberikan melalui alur pembuatan video dari gambar yang didokumentasikan Higgsfield. Pilihan model yang tepat adalah dop-preview. Gunakan dop-preview sebagai pilihan model tingkat teratas dan sebagai nilai model dalam objek params yang didokumentasikan. Gambar menyediakan bahan visual, sedangkan templat gerakan dan arahan tertulis mengendalikan gerakan serta efek yang diminta.
Siapkan gambar rujukan dengan subjek yang dituju, detail penting, dan ruang sekitarnya yang terbaca. Panduan menyarankan gambar beresolusi tinggi untuk detail yang lebih jelas. Untuk adegan produk, pilih sudut pandang yang memperlihatkan bentuk objek dan permukaan yang harus tetap dapat dikenali selama gerakan. Untuk orang atau lingkungan, tentukan ciri visual yang harus ditonjolkan gerakan. Berikan URL gambar rujukan sebenarnya melalui masukan gambar yang digunakan dalam contoh metode.
Operasi ini mendokumentasikan satu atau dua templat gerakan. Ketika dua templat diberikan, panduan menjelaskan bahwa efeknya digabungkan. Deskripsi preset mencakup gerakan kamera, rotasi subjek, dan transformasi visual; misalnya, Dolly In menjelaskan kamera yang mendekat, sedangkan 3D Rotation menjelaskan subjek atau produk yang berputar di tempat. Pilih pengenal templat yang didokumentasikan dan sesuai dengan urutan yang dituju, lalu simpan setiap pengenal bersama nilai strength-nya.
Nilai strength gerakan berupa angka dari 0 hingga 1, dengan 0.8 sebagai nilai bawaan yang didokumentasikan. Panduan menjelaskan 0.3 sebagai efek halus dan 1 sebagai gerakan kuat. Pilih intensitas sesuai detail yang harus tetap terbaca dan tinjau seluruh aksi yang dihasilkan. Deskripsi gerakan dan nilai strength memiliki tujuan berbeda: templat memilih efek, sedangkan strength mengendalikan intensitasnya.
Kolom prompt harus ada menurut deskripsinya, tetapi string kosong diperbolehkan. Untuk efek yang dipandu templat, panduan menyarankan membiarkan prompt kosong; ketika teks diberikan, panduan menyarankan menyertakan deskripsi templat karena prompt dapat sangat mengubah hasil. Kontrol enhance_prompt mengaktifkan pengoptimalan prompt dan didokumentasikan bernilai true secara bawaan. Simpan teks serta kontrol ini bersama gambar rujukan dan templat yang dipilih saat membandingkan versi.
Kontrol seed menerima bilangan bulat dari 1 hingga 1000000. Catat seed yang dipilih bersama pengaturan pembuatan. Permintaan juga menyediakan kolom seconds berupa bilangan bulat; simpan nilai yang digunakan bersama klip hasilnya dan periksa durasi serta pembingkaian klip yang sebenarnya. Boolean check_nsfw mengaktifkan filter konten yang didokumentasikan dan secara bawaan bernilai true. Kontrol ini menjadi bagian dari permintaan pembuatan video dari gambar dan harus tetap dikaitkan dengan model yang dipilih secara tepat.
Pembuatan berlangsung secara asinkron. Simpan identitas tugas yang dikembalikan saat mengikuti kueri status serta hasil yang dikonfigurasi. Pemetaan penyelesaian membaca entri pekerjaan yang selesai dan URL hasil mentahnya. Simpan setiap hasil video yang selesai dan pertahankan pengenal pekerjaannya bersama URL yang dikembalikan, dengan mengumpulkan semua entri yang selesai sebagai hasil operasi.
Tinjau video lengkap terhadap gambar yang diberikan, efek yang dipilih, dan arahan tertulis: penampilan subjek, gerakan, pembingkaian, serta tampilan penutup. Untuk revisi, tentukan detail visual konkret yang harus diubah dan pertahankan bagian permintaan yang berhasil. Simpan rujukan gambar asli, pilihan model yang tepat, prompt, pengenal gerakan, nilai strength, seed, pengaturan yang diminta, serta aset yang selesai bersama-sama agar perbandingan berikutnya menggunakan hasil pembuatan yang sebenarnya.
Ailoot Ultra · Pemrosesan video POST /v1/videos dop-preview
dop-previewMulai
DOP Preview mengubah gambar yang diberikan menjadi video menggunakan alur templat gerakan yang didokumentasikan. Pilihan model dop-preview yang tepat mendukung satu atau dua efek, dengan kontrol strength, prompt, dan seed disimpan bersama hasil yang selesai.
- Masukan yang diterima
- Gambar · Teks
- Hasil
- Video
Tersedia di Ailoot · masukan & metode
Ailoot Ultra · Pemrosesan video POST /v1/videos
- Masukan
image,text- Keluaran
video
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan dop-preview Kondisi: Pemilih model Ailoot. | Bawaan— |
Kolomparams | Jenisobject | PersyaratanWajib | Nilai & batasan Kondisi: Parameter gambar-ke-video; pertahankan struktur pembungkus ini. | Bawaan— |
Kolomparams.model | Jenisstring | PersyaratanWajib | Nilai & batasan dop-preview Kondisi: Gunakan pemilih yang sama dengan model pada tingkat teratas. | Bawaan— |
Kolomparams.prompt | Jenisstring | PersyaratanWajib | Nilai & batasan Kondisi: Tetap sertakan bidang ini; string kosong didokumentasikan. Arahan tertulis sangat memengaruhi efek gerakan yang dipilih. | Bawaan— |
Kolomparams.seconds | Jenisinteger | PersyaratanOpsional | Nilai & batasan Kondisi: Durasi yang diminta; tidak dinyatakan rentang atau nilai bawaan yang didokumentasikan. | Bawaan— |
Kolomparams.motions | Jenisarray | PersyaratanOpsional | Nilai & batasan Kondisi: Pilih satu atau dua templat gerakan yang didokumentasikan. | Bawaan— |
Kolomparams.motions[].id | Jenisstring | PersyaratanWajib | Nilai & batasan Kondisi: Pengenal gerakan dalam contoh permintaan berhasil yang didokumentasikan. | Bawaan— |
Kolomparams.motions[].strength | Jenisnumber | PersyaratanWajib | Nilai & batasan Minimum: 0 Maksimum: 1 Kondisi: Intensitas gerakan: 0.3 dijelaskan sebagai halus dan 1 sebagai kuat. | Bawaan0,8 |
Kolomparams.input_images | Jenisarray | PersyaratanOpsional | Nilai & batasan Kondisi: Gambar referensi, menggunakan array objek image_url yang ditunjukkan dalam contoh yang berhasil. | Bawaan— |
Kolomparams.input_images[].type | Jenisstring | PersyaratanWajib | Nilai & batasan image_url Kondisi: Representasi referensi. | Bawaan— |
Kolomparams.input_images[].image_url | Jenisstring | PersyaratanWajib | Nilai & batasan Kondisi: URL gambar referensi aktual Anda yang dapat diakses. | Bawaan— |
Kolomparams.enhance_prompt | Jenisboolean | PersyaratanOpsional | Nilai & batasan Kondisi: Penyempurnaan prompt. | Bawaantrue |
Kolomparams.check_nsfw | Jenisboolean | PersyaratanOpsional | Nilai & batasan Kondisi: Penyaringan konten. | Bawaantrue |
Kolomparams.seed | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 1 Maksimum: 1.000.000 Kondisi: Seed untuk keluaran yang konsisten. | Bawaan— |
Kolomwebhook | Jenisobject | PersyaratanOpsional | Nilai & batasan Kondisi: Pengaturan webhook opsional yang didokumentasikan; pengambilan hasil yang dimiliki menggunakan jalur tugas Ailoot. | Bawaan— |
Kolomwebhook.url | Jenisstring | PersyaratanOpsional | Nilai & batasan Kondisi: URL penerima Anda. | Bawaan— |
Kolomwebhook.secret | Jenisstring | PersyaratanOpsional | Nilai & batasan Kondisi: Rahasia penerima Anda. | Bawaan— |
Kolomcallback | Jenisstring | PersyaratanOpsional | Nilai & batasan Kondisi: Penerima callback opsional; penerima yang didokumentasikan merespons dengan HTTP 200. | Bawaan— |
Kombinasi bahan masukan
Parameter metode dan siklus hidup
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, params |
Parameteroptional | Kontrakparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback |
Parametermaterial_types | Kontrakimage, text |
Parameteradditional_properties | Kontraktrue |
Parametervalidation_scope | KontrakModel merutekan permintaan; struktur pembungkus parameter mengikuti permintaan gambar-ke-video yang diperagakan. |
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/videos/generations/{request_id}/content
Gunakan pemilih model yang sama pada tingkat teratas dan di dalam params.
Buat sekali, lalu gunakan id publik dan polling_url yang dikembalikan untuk operasi awal.
Ambil setiap video selesai milik Ailoot; periksa durasi dan dimensi aktual dalam hasil.
Ganti YOUR_ACCESSIBLE_IMAGE_URL dalam contoh dengan URL gambar referensi Anda yang sebenarnya.
Paket
Cara menghitung biaya akhir
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.
- Mode Fast
- Tidak ditentukan Saat mode fast dipilih
- Mode Flex
- Tidak ditentukan Saat mode flex dipilih
- Upaya penalaran maksimum
- Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default
Perkiraan tarif untuk perbandingan
Harga menurut konfigurasi
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Jumlah perkiraan | Biaya |
|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Jumlah perkiraan— | 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 |
| KonfigurasiPerkiraan biaya pembuatan | Jadwal tarif— | Jumlah perkiraanestimasi satu kali pembuatan | Biaya Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $1.24 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 →
Contoh permintaan
Ailoot Ultra · Pemrosesan video
{
"model": "dop-preview",
"params": {
"model": "dop-preview",
"prompt": "a cat",
"seed": 500000,
"motions": [
{
"id": "2bae49e6-ffe7-42a8-a73f-d44632c4acaa",
"strength": 0.5
}
],
"input_images": [
{
"type": "image_url",
"image_url": "YOUR_ACCESSIBLE_IMAGE_URL"
}
],
"enhance_prompt": true,
"check_nsfw": true
}
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i:raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use the actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
Terima dan simpan hasil
Ailoot Ultra · Pemrosesan video
Simpan tugas-tugas yang dikembalikan beserta statusnya. Baca setiap hasil video selesai milik Ailoot.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Simpan semua hasil yang selesai
Simpan setiap video yang selesai atau berkas yang dikembalikan; ambil setiap URL aset yang benar-benar dikembalikan.
Ambil setiap keluaran aktual yang telah selesai; jangan mengasumsikan jumlah yang tetap.
Jika respons asli perlu diperiksa
Simpan respons asli dan identitas tugas yang dikembalikan; status yang tidak dikenali atau pengiriman yang hasilnya ambigu tidak mengizinkan pembuatan baru.
Kolom respons
| Kolom | Jenis | Arti |
|---|---|---|
Kolomid | Jenisstring | ArtiPengenal tugas atau operasi publik Ailoot. |
Kolomprovider_task_id | Jenisstring | ArtiPengenal tugas awal, terpisah dari id publik. |
Kolompolling_url | Jenisstring | ArtiJalur pencarian Ailoot yang dikembalikan. |
Kolomjobs[].id | Jenisstring | ArtiPengenal tugas aktual yang dikembalikan. |
Kolomjobs[].status | Jenisstring | ArtiStatus setiap tugas yang dikembalikan. |
Kolomjobs[].results.raw.url | Jenisstring | ArtiSetiap video yang telah selesai tersedia melalui URL bertanda tangan milik Ailoot. |
Kesalahan dan langkah berikutnya
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons400 · invalid_request_error | KondisiJSON/model tidak valid atau indeks content tidak valid. | Langkah berikutnya |
Respons401 · authentication_error | KondisiKunci API Ailoot tidak valid. | Langkah berikutnya |
Respons403 · permission_error | KondisiGrup kunci API tidak diizinkan mengakses rute media ini. | Langkah berikutnya |
Respons404 · not_found_error | KondisiTugas awal atau keluaran yang diminta tidak ada atau tidak dimiliki oleh pengguna/kunci API/grup yang sama. | Langkah berikutnya |
Respons502 · result_pending_check | KondisiPengiriman awal atau statusnya tidak lengkap atau tidak dapat direkonsiliasi; simpan ID asli dan jangan kirim ulang. | Langkah berikutnya |
Respons503 · result_pending_check | KondisiPengikatan awal, rute, atau media milik Ailoot masih diperiksa; lanjutkan pemeriksaan operasi awal tersebut. | Langkah berikutnya |
Respons503 · server_error | KondisiLayanan media atau penyimpanan tugas awal tidak tersedia. | Langkah berikutnya |
Alias
Alias model
Ailoot Ultra dop-preview
Alias jalur metode
/v1/videos/generations
ID pemanggil terkait
FAQ · Higgsfield: DOP Preview
- Input dan hasil apa yang tersedia?
POST /v1/videos·dop-preview:image,text→video- Kolom apa yang digunakan permintaan?
POST /v1/videos·dop-preview:model,params,webhook,callback- Batasan apa yang berlaku?
POST /v1/videos·dop-preview:params.motions[].strength.minimum:0;params.motions[].strength.maximum:1;params.seed.minimum:1;params.seed.maximum:1000000