Higgsfield: DOP Lite
DOP Lite menganimasikan imej yang dibekalkan dengan templat gerakan yang didokumenkan, kekuatan boleh laras dan arahan bertulis. Pemilih dop-lite yang tepat ini menggunakan permintaan imej kepada video dan mengembalikan videonya melalui tugas asinkron.
Tentang model
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
DOP Lite menganimasikan imej yang dibekalkan melalui aliran kerja imej kepada video yang didokumenkan oleh Higgsfield. Pemilih tepatnya ialah dop-lite. Gunakan dop-lite sebagai pilihan model pada peringkat teratas dan sebagai nilai model dalam objek params yang didokumenkan. Imej membekalkan bahan visual, manakala templat gerakan dan arahan bertulis mengawal pergerakan serta kesan yang diminta.
Sediakan imej rujukan yang memaparkan subjek yang dimaksudkan, butiran penting dan ruang sekeliling dengan jelas. Panduan mengesyorkan imej beresolusi tinggi supaya butirannya lebih jelas. Untuk adegan produk, pilih sudut pandangan yang menunjukkan bentuk objek dan permukaan yang perlu kekal dapat dikenal pasti semasa bergerak. Untuk orang atau persekitaran, kenal pasti ciri visual yang perlu ditonjolkan oleh gerakan. Bekalkan URL sebenar imej rujukan melalui input imej yang digunakan dalam contoh kaedah.
Panduan operasi menerangkan penggunaan satu atau dua templat gerakan. Apabila dua templat dibekalkan, panduan menyatakan bahawa kesannya digabungkan. Penerangan pratetap merangkumi pergerakan kamera, putaran subjek dan transformasi visual; contohnya, Dolly In menerangkan kamera yang mendekati subjek, manakala 3D Rotation menerangkan subjek atau produk yang berputar di tempatnya. Pilih pengecam templat yang didokumenkan dan sepadan dengan urutan yang dimaksudkan, serta simpan setiap pengecam bersama nilai kekuatannya.
Kekuatan gerakan ialah nombor dari 0 hingga 1, dengan 0.8 sebagai nilai lalai yang didokumenkan. Panduan menerangkan 0.3 sebagai kesan halus dan 1 sebagai pergerakan yang kuat. Pilih intensiti mengikut butiran yang perlu kekal jelas, dan semak keseluruhan aksi yang dijana. Penerangan gerakan dan kekuatannya mempunyai tujuan yang berbeza: templat memilih kesan, manakala kekuatan mengawal intensitinya.
Medan prompt mesti disertakan menurut penerangannya, tetapi rentetan kosong dibenarkan. Untuk kesan berasaskan templat, panduan mengesyorkan supaya arahan dibiarkan kosong; apabila teks dibekalkan, panduan mengesyorkan agar penerangan templat disertakan kerana arahan boleh banyak mengubah hasil. Kawalan enhance_prompt mengaktifkan pengoptimuman arahan dan nilai lalainya didokumenkan sebagai true. Simpan teks dan kawalan ini bersama imej rujukan serta templat yang dipilih apabila membandingkan versi.
Kawalan seed menerima integer dari 1 hingga 1000000. Catat nilai benih yang dipilih bersama tetapan penjanaan. Permintaan turut menyediakan medan integer seconds; simpan nilai yang digunakan bersama klip yang dihasilkan dan periksa pemasaan serta pembingkaian sebenar klip itu. Kawalan Boolean check_nsfw mengaktifkan penapis kandungan yang didokumenkan dan nilai lalainya ialah true. Kawalan ini tergolong dalam permintaan imej kepada video dan perlu kekal dikaitkan dengan model tepat yang dipilih.
Penjanaan berlaku secara asinkron. Simpan identiti tugas yang dikembalikan sambil mengikuti pertanyaan status dan hasil yang dikonfigurasikan. Pemetaan penyiapan membaca entri kerja yang telah selesai dan URL hasil mentahnya. Simpan setiap hasil video yang telah selesai dan kekalkan pengecam kerjanya bersama URL yang dikembalikan, dengan semua entri yang telah selesai disimpan bersama sebagai hasil operasi.
Semak keseluruhan video berbanding imej yang dibekalkan, kesan yang dipilih dan arahan bertulis: rupa subjek, pergerakan, pembingkaian dan pandangan penutup. Untuk pindaan, kenal pasti butiran visual khusus yang perlu diubah dan kekalkan bahagian permintaan yang berjaya. Simpan rujukan imej asal, pemilih tepat, arahan, pengecam gerakan, kekuatan, nilai benih, tetapan yang diminta dan aset yang telah selesai bersama-sama supaya perbandingan seterusnya menggunakan penjanaan sebenar.
Ailoot Ultra · Penjanaan video POST /v1/videos dop-lite
dop-litePengenalan
DOP Lite menganimasikan imej yang dibekalkan dengan templat gerakan yang didokumenkan, kekuatan boleh laras dan arahan bertulis. Pemilih dop-lite yang tepat ini menggunakan permintaan imej kepada video dan mengembalikan videonya melalui tugas asinkron.
- Input yang diterima
- Imej · Teks
- Hasil
- Video
Tersedia di Ailoot · input & kaedah
Ailoot Ultra · Penjanaan video POST /v1/videos
- Input
image,text- Output
video
| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had dop-lite Syarat: Pemilih model Ailoot. | Lalai— |
Medanparams | Jenisobject | KeperluanDiperlukan | Nilai & had Syarat: Parameter imej kepada video; kekalkan struktur pembungkus ini. | Lalai— |
Medanparams.model | Jenisstring | KeperluanDiperlukan | Nilai & had dop-lite Syarat: Gunakan pemilih yang sama seperti model pada peringkat teratas. | Lalai— |
Medanparams.prompt | Jenisstring | KeperluanDiperlukan | Nilai & had Syarat: Kekalkan medan ini; rentetan kosong didokumenkan. Panduan bertulis sangat mempengaruhi kesan pergerakan yang dipilih. | Lalai— |
Medanparams.seconds | Jenisinteger | KeperluanPilihan | Nilai & had Syarat: Tempoh yang diminta; tiada julat atau nilai lalai yang didokumenkan dinyatakan sebagai terjamin. | Lalai— |
Medanparams.motions | Jenisarray | KeperluanPilihan | Nilai & had Syarat: Pilih satu atau dua templat pergerakan yang didokumenkan. | Lalai— |
Medanparams.motions[].id | Jenisstring | KeperluanDiperlukan | Nilai & had Syarat: Pengecam pergerakan dalam contoh permintaan yang didokumenkan dan berfungsi. | Lalai— |
Medanparams.motions[].strength | Jenisnumber | KeperluanDiperlukan | Nilai & had Minimum: 0 Maksimum: 1 Syarat: Keamatan pergerakan: 0.3 dihuraikan sebagai halus dan 1 sebagai kuat. | Lalai0.8 |
Medanparams.input_images | Jenisarray | KeperluanPilihan | Nilai & had Syarat: Imej rujukan, menggunakan tatasusunan objek image_url yang ditunjukkan dalam contoh yang berfungsi. | Lalai— |
Medanparams.input_images[].type | Jenisstring | KeperluanDiperlukan | Nilai & had image_url Syarat: Bentuk perwakilan rujukan. | Lalai— |
Medanparams.input_images[].image_url | Jenisstring | KeperluanDiperlukan | Nilai & had Syarat: URL imej rujukan sebenar anda yang boleh diakses. | Lalai— |
Medanparams.enhance_prompt | Jenisboolean | KeperluanPilihan | Nilai & had Syarat: Penambahbaikan prompt. | Lalaitrue |
Medanparams.check_nsfw | Jenisboolean | KeperluanPilihan | Nilai & had Syarat: Penapisan kandungan. | Lalaitrue |
Medanparams.seed | Jenisinteger | KeperluanPilihan | Nilai & had Minimum: 1 Maksimum: 1,000,000 Syarat: Nilai benih untuk output yang konsisten. | Lalai— |
Medanwebhook | Jenisobject | KeperluanPilihan | Nilai & had Syarat: Tetapan webhook pilihan yang didokumenkan; pemerolehan hasil milik anda menggunakan laluan tugas Ailoot. | Lalai— |
Medanwebhook.url | Jenisstring | KeperluanPilihan | Nilai & had Syarat: URL penerima anda. | Lalai— |
Medanwebhook.secret | Jenisstring | KeperluanPilihan | Nilai & had Syarat: Rahsia penerima anda. | Lalai— |
Medancallback | Jenisstring | KeperluanPilihan | Nilai & had Syarat: Penerima callback pilihan; penerima yang didokumenkan membalas dengan HTTP 200. | Lalai— |
Gabungan bahan input
Parameter kaedah dan kitar hayat
| 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 menghalakan permintaan; struktur pembungkus parameters mengikut permintaan imej kepada video yang ditunjukkan. |
Alias kaedah: /v1/videos/generations
Kitar hayat: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Gunakan pemilih model yang sama pada peringkat teratas dan di dalam params.
Cipta sekali, kemudian gunakan id awam dan polling_url yang dikembalikan untuk operasi asal.
Dapatkan setiap video siap milik anda; semak tempoh dan dimensi sebenar dalam hasil.
Gantikan YOUR_ACCESSIBLE_IMAGE_URL dalam contoh dengan URL imej rujukan sebenar anda.
Pelan harga
Cara caj akhir dikira
Kadar yang dipaparkan menganggarkan kos sebelum penjanaan. Caj akhir dikira berdasarkan kos yang direkodkan untuk penjanaan asal. Tempoh output yang diukur dan kuantiti ramalan bukan kuantiti akhir yang boleh dibilkan.
Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.
- Mod pantas
- Tidak dinyatakan Apabila mod pantas dipilih
- Mod flex
- Tidak dinyatakan Apabila mod flex dipilih
- Usaha penaakulan maksimum
- Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default
Anggaran kadar untuk perbandingan
Harga mengikut konfigurasi
Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.
| Konfigurasi | Jadual kadar | Kuantiti ramalan | Caj |
|---|---|---|---|
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Kuantiti ramalan— | Caj Input · Token input · Anggaran untuk perbandingan sahaja — / 1K token Output · Token output · Anggaran untuk perbandingan sahaja — / 1K token Input · Bacaan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache, 1 jam · Anggaran untuk perbandingan sahaja — / 1K token |
| KonfigurasiAnggaran kos penjanaan | Jadual kadar— | Kuantiti ramalananggaran untuk satu penjanaan | Caj Output · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja $1.24 anggaran sebelum penjanaan Anggaran ini bukan caj tambahan atau kadar tetap bagi penjanaan yang telah selesai. |
Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →
Contoh permintaan
Ailoot Ultra · Penjanaan video
{
"model": "dop-lite",
"params": {
"model": "dop-lite",
"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 · Penjanaan video
Simpan tugas yang dikembalikan berserta keadaannya. Baca setiap hasil video siap milik anda.
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 fail yang dikembalikan; dapatkan setiap URL aset yang benar-benar dikembalikan.
Dapatkan setiap output siap sebenar; jangan andaikan bilangan tetap.
Jika respons asal perlu disemak
Simpan respons asal dan identiti tugas yang dikembalikan; keadaan yang tidak dikenali atau penghantaran yang tidak pasti tidak memberikan kebenaran untuk penciptaan baharu.
Medan respons
| Medan | Jenis | Maksud |
|---|---|---|
Medanid | Jenisstring | MaksudPengecam tugas atau operasi awam Ailoot. |
Medanprovider_task_id | Jenisstring | MaksudPengecam tugas asal, berasingan daripada id awam. |
Medanpolling_url | Jenisstring | MaksudLaluan carian Ailoot yang dikembalikan. |
Medanjobs[].id | Jenisstring | MaksudPengecam tugas sebenar yang dikembalikan. |
Medanjobs[].status | Jenisstring | MaksudKeadaan setiap tugas yang dikembalikan. |
Medanjobs[].results.raw.url | Jenisstring | MaksudSetiap video siap disediakan melalui URL bertandatangan milik Ailoot. |
Ralat dan langkah seterusnya
| Respons | Syarat | Langkah seterusnya |
|---|---|---|
Respons400 · invalid_request_error | SyaratJSON/model tidak sah atau indeks kandungan tidak sah. | Langkah seterusnya |
Respons401 · authentication_error | SyaratKunci API Ailoot tidak sah. | Langkah seterusnya |
Respons403 · permission_error | SyaratKumpulan kunci API tidak dibenarkan mengakses laluan media ini. | Langkah seterusnya |
Respons404 · not_found_error | SyaratTugas asal atau output yang diminta tiada atau bukan milik pengguna/kunci API/kumpulan yang sama. | Langkah seterusnya |
Respons502 · result_pending_check | SyaratPenghantaran atau status asal tidak lengkap atau tidak dapat diselaraskan; simpan ID asal dan jangan hantar semula. | Langkah seterusnya |
Respons503 · result_pending_check | SyaratPengikatan asal, laluan atau media milik anda masih disemak; teruskan menyemak operasi asal tersebut. | Langkah seterusnya |
Respons503 · server_error | SyaratPerkhidmatan media atau storan tugas asal tidak tersedia. | Langkah seterusnya |
Alias
Alias model
Ailoot Ultra dop-lite
Alias laluan kaedah
/v1/videos/generations
ID pemanggil berkaitan
FAQ · Higgsfield: DOP Lite
- Apakah input dan hasil yang tersedia?
POST /v1/videos·dop-lite:image,text→video- Apakah medan yang digunakan oleh permintaan?
POST /v1/videos·dop-lite:model,params,webhook,callback- Apakah had yang terpakai?
POST /v1/videos·dop-lite:params.motions[].strength.minimum:0;params.motions[].strength.maximum:1;params.seed.minimum:1;params.seed.maximum:1000000