תיעוד Nodaroתיאור לבורר
נתחו תמונה עם מודל ראייה ומלאו את הבוררים אדם, סטיילינג, מסגור, עדשה ומצלמה / סרט צילום שחיברתם בבחירות תקפות מהקטלוג שלהם.
רכיב תיאור לבורר מנתח תמונה וממלא את רכיבי הבורר שמחברים אליו. מודל ראייה מתבונן בנושא המרכזי ובסצנה. הוא מחזיר בחירות שקיימות בקטלוג של כל בורר, כגון הגיל והשיער של האדם, האיפור, גודל השוט או העדשה. הרצה אחת ממלאת כל בורר מחובר.
מתי להשתמש
- הפיכת פורטרט ייחוס לבריף ליהוק מלא: חברו את הבוררים אדם, סטיילינג ומסגור, ואז הזינו אותם לרכיב יצירת תמונה או לרכיב יצירת וידאו.
- הגדרת דמות חוזרת, עם הסטיילינג שלה ומראה העדשה שלה, מתמונה אחת.
- התאמה למצלמה של תמונת ייחוס: זיהוי גודל השוט, הזווית, העדשה וסרט הצילום שלה.
התחלה מהירה
הוספת הרכיב
הקישו Tab על הקנבס ובחרו תמונה › הבנה › תיאור לבורר.
חיבור התמונה
גררו מרכיב תמונה, כגון העלאת תמונה, אל הקלט תמונה.
חיבור הבוררים למילוי
גררו מהפלט JSON של הבורר אל הקלט JSON של הבורר של כל בורר שאתם רוצים למלא. חלונית ההגדרות מפרטת אותם תחת מנתח:.
הרצה והחלת התוצאה
לחצו על הרצה ברכיב. כל בורר מקבל את החלק שלו בתוצאה. כברירת מחדל, כל בורר מחיל את החלק שלו מיד.
קלטים
| קלט | מקבל | מה הוא עושה |
|---|---|---|
| תמונה | רכיבי תמונה, כגון העלאת תמונה ויצירת תמונה | התמונה לניתוח. נדרש. |
הפלט, JSON של הבורר, הוא נתונים מובנים עם חלק אחד לכל בורר מחובר. רק רכיבי בורר יכולים לקרוא אותו: הוא לא מתחבר לקלטי טקסט.
מה הוא ממלא
הרכיב מנתח בדיוק את הבוררים שמחוברים לפלט שלו, ולא אחרים. אין הגדרה לבחירת בוררים: החיבור הוא הבחירה.
| בורר | מה הוא מזהה |
|---|---|
| אדם | תכונות כגון סוג, גיל, מוצא, מבנה גוף, שיער, עיניים ועור |
| סטיילינג | בחירות סטיילינג מהקטלוג של הבורר, כגון איפור, משקפיים ותכשיטים |
| מסגור | גודל שוט, זווית וקומפוזיציה |
| עדשה | העדשה |
| מצלמה / סרט צילום | המצלמה או פורמט הסרט |
כל ערך הוא בחירה אמיתית מהקטלוג של הבורר עצמו, ולכן בורר לעולם לא מקבל ערך שהוא לא מכיר. תכונה שלא נראית בתמונה לא נכללת.
איך הבוררים מחילים את התוצאה
כל בורר מחליט איך להשתמש בחלק שלו בתוצאה, בעזרת שתי הגדרות בחלונית ההגדרות שלו.
ההגדרה כאשר מוזרק JSON של תמונה קובעת איך ערכים חדשים מתמזגים עם הבחירות הנוכחיות של הבורר:
| מצב | מה הוא עושה |
|---|---|
| דריסה מלאה (איפוס מה שלא זוהה) | ברירת המחדל. כותבת כל ערך שזוהה ומאפסת כל ערך שלא זוהה. השתמשו בה כשהתמונה צריכה להגדיר את הבורר במלואו. |
| דריסת מה שזוהה (שמירת השאר) | כותבת רק את הערכים שזוהו ושומרת על שאר הבחירות שלכם. |
| מילוי ריקים בלבד | כותב ערך שזוהה רק במקום שבו השדה ריק. הוא לעולם לא דורס בחירה שעשיתם. |
המתג החלה אוטומטית בעת שינוי מופעל כברירת מחדל. כשהמתג מופעל, כל תוצאה חדשה מוחלת מיד, במצב שנבחר. בחירה ששיניתם ידנית נשארת כמו שהיא עד ההרצה הבאה. עד אז, הבורר מציג את הכפתור עדכון מהערכים שהוזרקו, שמחיל את התוצאה שוב. כשהמתג כבוי, הבורר מציג את הכפתור עדכון מהערכים שהוזרקו אחרי הרצה חדשה או אחרי שינוי ידני. אחרת הוא מציג מעודכן. כל הרצה נחשבת לתוצאה חדשה, גם כשהערכים זהים לקודמים.
בכל מצב, רק הבחירות של הבורר משתנות. התווית של הבורר, הטקסט לפני ואחרי שלו ומבנה התצוגה שלו נשארים כפי שהם.
הגדרות
| הגדרה | מה היא עושה |
|---|---|
| מנתח: | לקריאה בלבד. הבוררים המחוברים שההרצה הבאה תמלא. משנים אותו בחיבור או בניתוק של בוררים. |
| מודל AI | מודל הראייה. ברירת המחדל היא Gemini 3.8 Flash, מודל ראייה מהיר שקורא את הפרומפט בזול. לניתוח היסודי ביותר, בחרו Claude Opus 5.5: הוא מילא את מספר התכונות הגדול ביותר לתמונה במחקר השוואת מודלי הראייה. הרשימה מציעה רק מודלי ראייה שיכולים להחזיר את התוצאה המובנית הזו באמינות. גם Claude Fable 5 מוצע, וניתוח איתו הוא מהיקרים ביותר ברכיב. |
| מאמץ חשיבה | כמה המודל חושב לפני שהוא עונה, במודלים שתומכים בכך. ברירת המחדל היא אוטומטי (ברירת המחדל של המודל), שלא שולח שום רמת מאמץ. Claude Opus 5.5 הוא היוצא מן הכלל היחיד: הוא רץ ברמה גבוה אלא אם בחרתם רמה אחרת, והוא לא מציע את האפשרות אוטומטי. בבדיקות שלנו, הרמות גבוה מאוד ומקסימלי הפכו את הניתוחים לאיטיים יותר בלי תשובות טובות יותר. |
| מצב מתקדם | מודלי Gemini ו-Claude. מריץ את המודל ישירות אצל היצרן שלו, כך שטמפרטורה, מקסימום טוקנים והטווח המלא של עומק החשיבה נכנסים לתוקף. הקריאה מחויבת אז בתעריף של השירות של היצרן עצמו. Claude Opus 5.5 ברמה גבוה כבר רץ שם, ולכן מצב מתקדם לא משנה את המחיר שלו. |
| הנחיות נוספות (אופציונלי) | הוראות משלכם לניתוח, עד 2,000 תווים, למשל focus on the foreground subject (התמקד בנושא שבקדמת התמונה). |
קרדיטים
הרצה היא קריאה אחת למודל ראייה, לא משנה כמה בוררים חיברתם. הקריאה מחויבת לפי הטוקנים שהיא השתמשה בהם בפועל, בתעריף של המודל שנבחר. הטוקנים הם פרומפט הניתוח, התמונה והתשובה. פרומפט הניתוח מפרט את הקטלוג של כל בורר מחובר, ולכן כל בורר מחובר מאריך את הפרומפט. הכללים המלאים מפורטים בסעיף איך מחויבות קריאות LLM בדף קרדיטים.
-
לפני ההרצה, הכפתור הרצה מציג אומדן (
≈ומספר) של ניתוח טיפוסי במודל שנבחר. האומדן גדל עם מספר הבוררים המחוברים. -
המודל קובע את התעריף. ברירת המחדל, Gemini 3.8 Flash, היא מהמודלים הזולים ביותר. Claude Sonnet 5.5 ו-Claude Opus 5 עולים יותר. Claude Opus 5.5, Claude Fable 5 ו-Gemini 4 Argon הם היקרים ביותר.
-
חלק מהקריאות רצות ישירות אצל היצרן. זה קורה במצב מתקדם, וכשלמודל Claude יש מאמץ חשיבה כלשהו, כי המאמץ של Claude נכנס לתוקף רק שם. הקריאה מחויבת אז בתעריף של השירות של היצרן עצמו. Claude Opus 5.5 רץ ברמה גבוה כברירת מחדל, ולכן כל ניתוח של Claude Opus 5.5 שמתחיל מהעורך רץ שם. Gemini 4 Argon רץ תמיד בשירות של Google עצמה.
-
השריון בא קודם. כשההרצה מתחילה, Nodaro משריין מספיק קרדיטים לתשובה הארוכה ביותר שהמודל עשוי לכתוב. כשהיתרה נמוכה מהשריון, ההרצה נדחית לפני שמשהו רץ. אחרי הקריאה, ההרצה מחויבת לפי השימוש בפועל.
-
כש-Claude לא זמין. כשמודל Claude לא יכול לענות כי השירות שלו לא פעיל או עמוס מהצד של Nodaro, אותו ניתוח רץ פעם אחת על Gemini 3.8 Flash. ההרצה מחויבת לפי השימוש של שני הניתוחים: הניסיון של Claude, אם היצרן שלו חייב עליו, ועוד הניתוח של Gemini 3.8 Flash בתעריף שלו. אם גם Gemini 3.8 Flash נכשל, ההרצה נכשלת ומחויבת רק על שימוש שהיצרן חייב עליו.
-
סירוב מטעמי תוכן. כשהמודל מסרב לתמונה מטעמי תוכן, ההרצה נכשלת עם הודעת מדיניות התוכן. היא לא נשלחת למודל אחר. על הסירוב משלמים כשיצרן המודל חייב עליו; כשלא, הקרדיטים מוחזרים.
-
ניתוח ריק. כשהניתוח לא מוצא שום תכונה לשום בורר מחובר, ההרצה נכשלת עם ההודעה "We couldn't read anything in this photo — try a clearer photo of one person" (לא הצלחנו לקרוא דבר בתמונה הזו — נסו תמונה ברורה יותר של אדם אחד). ההודעה אומרת אז אם חויבתם. כשיצרן המודל חייב על הניתוח, היא מוסיפה "You were charged N credits for the model's attempt" (חויבתם ב-N קרדיטים על הניסיון של המודל). כשהיצרן לא חייב עליו, היא מוסיפה "You weren't charged" (לא חויבתם), והקרדיטים מוחזרים.
-
כשלים אחרים. על כשל שיצרן המודל חייב עליו, כגון תשובה שנקטעה במגבלה או תשובה שמעולם לא התאימה לקטלוגים, משלמים לפי השימוש הזה, והשגיאה אומרת כמה. על כשל שלא חויב, הקרדיטים מוחזרים.
פתרון בעיות
ההרצה נדחית עם הודעה שמבקשת לחבר רכיב בורר. שום דבר שהרכיב יכול למלא לא מחובר לפלט שלו. חברו לפחות בורר אחד מבין אדם, סטיילינג, מסגור, עדשה או מצלמה / סרט צילום.
בורר לא השתנה אחרי ההרצה. ייתכן שהמתג החלה אוטומטית בעת שינוי כבוי בבורר הזה. לחצו על עדכון מהערכים שהוזרקו בבורר, או הפעילו את המתג החלה אוטומטית בעת שינוי.
ההרצה נכשלת עם "We couldn't read anything in this photo" (לא הצלחנו לקרוא דבר בתמונה הזו). המודל לא מצא שום תכונה לשום בורר מחובר. ההודעה אומרת אם הניסיון חויב. נסו תמונה ברורה יותר של אדם אחד.
הרכיב תיאר את האדם הלא נכון. כשבתמונה יש כמה אנשים או רקע עמוס, הוסיפו הוראות בשדה הנחיות נוספות (אופציונלי), כגון describe the woman in the red coat (תאר את האישה במעיל האדום).
טיפים
- מלאו כמה בוררים בהרצה אחת. הבוררים אדם, סטיילינג ומסגור יחד הופכים תמונה אחת לבריף של ליהוק, מראה ושוט, בקריאה אחת למודל.
- הגנו על הבחירות שלכם. השתמשו במצב מילוי ריקים בלבד כשבחרתם ידנית כמה תכונות מגדירות ואתם רוצים שהתמונה תמלא את השאר.
- רעננו בלי לאבד תוספות. השתמשו במצב דריסת מה שזוהה (שמירת השאר) כדי לעדכן את מה שהתמונה מציגה ולשמור על הבחירות שהוספתם ידנית.
- ליהוק מחדש מאפס. השתמשו במצב דריסה מלאה (איפוס מה שלא זוהה) לגרסה נקייה של הבורר, שמבוססת על התמונה.
דרך ה-API
הנתיב POST /v1/describe-to-picker מריץ את אותו ניתוח מקוד. הוא עונה באותה בקשה עם { jobId, pickerJson, gaps }. השדה pickerJson נותן לכל בורר את הערכים שזוהו עבורו, בצורה { "<picker>": { "<dimension>": "<id>" } }, עם רשימת מזהים במקום שבו ממד מקבל כמה בחירות.
| שדה | מה הוא עושה |
|---|---|
imageUrl | נדרש. קישור http או https ציבורי לתמונה. |
targetPickers | נדרש. הבוררים למילוי, כגון person, styling, framing, lens ו-camera-format. |
instructions | הנחיות נוספות (אופציונלי), עד 2,000 תווים. |
llmModel | מודל הראייה. ברירת המחדל היא gemini-3.8-flash. |
reasoningEffort | none, low, medium, high, xhigh או max. כשמשמיטים אותו, המודל רץ בברירת המחדל שלו, חוץ מ-claude-opus-5.5, שרץ ב-high. עם הערך none, המודל claude-opus-5.5 רץ בלי מאמץ, בשירות ברירת המחדל במקום בשירות של Anthropic עצמה. |
advancedMode, temperature, maxTokens | מצב מתקדם והבקרות שלו, במודלי Gemini ו-Claude. מודלי Claude מתעלמים מטמפרטורה. |
הזרמת התשובה. שלחו Accept: text/event-stream כדי לקבל את התשובה כאירועי שרת (SSE), כך שלקוח יוכל להציג כל תכונה ברגע שהמודל כתב אותו. שגיאה שנמצאה לפני שהזרם נפתח, כגון בקשה לא תקינה או מעט מדי קרדיטים, היא עדיין תגובת HTTP רגילה עם גוף שגיאת ה-JSON הרגיל. הזרם מחזיר 200, וכל אירוע הוא שורת data: אחת עם אובייקט JSON, { "type", "data" }:
type | data | משמעות |
|---|---|---|
field | { "field": "<picker>.<dimension>", "value" } | תכונה אחת שזוהתה, נשלחת פעם אחת, ברגע שהמודל כתב אותה. היא זמנית: האירוע done עדיין יכול לתקן אותה. |
done | { jobId, pickerJson, gaps } | אותה תשובה כמו תגובת ה-JSON. היא סופית. |
error | { "code": "llm_error", "message" } | הניתוח נכשל אחרי שהזרם נפתח. משלמים על כל שימוש שיצרן המודל חייב עליו, וההודעה אומרת כמה. אחרת הקרדיטים מוחזרים. |
- הזרם מסתיים אחרי
doneאוerror. התעלמו משורות הערה, כגון: keepalive. - עם מודל Claude שרץ במאמץ חשיבה (ב-Claude Opus 5.5 הרמה גבוה היא ברירת המחדל), או במצב מתקדם, תכונות יכולות להגיע כאירועי
field. הרצות אחרות שולחות רקdone, כולל מודל ברירת המחדל, Gemini 3.8 Flash, והרצה שעברה אליו כחלופה. - אירוע
fieldלעולם לא כולל ערך שהכללים לאנשים מתחת לגיל 20 יכולים להסיר. ערכים כאלה מגיעים רק ב-done. - בקשה אחת היא ניתוח אחד, שמחויב באותו אופן כמו בלי זרם. הוא מחויב לפי השימוש כש-
doneמגיע. ב-error, משלמים על כל שימוש שיצרן המודל חייב עליו, ואחרת הקרדיטים מוחזרים. אם הלקוח מתנתק, הניתוח עדיין מסתיים ומחויב.
ראו את דף ה-API הרצת רכיב יחיד.
שאלות נפוצות
אילו בוררים רכיב תיאור לבורר יכול למלא?
רכיב תיאור לבורר ממלא את הבוררים אדם, סטיילינג, מסגור, עדשה ומצלמה / סרט צילום. הרכיב ממלא בדיוק את אלה שחיברתם לפלט שלו, בניתוח אחד.
כמה קרדיטים עולה רכיב תיאור לבורר?
הרצה של רכיב תיאור לבורר היא קריאה אחת למודל ראייה, שמחויבת לפי הטוקנים שהיא השתמשה בהם בתעריף של המודל שנבחר. ברירת המחדל, Gemini 3.8 Flash, היא מהמודלים הזולים ביותר, ואילו Claude Opus 5.5 ו-Claude Fable 5 הם מהיקרים ביותר. כל בורר מחובר מאריך את הפרומפט, ולכן מוסיף מעט למחיר. הכפתור הרצה מציג אומדן לפני ההרצה.
האם רכיב תיאור לבורר ידרוס בחירות שעשיתי ידנית?
רכיב תיאור לבורר דורס בחירות לפי ההגדרה כאשר מוזרק JSON של תמונה בכל בורר. המצב מילוי ריקים בלבד לעולם לא דורס את הבחירות שלכם. המצב דריסת מה שזוהה שומר על כל מה שלא זוהה. המצב דריסה מלאה, ברירת המחדל, מאפס גם את כל מה שלא זוהה.
למה שום דבר לא השתנה בבורר שלי?
לכל בורר יש מתג החלה אוטומטית בעת שינוי. המתג מופעל כברירת מחדל, ואז הבורר מחיל מיד את הערכים של כל הרצה. כשהמתג כבוי, לחצו על הכפתור עדכון מהערכים שהוזרקו בבורר כדי להחיל את הערכים החדשים, או הפעילו שוב את המתג החלה אוטומטית בעת שינוי.
באיזה מודל AI להשתמש ברכיב תיאור לבורר?
מודל ברירת המחדל של רכיב תיאור לבורר, Gemini 3.8 Flash, מהיר ועולה הכי פחות. לניתוח היסודי ביותר, בחרו Claude Opus 5.5, שרץ כברירת מחדל במאמץ גבוה. הוא מילא את מספר התכונות הגדול ביותר לתמונה בהשוואת מודלי הראייה שלנו, והוא מהמודלים היקרים ביותר של הרכיב. הרמות גבוה מאוד ומקסימלי הפכו את הניתוחים לאיטיים יותר, לא לטובים יותר.
מה ההבדל בין תיאור לבורר לתיאור תמונה?
רכיב תיאור תמונה כותב טקסט חופשי. רכיב תיאור לבורר מחזיר בחירות מובנות שקיימות בקטלוג של כל בורר, ולכן הבוררים יכולים להחיל אותן ישירות.
דפים קשורים
השוואת מודלי הראייה: שבעה מודלי AI מנתחים את אותם ארבעה פורטרטים
אדם
סטיילינג
מסגור
תיאור תמונה
בקרות יצירתיות
עודכן לאחרונה