Higgsfield: DOP Lite

DOP Lite מנפיש תמונה שסופקה באמצעות תבניות תנועה מתועדות, עוצמה ניתנת להתאמה והנחיה כתובה. הבורר המדויק dop-lite משתמש בבקשת תמונה לווידאו ומחזיר את הווידאו דרך משימה אסינכרונית.

Ailoot Ultra · וידאו POST /v1/videos dop-lite

על המודל

התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.

DOP Lite מנפיש תמונות שסופקו דרך תהליך התמונה לווידאו המתועד של Higgsfield. הבורר המדויק הוא dop-lite. השתמשו ב-dop-lite לבחירת model ברמה העליונה וגם כערך model בתוך אובייקט params המתועד. התמונה מספקת את החומר החזותי, ותבניות התנועה וההנחיה הכתובה קובעות את התנועה ואת האפקט המבוקשים.

הכינו תמונת ייחוס שבה הנושא המיועד, הפרטים החשובים והמרחב שסביבם ברורים. המדריך ממליץ על תמונה ברזולוציה גבוהה לפרטים ברורים יותר. לסצנת מוצר, בחרו זווית שמציגה את צורת האובייקט ואת המשטחים שצריכים להישאר מזוהים בזמן התנועה. לאדם או לסביבה, ציינו את המאפיין החזותי שהתנועה צריכה להדגיש. ספקו את כתובת ה-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 שהוחזרה, והשאירו את כל הרשומות שהושלמו יחד כתוצאת הפעולה.

בדקו את הווידאו המלא מול התמונה שסופקה, האפקט שנבחר וההנחיה הכתובה: מראה הנושא, התנועה, המסגור והתמונה בסיום. לעדכון, הגדירו את הפרט החזותי הקונקרטי לשינוי ושמרו את החלקים המוצלחים של הבקשה. שמרו יחד את הפניית התמונה המקורית, הבורר המדויק, prompt, מזהי התנועה, העוצמות, seed, ההגדרות שהתבקשו והתוצרים שהושלמו, כדי שההשוואה הבאה תשתמש ביצירה בפועל.

Ailoot Ultra · וידאו POST /v1/videos dop-lite

dop-lite

Higgsfield /dop-lite

התחלה

סוגי קלט נתמכים: תמונות · טקסט
תוצאות: וידאו

זמין ב-Ailoot · קלט ושיטות

Ailoot Ultra · וידאו POST /v1/videos

סוגי קלט: image, text
סוגי פלט: video

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות dop-lite תנאים: בורר המודלים של Ailoot.	ברירת מחדל—
שדה`params`	סוג`object`	דרישהחובה	ערכים ומגבלות תנאים: פרמטרים ליצירת וידאו מתמונה; יש לשמר את מעטפת הבקשה הזו.	ברירת מחדל—
שדה`params.model`	סוג`string`	דרישהחובה	ערכים ומגבלות dop-lite תנאים: יש להשתמש באותו בורר כמו בשדה model ברמה העליונה.	ברירת מחדל—
שדה`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: לא צוין כאשר נבחר מצב flex
מאמץ חשיבה מרבי: לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)

תעריפים משוערים להשוואה

מחירים לפי תצורה

התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.

תצורה	טבלת תעריפים	כמות חזויה	חיוב
תצורהתעריפי בסיס לטוקנים	טבלת תעריפיםתעריף בסיס	כמות חזויה—	חיוב קלט · טוקני קלט · אומדן להשוואה בלבד — / 1K טוקנים פלט · טוקני פלט · אומדן להשוואה בלבד — / 1K טוקנים קלט · קריאה מהמטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד — / 1K טוקנים
תצורהעלות יצירה משוערת	טבלת תעריפים—	כמות חזויהאומדן ליצירה אחת	חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $1.24 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה.

לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →

דוגמאות לבקשות

Ailoot Ultra · וידאו

JSON · צרו סרטוןcurl · קראו את המשימה המקורית

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

קבלה ושמירה של תוצאות

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	משמעותכל וידאו שהושלם נגיש באמצעות כתובת URL חתומה בבעלות Ailoot.

שגיאות והשלבים הבאים

תגובה	תנאי	השלב הבא
תגובה⁦400⁩ · `invalid_request_error`	תנאיJSON/model לא תקפים או אינדקס תוכן לא תקף.	השלב הבא
תגובה⁦401⁩ · `authentication_error`	תנאימפתח API לא תקף של Ailoot.	השלב הבא
תגובה⁦403⁩ · `permission_error`	תנאיהקבוצה של מפתח ה־API אינה מורשית להשתמש בנתיב המדיה הזה.	השלב הבא
תגובה⁦404⁩ · `not_found_error`	תנאיהמשימה המקורית או הפלט המבוקש חסרים או אינם בבעלות אותו משתמש, מפתח API וקבוצה.	השלב הבא
תגובה⁦502⁩ · `result_pending_check`	תנאיהשליחה המקורית או הסטטוס אינם שלמים או שלא ניתן ליישב ביניהם; יש לשמור את המזהה המקורי ולא לשלוח שוב.	השלב הבא
תגובה⁦503⁩ · `result_pending_check`	תנאיהקישור המקורי, הנתיב או המדיה שבבעלותכם עדיין נבדקים; יש להמשיך לבדוק את הפעולה המקורית הזו.	השלב הבא
תגובה⁦503⁩ · `server_error`	תנאישירות המדיה או אחסון המשימה המקורית אינם זמינים.	השלב הבא

כינויים

כינויים למודל

Ailoot Ultra dop-lite

כינויים לנתיבי שיטות

/v1/videos/generations

מזהי מודלים קשורים IDs

dop-lite

FAQ · Higgsfield: DOP Lite

אילו קלטים ותוצאות זמינים?: POST /v1/videos · dop-lite: image, text → video
באילו שדות הבקשה משתמשת?: POST /v1/videos · dop-lite: model, params, webhook, callback
אילו מגבלות חלות?: 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