Higgsfield: DOP Lite

DOP Lite berilgan tasvirni hujjatlashtirilgan harakat shablonlari, sozlanadigan kuch va yozma yo‘l-yo‘riq bilan harakatlantiradi. Aynan dop-lite selektori tasvirdan video yaratish so‘rovidan foydalanadi va videosini asinxron vazifa orqali qaytaradi.

Ailoot Ultra · Video yaratish POST /v1/videos dop-lite

Model haqida

Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.

DOP Lite berilgan tasvirni Higgsfield’ning hujjatlashtirilgan tasvirdan video yaratish jarayoni orqali harakatlantiradi. Aniq selektor — dop-lite. dop-lite’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-lite

dop-lite

Higgsfield /dop-lite

Boshlash

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
Maydon`model`	Tur`string`	TalabMajburiy	Qiymatlar va cheklovlar dop-lite Shartlar: Ailoot model tanlagichi.	Standart—
Maydon`params`	Tur`object`	TalabMajburiy	Qiymatlar va cheklovlar Shartlar: Rasmdan video yaratish parametrlari; ushbu o‘rov tuzilmasini saqlang.	Standart—
Maydon`params.model`	Tur`string`	TalabMajburiy	Qiymatlar va cheklovlar dop-lite Shartlar: Yuqori darajadagi model bilan ayni tanlagichdan foydalaning.	Standart—
Maydon`params.prompt`	Tur`string`	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—
Maydon`params.seconds`	Tur`integer`	TalabIxtiyoriy	Qiymatlar va cheklovlar Shartlar: So‘ralgan davomiylik; hujjatdagi oraliq yoki standart qiymat haqida da’vo qilinmaydi.	Standart—
Maydon`params.motions`	Tur`array`	TalabIxtiyoriy	Qiymatlar va cheklovlar Shartlar: Hujjatdagi bitta yoki ikkita harakat shablonini tanlang.	Standart—
Maydon`params.motions[].id`	Tur`string`	TalabMajburiy	Qiymatlar va cheklovlar Shartlar: Hujjatdagi ishlaydigan so‘rov misolida berilgan harakat identifikatori.	Standart—
Maydon`params.motions[].strength`	Tur`number`	TalabMajburiy	Qiymatlar va cheklovlar Eng kam: 0 Eng ko‘p: 1 Shartlar: Harakat kuchi: 0.3 yengil, 1 esa kuchli deb tavsiflangan.	Standart0,8
Maydon`params.input_images`	Tur`array`	TalabIxtiyoriy	Qiymatlar va cheklovlar Shartlar: Ishlaydigan misolda ko‘rsatilgan image_url obyektlari massivi orqali berilgan referens rasmlar.	Standart—
Maydon`params.input_images[].type`	Tur`string`	TalabMajburiy	Qiymatlar va cheklovlar image_url Shartlar: Referensni ifodalash shakli.	Standart—
Maydon`params.input_images[].image_url`	Tur`string`	TalabMajburiy	Qiymatlar va cheklovlar Shartlar: Sizning haqiqiy, ochish mumkin bo‘lgan referens rasmingiz URL i.	Standart—
Maydon`params.enhance_prompt`	Tur`boolean`	TalabIxtiyoriy	Qiymatlar va cheklovlar Shartlar: Matnli ko‘rsatmani yaxshilash.	Standarttrue
Maydon`params.check_nsfw`	Tur`boolean`	TalabIxtiyoriy	Qiymatlar va cheklovlar Shartlar: Mazmunni filtrlash.	Standarttrue
Maydon`params.seed`	Tur`integer`	TalabIxtiyoriy	Qiymatlar va cheklovlar Eng kam: 1 Eng ko‘p: 1 000 000 Shartlar: Bir xil natijalarni olish uchun boshlang‘ich qiymat.	Standart—
Maydon`webhook`	Tur`object`	TalabIxtiyoriy	Qiymatlar va cheklovlar Shartlar: Hujjatdagi ixtiyoriy webhook sozlamalari; egalik qilinadigan natijani olishda Ailoot vazifasi yo‘llaridan foydalaniladi.	Standart—
Maydon`webhook.url`	Tur`string`	TalabIxtiyoriy	Qiymatlar va cheklovlar Shartlar: Qabul qiluvchingiz URL i.	Standart—
Maydon`webhook.secret`	Tur`string`	TalabIxtiyoriy	Qiymatlar va cheklovlar Shartlar: Qabul qiluvchingizning maxfiy kaliti.	Standart—
Maydon`callback`	Tur`string`	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
Parametr`content_type`	Parametr talablariapplication/json
Parametr`required`	Parametr talablarimodel, params
Parametr`optional`	Parametr talablariparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback
Parametr`material_types`	Parametr talablariimage, text
Parametr`additional_properties`	Parametr talablaritrue
Parametr`validation_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

JSON · Video yaratingcurl · Asl vazifa ma’lumotlarini o‘qing

{
  "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

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}/content
GET /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
Maydon`id`	Turstring	Ma’nosiOchiq Ailoot vazifasi yoki operatsiyasi identifikatori.
Maydon`provider_task_id`	Turstring	Ma’nosiOchiq id dan alohida bo‘lgan dastlabki vazifa identifikatori.
Maydon`polling_url`	Turstring	Ma’nosiQaytarilgan Ailoot qidiruv yo‘li.
Maydon`jobs[].id`	Turstring	Ma’nosiHaqiqatan qaytarilgan vazifa identifikatori.
Maydon`jobs[].status`	Turstring	Ma’nosiQaytarilgan har bir vazifaning holati.
Maydon`jobs[].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-lite

Usul yo‘llari taxalluslari

/v1/videos/generations

Chaqirish uchun tegishli ID lar

dop-lite

FAQ · Higgsfield: DOP Lite

Qanday kirish ma’lumotlari va natijalar mavjud?: POST /v1/videos · dop-lite: image, text → video
So‘rov qaysi maydonlardan foydalanadi?: POST /v1/videos · dop-lite: model, params, webhook, callback
Qanday cheklovlar amal qiladi?: POST /v1/videos · dop-lite: params.motions[].strength.minimum: 0; params.motions[].strength.maximum: 1; params.seed.minimum: 1; params.seed.maximum: 1000000

Higgsfield: DOP Lite