Higgsfield: DOP Preview

DOP Preview қозғалыс үлгілеріне негізделген құжатталған үдеріс арқылы берілген кескіндерді видеоға айналдырады. Нақты dop-preview селекторы бір немесе екі әсерді қолдайды; strength, prompt және seed параметрлері аяқталған нәтижемен бірге сақталады.

Ailoot Ultra · Бейне POST /v1/videos dop-preview

Модель туралы

Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.

DOP Preview Higgsfield құжаттаған кескіннен видео жасау үдерісі арқылы берілген кескіндерді қимылға келтіреді. Нақты селектор — dop-preview. dop-preview мәнін жоғарғы деңгейдегі модель таңдауы үшін және құжатталған params нысанындағы model мәні ретінде пайдаланыңыз. Кескін көрнекі материал береді, ал қозғалыс үлгілері мен жазбаша нұсқау сұралған қозғалыс пен әсерді басқарады.

Көзделген нысан, маңызды бөлшектер және айналасындағы кеңістік анық көрінетін тірек кескінді дайындаңыз. Нұсқаулық бөлшектер анығырақ болуы үшін ажыратымдылығы жоғары кескінді ұсынады. Өнім көрінісі үшін заттың пішінін және қозғалыс кезінде танылатын болып қалуы тиіс беттерін көрсететін ракурсты таңдаңыз. Адам немесе орта үшін қозғалыс ерекше көрсетуі тиіс көрнекі белгіні анықтаңыз. Нақты тірек кескіннің URL мекенжайын әдіс мысалында пайдаланылған кескін кірісі арқылы беріңіз.

Операцияда бір немесе екі қозғалыс үлгісі құжатталған. Екеуі берілсе, нұсқаулық олардың әсерлері біріктірілетінін сипаттайды. Дайын баптаулардың сипаттамалары камера қозғалысын, нысан айналуын және көрнекі түрлендірулерді қамтиды; мысалы, Dolly In камераның жақындауын, ал 3D Rotation нысанның немесе өнімнің өз орнында айналуын сипаттайды. Көзделген тізбекке сәйкес келетін құжатталған үлгі идентификаторларын таңдап, әр идентификаторды оның қарқындылық мәнімен бірге сақтаңыз.

Қозғалыс қарқындылығы 0 мен 1 арасындағы санмен беріледі; құжатталған әдепкі мән — 0.8. Нұсқаулық 0.3 мәнін әлсіз әсер, ал 1 мәнін күшті қозғалыс деп сипаттайды. Қарқындылықты анық көрінуі тиіс бөлшекке қарай таңдап, генерацияланған әрекетті толық тексеріңіз. Қозғалыс сипаттамасы мен оның қарқындылығы әртүрлі міндет атқарады: үлгі әсерді таңдайды, ал қарқындылық оның күшін басқарады.

Сипаттамасына сәйкес prompt өрісі болуы міндетті, бірақ бос жолға рұқсат етіледі. Үлгіге негізделген әсерлер үшін нұсқаулық prompt мәнін бос қалдыруды ұсынады; мәтін берілсе, үлгінің сипаттамасын қосуды ұсынады, өйткені промпт нәтижені елеулі түрде өзгерте алады. enhance_prompt параметрі промптты оңтайландыруды қосады және әдепкі true мәнімен құжатталған. Нұсқаларды салыстырғанда мәтін мен осы параметрді тірек кескін және таңдалған үлгілермен бірге сақтаңыз.

seed параметрі 1 мен 1000000 аралығындағы бүтін санды қабылдайды. Таңдалған seed мәнін генерация баптауларымен бірге тіркеңіз. Сұрауда бүтін санды seconds өрісі де бар; пайдаланылған мәнді алынған роликпен бірге сақтап, роликтің нақты уақыттық құрылымын және кадрлануын тексеріңіз. Логикалық check_nsfw параметрі құжатталған контент сүзгісін қосады және әдепкі true мәнін пайдаланады. Бұл параметрлер кескіннен видео жасау сұрауына жатады және нақты таңдалған модельмен байланысты қалуы тиіс.

Генерация асинхронды жүреді. Бапталған мәртебе және нәтиже сұрауын орындау барысында қайтарылған тапсырма идентификаторын сақтаңыз. Аяқталуды өңдеу аяқталған жұмыс жазбаларын және олардың нәтижелерінің бастапқы URL мекенжайларын оқиды. Әр аяқталған видео нәтижесін сақтап, оның жұмыс идентификаторын қайтарылған URL мекенжайымен бірге ұстаңыз; барлық аяқталған жазбаны операцияның бір нәтижесі ретінде сақтаңыз.

