Higgsfield: DOP Preview
DOP Preview berilgan tasvir materialini hujjatlashtirilgan harakat shablonlari jarayoni orqali videoga aylantiradi. Aynan dop-preview selektori bitta yoki ikkita effektni qo‘llaydi; kuch, prompt va seed boshqaruvlari tugallangan natija bilan birga saqlanadi.
Model haqida
Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.
DOP Preview berilgan tasvirni Higgsfield’ning hujjatlashtirilgan tasvirdan video yaratish jarayoni orqali harakatlantiradi. Aniq selektor — dop-preview. dop-preview’ni yuqori darajadagi model tanlovi sifatida ham, hujjatlashtirilgan params obyekti ichidagi model qiymati sifatida ham ishlating. Tasvir vizual materialni beradi; harakat shablonlari va yozma yo‘l-yo‘riq esa so‘ralgan harakat hamda effektni boshqaradi.
Mo‘ljallangan obyekt, muhim tafsilotlar va atrofdagi bo‘shliq aniq ko‘rinadigan tayanch tasvir tayyorlang. Qo‘llanma tafsilotlar ravshanroq chiqishi uchun yuqori aniqlikdagi tasvirni tavsiya qiladi. Mahsulot sahnasi uchun obyekt shaklini va harakat davomida tanib bo‘ladigan holda qolishi kerak bo‘lgan sirtlarini ko‘rsatadigan rakursni tanlang. Odam yoki muhit uchun harakat qaysi vizual xususiyatni ta’kidlashi kerakligini belgilang. Tayanch tasvirning haqiqiy URL’ini metod misolida ishlatilgan image kirishi orqali bering.
Operatsiya hujjatlarida bitta yoki ikkita harakat shabloni ko‘rsatilgan. Ikkita berilganda, qo‘llanma ularning effektlari birlashtirilishini aytadi. Tayyor sozlama tavsiflariga kamera harakati, obyekt aylanishi va vizual o‘zgarishlar kiradi. Masalan, Dolly In kameraning yaqinlashishini, 3D Rotation esa obyekt yoki mahsulotning o‘z joyida aylanishini bildiradi. Mo‘ljallangan ketma-ketlikka mos hujjatlashtirilgan shablon identifikatorlarini tanlang va har bir identifikatorni uning kuch qiymati bilan birga saqlang.
Harakat kuchi 0 dan 1 gacha bo‘lgan sondir; hujjatlashtirilgan standart qiymat — 0.8. Qo‘llanma 0.3 ni yengil effekt, 1 ni esa kuchli harakat deb ta’riflaydi. Intensivlikni o‘qiladigan holda saqlanishi kerak bo‘lgan tafsilotga qarab tanlang va yaratilgan harakatni to‘liq ko‘rib chiqing. Harakat tavsifi va uning kuchi turli vazifalarni bajaradi: shablon effektni tanlaydi, kuch esa uning intensivligini boshqaradi.
prompt maydoni tavsifiga ko‘ra so‘rovda bo‘lishi shart, lekin bo‘sh satrga ruxsat beriladi. Shablonga asoslangan effektlar uchun qo‘llanma prompt’ni bo‘sh qoldirishni tavsiya qiladi. Matn berilganda esa shablon tavsifini ham kiritishni tavsiya qiladi, chunki prompt natijani kuchli o‘zgartirishi mumkin. enhance_prompt boshqaruvi prompt’ni optimallashtirishni yoqadi va hujjatda uning standart qiymati true deb ko‘rsatilgan. Variantlarni solishtirishda matn va bu boshqaruvni tayanch tasvir hamda tanlangan shablonlar bilan birga saqlang.
seed boshqaruvi 1 dan 1000000 gacha bo‘lgan butun sonni qabul qiladi. Tanlangan seed’ni yaratish sozlamalari bilan birga qayd eting. So‘rovda butun sonli seconds maydoni ham bor; ishlatilgan qiymatni olingan klip bilan birga saqlang va klipning haqiqiy davomiyligi hamda kadr tuzilishini tekshiring. Mantiqiy check_nsfw qiymati hujjatlashtirilgan kontent filtrini yoqadi va standartda true bo‘ladi. Bu boshqaruvlar tasvirdan video yaratish so‘roviga tegishli va aynan tanlangan model bilan bog‘langan holda qolishi kerak.
Yaratish asinxron bajariladi. Sozlangan holat va natija so‘rovlarini kuzatishda qaytarilgan vazifa identifikatorini saqlang. Yakunlash xaritalashi tugallangan ish yozuvlarini va ularning xom natija URL’larini o‘qiydi. Har bir tugallangan video natijasini saqlang va uning ish identifikatorini qaytarilgan URL bilan birga qoldiring; barcha tugallangan yozuvlarni operatsiyaning yagona natija to‘plami sifatida birga saqlang.
Videoni berilgan tasvir, tanlangan effekt va yozma yo‘l-yo‘riqqa nisbatan to‘liq tekshiring: obyekt ko‘rinishi, harakat, kadr tuzilishi va oxirgi ko‘rinish. Tahrir uchun o‘zgartiriladigan aniq vizual tafsilotni belgilang va so‘rovning muvaffaqiyatli qismlarini saqlang. Keyingi solishtirish haqiqiy yaratilgan natijaga tayanishi uchun boshlang‘ich tasvir havolasi, aniq selektor, prompt, harakat identifikatorlari, kuch qiymatlari, seed, so‘ralgan sozlamalar va tugallangan fayllarni birga saqlang.
Ailoot Ultra · Video yaratish POST /v1/videos dop-preview
dop-previewBoshlash
DOP Preview berilgan tasvir materialini hujjatlashtirilgan harakat shablonlari jarayoni orqali videoga aylantiradi. Aynan dop-preview selektori bitta yoki ikkita effektni qo‘llaydi; kuch, prompt va seed boshqaruvlari tugallangan natija bilan birga saqlanadi.
- Qabul qilinadigan kirish ma’lumotlari
- Rasmlar · Matn
- Natijalar
- Video
Ailoot da mavjud · kirish ma’lumotlari va usullar
Ailoot Ultra · Video yaratish POST /v1/videos
- Kirish
image,text- Chiqish
video
| Maydon | Tur | Talab | Qiymatlar va cheklovlar | Standart |
|---|---|---|---|---|
Maydonmodel | Turstring | TalabMajburiy | Qiymatlar va cheklovlar dop-preview Shartlar: Ailoot model tanlagichi. | Standart— |
Maydonparams | Turobject | TalabMajburiy | Qiymatlar va cheklovlar Shartlar: Rasmdan video yaratish parametrlari; ushbu o‘rov tuzilmasini saqlang. | Standart— |
Maydonparams.model | Turstring | TalabMajburiy | Qiymatlar va cheklovlar dop-preview Shartlar: Yuqori darajadagi model bilan ayni tanlagichdan foydalaning. | Standart— |
Maydonparams.prompt | Turstring | TalabMajburiy | Qiymatlar va cheklovlar Shartlar: Bu maydonni saqlang; bo‘sh satr hujjatda ruxsat etilgan. Yozma yo‘l-yo‘riq tanlangan harakat effektiga kuchli ta’sir qiladi. | Standart— |
Maydonparams.seconds | Turinteger | TalabIxtiyoriy | Qiymatlar va cheklovlar Shartlar: So‘ralgan davomiylik; hujjatdagi oraliq yoki standart qiymat haqida da’vo qilinmaydi. | Standart— |
Maydonparams.motions | Turarray | TalabIxtiyoriy | Qiymatlar va cheklovlar Shartlar: Hujjatdagi bitta yoki ikkita harakat shablonini tanlang. | Standart— |
Maydonparams.motions[].id | Turstring | TalabMajburiy | Qiymatlar va cheklovlar Shartlar: Hujjatdagi ishlaydigan so‘rov misolida berilgan harakat identifikatori. | Standart— |
Maydonparams.motions[].strength | Turnumber | TalabMajburiy | Qiymatlar va cheklovlar Eng kam: 0 Eng ko‘p: 1 Shartlar: Harakat kuchi: 0.3 yengil, 1 esa kuchli deb tavsiflangan. | Standart0,8 |
Maydonparams.input_images | Turarray | TalabIxtiyoriy | Qiymatlar va cheklovlar Shartlar: Ishlaydigan misolda ko‘rsatilgan image_url obyektlari massivi orqali berilgan referens rasmlar. | Standart— |
Maydonparams.input_images[].type | Turstring | TalabMajburiy | Qiymatlar va cheklovlar image_url Shartlar: Referensni ifodalash shakli. | Standart— |
Maydonparams.input_images[].image_url | Turstring | TalabMajburiy | Qiymatlar va cheklovlar Shartlar: Sizning haqiqiy, ochish mumkin bo‘lgan referens rasmingiz URL i. | Standart— |
Maydonparams.enhance_prompt | Turboolean | TalabIxtiyoriy | Qiymatlar va cheklovlar Shartlar: Matnli ko‘rsatmani yaxshilash. | Standarttrue |
Maydonparams.check_nsfw | Turboolean | TalabIxtiyoriy | Qiymatlar va cheklovlar Shartlar: Mazmunni filtrlash. | Standarttrue |
Maydonparams.seed | Turinteger | TalabIxtiyoriy | Qiymatlar va cheklovlar Eng kam: 1 Eng ko‘p: 1 000 000 Shartlar: Bir xil natijalarni olish uchun boshlang‘ich qiymat. | Standart— |
Maydonwebhook | Turobject | TalabIxtiyoriy | Qiymatlar va cheklovlar Shartlar: Hujjatdagi ixtiyoriy webhook sozlamalari; egalik qilinadigan natijani olishda Ailoot vazifasi yo‘llaridan foydalaniladi. | Standart— |
Maydonwebhook.url | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Shartlar: Qabul qiluvchingiz URL i. | Standart— |
Maydonwebhook.secret | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Shartlar: Qabul qiluvchingizning maxfiy kaliti. | Standart— |
Maydoncallback | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Shartlar: Ixtiyoriy callback qabul qiluvchisi; hujjatdagi qabul qiluvchi HTTP 200 bilan javob beradi. | Standart— |
Kirish materiallari birikmalari
Usul parametrlari va hayot sikli
| Parametr | Parametr talablari |
|---|---|
Parametrcontent_type | Parametr talablariapplication/json |
Parametrrequired | Parametr talablarimodel, params |
Parametroptional | Parametr talablariparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback |
Parametrmaterial_types | Parametr talablariimage, text |
Parametradditional_properties | Parametr talablaritrue |
Parametrvalidation_scope | Parametr talablariModel so‘rovni yo‘naltiradi; parametrlar o‘rovi ko‘rsatilgan rasmdan video so‘roviga muvofiq tuziladi. |
Usul taxalluslari: /v1/videos/generations
Hayot sikli: 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
Yuqori darajada va params ichida ayni model tanlagichidan foydalaning.
Bir marta yarating, so‘ng dastlabki operatsiya uchun qaytarilgan ochiq id va polling_url dan foydalaning.
Egalik qilinadigan har bir yakunlangan videoni oling; natijadagi haqiqiy davomiylik va o‘lchamlarni tekshiring.
Misoldagi YOUR_ACCESSIBLE_IMAGE_URL ni haqiqiy referens rasmingiz URL i bilan almashtiring.
Tariflar
Yakuniy to‘lov qanday hisoblanadi
Ko‘rsatilgan tariflar xarajatni generatsiyadan oldin taxminiy hisoblash uchun xizmat qiladi. Yakuniy to‘lov dastlabki generatsiya uchun qayd etilgan xarajat asosida hisoblanadi. Natijaning o‘lchangan davomiyligi va oldindan taxmin qilingan miqdorlar haq undiriladigan yakuniy miqdor hisoblanmaydi.
Tarif ma’lumotlari so‘rov imkoniyatlarini qo‘shmaydi. Qo‘llab-quvvatlanadigan parametrlar tanlangan usulda ko‘rsatilgan.
- Tezkor rejim
- Ko‘rsatilmagan Tezkor rejim tanlanganda
- Flex rejimi
- Ko‘rsatilmagan flex rejimi tanlanganda
- Maksimal fikrlash darajasi
- Ko‘rsatilmagan Maksimal fikrlash darajasi uchun standart (default) tuzatish qo‘llanganda
Taqqoslash uchun taxminiy tariflar
Sozlamalar bo‘yicha narxlar
Har bir to‘lovni ko‘rsatilgan shartlarga moslang. Har bir muqobil sozlamalar to‘plami uchun bitta tarifdan foydalaning.
| Sozlama | Tariflar jadvali | Prognoz miqdori | To‘lov |
|---|---|---|---|
| SozlamaTokenlar uchun bazaviy tariflar | Tariflar jadvaliAsosiy tarif | Prognoz miqdori— | To‘lov Kirish · Kirish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Chiqish · Chiqish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshdan o‘qish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish, 1 soat · Faqat taqqoslash uchun taxmin — / 1K token |
| SozlamaYaratishning taxminiy qiymati | Tariflar jadvali— | Prognoz miqdoribir generatsiya uchun taxmin | To‘lov Chiqish · Yaratishning taxminiy narxi · Faqat taqqoslash uchun taxmin $1.24 yaratishdan oldingi taxmin Bu taxmin qo‘shimcha to‘lov ham, tugallangan generatsiya uchun qat’iy tarif ham emas. |
Ailoot so‘rovdan oldin taxminiy summani band qiladi. Natijadan keyin o‘lchangan sarf asosidagi yakuniy to‘lovni yechadi. Oqimli javob bo‘yicha yakuniy hisob-kitob yakuniy sarf yozuviga asoslanadi. Summani band qilish va to‘lovni hisoblash tartibi →
So‘rov namunalari
Ailoot Ultra · Video yaratish
{
"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
Natijalarni olish va saqlash
Ailoot Ultra · Video yaratish
Qaytarilgan vazifalar va ularning holatlarini saqlang. Egalik qilinadigan har bir yakunlangan video natijasini o‘qing.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Barcha tayyor natijalarni saqlash
Har bir tayyor video yoki qaytarilgan faylni saqlang; har bir haqiqatan qaytarilgan material URL dan kontentni oling.
Har bir haqiqiy yakunlangan chiqishni oling; soni o‘zgarmas deb hisoblamang.
Asl javobni tekshirish kerak bo‘lsa
Dastlabki javob va qaytarilgan vazifa identifikatorini saqlang; tanilmagan holat yoki noaniq yuborish yangi yaratishga ruxsat bermaydi.
Javob maydonlari
| Maydon | Tur | Ma’nosi |
|---|---|---|
Maydonid | Turstring | Ma’nosiOchiq Ailoot vazifasi yoki operatsiyasi identifikatori. |
Maydonprovider_task_id | Turstring | Ma’nosiOchiq id dan alohida bo‘lgan dastlabki vazifa identifikatori. |
Maydonpolling_url | Turstring | Ma’nosiQaytarilgan Ailoot qidiruv yo‘li. |
Maydonjobs[].id | Turstring | Ma’nosiHaqiqatan qaytarilgan vazifa identifikatori. |
Maydonjobs[].status | Turstring | Ma’nosiQaytarilgan har bir vazifaning holati. |
Maydonjobs[].results.raw.url | Turstring | Ma’nosiHar bir yakunlangan video Ailoot egaligidagi imzolangan URL orqali taqdim etiladi. |
Xatolar va keyingi qadamlar
| Javob | Shart | Keyingi qadam |
|---|---|---|
Javob400 · invalid_request_error | ShartJSON/model yoki mazmun indeksi yaroqsiz. | Keyingi qadam |
Javob401 · authentication_error | ShartAiloot API kaliti yaroqsiz. | Keyingi qadam |
Javob403 · permission_error | ShartAPI kaliti guruhi ushbu media yo‘nalishiga qo‘yilmagan. | Keyingi qadam |
Javob404 · not_found_error | ShartDastlabki vazifa yoki so‘ralgan chiqish mavjud emas yoxud ayni foydalanuvchi/API kaliti/guruhiga tegishli emas. | Keyingi qadam |
Javob502 · result_pending_check | ShartDastlabki yuborish yoki holat ma’lumoti to‘liq emas yoxud ularni o‘zaro solishtirib tasdiqlab bo‘lmaydi; dastlabki ID ni saqlang va qayta yubormang. | Keyingi qadam |
Javob503 · result_pending_check | ShartDastlabki bog‘lanish, yo‘nalish yoki egalik qilinadigan media hali tekshirilmoqda; shu dastlabki operatsiyani tekshirishni davom ettiring. | Keyingi qadam |
Javob503 · server_error | ShartMedia xizmati yoki dastlabki vazifalar saqlovi mavjud emas. | Keyingi qadam |
Taxalluslar
Model taxalluslari
Ailoot Ultra dop-preview
Usul yo‘llari taxalluslari
/v1/videos/generations
Chaqirish uchun tegishli ID lar
FAQ · Higgsfield: DOP Preview
- Qanday kirish ma’lumotlari va natijalar mavjud?
POST /v1/videos·dop-preview:image,text→video- So‘rov qaysi maydonlardan foydalanadi?
POST /v1/videos·dop-preview:model,params,webhook,callback- Qanday cheklovlar amal qiladi?
POST /v1/videos·dop-preview:params.motions[].strength.minimum:0;params.motions[].strength.maximum:1;params.seed.minimum:1;params.seed.maximum:1000000