Видеоны толықтай берілген кескінмен, таңдалған әсермен және жазбаша нұсқаумен салыстырып тексеріңіз: нысанның сыртқы көрінісі, қозғалыс, кадрлау және соңғы көрініс. Түзету үшін өзгертілетін нақты көрнекі бөлшекті анықтап, сұраудың сәтті бөліктерін сақтаңыз. Келесі салыстыру нақты генерацияға сүйенуі үшін бастапқы кескін сілтемесін, нақты селекторды, промптты, қозғалыс идентификаторларын, қарқындылықтарды, seed мәнін, сұралған баптауларды және аяқталған материалдарды бірге сақтаңыз.

Ailoot Ultra · Бейне POST /v1/videos dop-preview

dop-preview

Higgsfield /dop-preview

Бастау

Қабылданатын кіріс деректері: Суреттер · Мәтін
Нәтижелер: Бейне

Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер

Ailoot Ultra · Бейне POST /v1/videos

Кіріс: image, text
Шығыс: video

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер dop-preview Шарттар: Ailoot моделін таңдау өрісі.	Әдепкі—
Өріс`params`	Түрі`object`	ТалапМіндетті	Мәндер мен шектеулер Шарттар: Суреттен бейне жасау параметрлері; осы сыртқы құрылымды сақтаңыз.	Әдепкі—
Өріс`params.model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер dop-preview Шарттар: Жоғарғы деңгейдегі модельмен бірдей таңдау мәнін пайдаланыңыз.	Әдепкі—
Өріс`params.prompt`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер Шарттар: Бұл өрісті міндетті түрде қалдырыңыз; бос жол құжатталған. Жазбаша нұсқау таңдалған қозғалыс әсеріне айтарлықтай ықпал етеді.	Әдепкі—
Өріс`params.seconds`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: Сұралған ұзақтық; құжатталған аралық немесе әдепкі мән белгіленбейді.	Әдепкі—
Өріс`params.motions`	Түрі`array`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: Құжатталған бір немесе екі қозғалыс үлгісін таңдаңыз.	Әдепкі—
Өріс`params.motions[].id`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер Шарттар: Құжатталған жұмыс істейтін сұрау мысалындағы қозғалыс идентификаторы.	Әдепкі—
Өріс`params.motions[].strength`	Түрі`number`	ТалапМіндетті	Мәндер мен шектеулер Ең азы: 0 Ең көбі: 1 Шарттар: Қозғалыс қарқындылығы: 0.3 бәсең, ал 1 күшті деп сипатталған.	Әдепкі0,8
Өріс`params.input_images`	Түрі`array`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: Жұмыс істейтін мысалда көрсетілген image_url объектілері массивімен берілетін үлгі суреттер.	Әдепкі—
Өріс`params.input_images[].type`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер image_url Шарттар: Үлгі материалды ұсыну пішімі.	Әдепкі—
Өріс`params.input_images[].image_url`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер Шарттар: Нақты қолжетімді үлгі суретіңіздің URL мекенжайы.	Әдепкі—
Өріс`params.enhance_prompt`	Түрі`boolean`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: Промптты жетілдіру.	Әдепкіtrue
Өріс`params.check_nsfw`	Түрі`boolean`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: Мазмұнды сүзгілеу.	Әдепкіtrue
Өріс`params.seed`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Ең азы: 1 Ең көбі: 1 000 000 Шарттар: Нәтиженің бірізділігін сақтауға арналған бастапқы кездейсоқтық мәні.	Әдепкі—
Өріс`webhook`	Түрі`object`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: Міндетті емес құжатталған webhook баптаулары; иелігіңіздегі нәтижені алу үшін Ailoot тапсырма жолдары қолданылады.	Әдепкі—
Өріс`webhook.url`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: Қабылдағышыңыздың URL мекенжайы.	Әдепкі—
Өріс`webhook.secret`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: Қабылдағышыңыздың құпия мәні.	Әдепкі—
Өріс`callback`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: Міндетті емес callback қабылдағышы; құжатталған қабылдағыш HTTP 200 жауабын қайтарады.	Әдепкі—

Кіріс материалдарының үйлесімдері

Әдіс параметрлері мен өмірлік циклі

Параметр	Параметр талаптары
Параметр`content_type`	Параметр талаптарыapplication/json
Параметр`required`	Параметр талаптарыmodel, params
Параметр`optional`	Параметр талаптарыparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback
Параметр`material_types`	Параметр талаптарыimage, text
Параметр`additional_properties`	Параметр талаптарыtrue
Параметр`validation_scope`	Параметр талаптарыМодель сұрауды маршруттайды; параметрлердің сыртқы құрылымы көрсетілген суреттен бейне жасау сұрауына сәйкес келеді.

Әдістің балама атаулары: /v1/videos/generations

Өмірлік цикл: 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

Жоғарғы деңгейде және params ішінде бірдей модель таңдау мәнін пайдаланыңыз.

Бір рет жасаңыз, содан кейін бастапқы операция үшін қайтарылған ашық id және polling_url мәндерін пайдаланыңыз.

Иелігіңіздегі әрбір аяқталған бейнені алыңыз; нәтижедегі нақты ұзақтық пен өлшемдерді тексеріңіз.

Мысалдағы YOUR_ACCESSIBLE_IMAGE_URL орнын нақты үлгі суретіңіздің URL мекенжайымен ауыстырыңыз.

Тарифтер

Қорытынды төлем қалай есептеледі

Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.

Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.

Жылдам режим: Көрсетілмеген Жылдам режим таңдалғанда
Икемді режим: Көрсетілмеген flex режимі таңдалғанда
Ой қорытудың ең жоғары деңгейі: Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда

Салыстыруға арналған болжамды мөлшерлемелер

Баптаулар бойынша бағалар

Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.

Баптау	Мөлшерлемелер кестесі	Болжамды мөлшер	Төлем
БаптауТокендердің базалық тарифтері	Мөлшерлемелер кестесіНегізгі мөлшерлеме	Болжамды мөлшер—	Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен
БаптауГенерацияның болжамды құны	Мөлшерлемелер кестесі—	Болжамды мөлшербір генерацияға арналған болжам	Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $1.24 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →

Сұрау мысалдары

Ailoot Ultra · Бейне

JSON · бейне құрыңызcurl · бастапқы тапсырманы оқыңыз

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

Нәтижелерді алу және сақтау

Ailoot Ultra · Бейне

Қайтарылған тапсырмалар мен олардың күйлерін сақтаңыз. Иелігіңіздегі әрбір аяқталған бейне нәтижесін оқыңыз.

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Барлық дайын нәтижені сақтау

Әр дайын бейнені немесе қайтарылған файлды сақтаңыз; нақты қайтарылған әр материал URL арқылы мазмұнды алыңыз.

Әрбір нақты аяқталған шығыс нәтижесін алыңыз; олардың саны тұрақты деп жорамалдамаңыз.

Бастапқы жауапты тексеру қажет болса

Бастапқы жауапты және қайтарылған тапсырма идентификаторын сақтаңыз; танылмаған күй немесе жіберудің белгісіз нәтижесі жаңа жасауға рұқсат бермейді.

Жауап өрістері

Өріс	Түрі	Мағынасы
Өріс`id`	Түріstring	МағынасыАшық Ailoot тапсырмасының немесе операциясының идентификаторы.
Өріс`provider_task_id`	Түріstring	МағынасыАшық id мәнінен бөлек бастапқы тапсырма идентификаторы.
Өріс`polling_url`	Түріstring	МағынасыҚайтарылған Ailoot іздеп алу жолы.
Өріс`jobs[].id`	Түріstring	МағынасыНақты қайтарылған тапсырма идентификаторы.
Өріс`jobs[].status`	Түріstring	МағынасыҚайтарылған әрбір тапсырманың күйі.
Өріс`jobs[].results.raw.url`	Түріstring	МағынасыӘрбір аяқталған бейне Ailoot иелігіндегі қолтаңбасы бар URL арқылы қолжетімді болады.

Қателер және келесі қадамдар

Жауап	Шарт	Келесі қадам
Жауап400 · `invalid_request_error`	ШартJSON немесе модель жарамсыз не мазмұн индексі қате.	Келесі қадам
Жауап401 · `authentication_error`	ШартAiloot API кілті жарамсыз.	Келесі қадам
Жауап403 · `permission_error`	ШартAPI кілтінің тобына бұл медиа маршрутын пайдалануға рұқсат берілмеген.	Келесі қадам
Жауап404 · `not_found_error`	ШартБастапқы тапсырма немесе сұралған нәтиже жоқ не сол пайдаланушыға, API кілтіне немесе топқа тиесілі емес.	Келесі қадам
Жауап502 · `result_pending_check`	ШартБастапқы жіберу немесе күй туралы мәлімет толық емес не оларды өзара сәйкестендіру мүмкін емес; бастапқы ID мәнін сақтап, қайта жібермеңіз.	Келесі қадам
Жауап503 · `result_pending_check`	ШартБастапқы байланыс, маршрут немесе иелігіңіздегі медиа әлі тексерілуде; сол бастапқы операцияны тексеруді жалғастырыңыз.	Келесі қадам
Жауап503 · `server_error`	ШартМедиа қызметі немесе бастапқы тапсырмалар қоймасы қолжетімді емес.	Келесі қадам

Балама атаулар

Модельдердің балама атаулары

Ailoot Ultra dop-preview

Әдіс жолдарының балама атаулары

/v1/videos/generations

Шақыруға арналған байланысты ID

dop-preview

FAQ · Higgsfield: DOP Preview

Қандай кіріс деректері мен нәтижелер қолжетімді?: POST /v1/videos · dop-preview: image, text → video
Сұрау қандай өрістерді пайдаланады?: POST /v1/videos · dop-preview: model, params, webhook, callback
Қандай шектеулер қолданылады?: POST /v1/videos · dop-preview: params.motions[].strength.minimum: 0; params.motions[].strength.maximum: 1; params.seed.minimum: 1; params.seed.maximum: 1000000

Higgsfield: DOP Preview