תיעוד Nodaroדמויות
בנו דמויות דרך עוזר AI: צרו ואשרו פורטרטים, הוסיפו הבעות, תנוחות, זוויות וקליפי תנועה, והשתמשו בדמויות שוב כייחוסים.
כלי הדמויות מאפשרים לעוזר AI לבנות את הדמויות בספרייה של אולפן הדמות ולהשתמש בהן: אנשים או דמויות אחרות עם מראה נעול, שנשארים זהים בכל תמונה ובכל סרטון. העוזר יוצר דמות, יוצר ומאשר את הפורטרט שלה, מוסיף וריאנטים כגון הבעות, תנוחות, זוויות ותאורה, מנפיש אותה לקליפי תנועה ומעביר את התמונות שלה כייחוסים ליצירות אחרות. המדריך אולפן הדמות מתאר את אותה עבודה באפליקציה.
מחזור החיים של דמות
יצירת הדמות
הכלי create_character שומר את השם ואת הזהות: תיאור, מגדר, סגנון ותלבושת. לדמות עדיין אין פורטרט.
יצירה ואישור של פורטרט
הכלי generate_character עם kind: "main" יוצר פורטרט. הריצו אותו עד שיוצא פורטרט שאתם אוהבים, ואז העבירו את המשימה הזאת ל-approve_portrait. הפורטרט המאושר הוא העוגן של הדמות, ומודל ראייה כותב את התיאור הקנוני שלה.
הוספת וריאנטים
הכלי generate_character עם kind: "asset" ועם attach_to_character_id יוצר מהפורטרט המאושר הבעות, תנוחות, זוויות ראש וגוף ווריאציות תאורה, ושומר כל אחת מהן בדמות.
הנפשה ושימוש חוזר
הכלי generate_character_motion הופך את הדמות לקליפי תנועה. הכלי get_character מחזיר את כל התמונות והקליפים, מוכנים להעברה כייחוסים ל-generate_image או ל-generate_video.
list_characters
מחזיר את הדמויות שלכם לפי מועד העדכון, מהחדש לישן, ולכל אחת את השם, התיאור, הפורטרט, מספר הווריאנטים מכל סוג וטקסט הזהות. דמויות שבארכיון לא נכללות. בלי search הכלי מחזיר רק את העמוד הראשון, ולכן כדאי לחפש כשמבקשים דמות בשמה.
הרשאה: assets:read. קרדיטים: חינם.
| פרמטר | סוג | הערות |
|---|---|---|
search | string | עד 5 מילים ועד 200 תווים. כל מילה חייבת להופיע בשם הדמות או בתיאור שלה, בלי הבדל בין אותיות גדולות לקטנות. ערך ריק פירושו שאין חיפוש. |
limit | integer | מ-1 עד 100. ברירת המחדל: 50. |
מה חוזר: הדמויות. לכתובות של התמונות, קראו ל-get_character.
get_character
מחזיר דמות אחת במלואה: כל הבעה, תנוחה, תנועה, זווית ראש, זווית גוף ווריאציית תאורה, עם השם והכתובת של כל אחת, תמונות הייחוס, וכתובות של ייחוסים מהחיים בווריאנטים שיש להם כאלה.
הרשאה: assets:read. קרדיטים: חינם.
| פרמטר | סוג | הערות |
|---|---|---|
id | string | נדרש. מזהה הדמות מ-list_characters. |
מה חוזר: הדמות, כולל updatedAt לשימוש ב-update_character. כשהדמות לא קיימת או לא שייכת לכם, חוזרת שגיאה.
ב-Nodaro Cloud, הדמות כוללת גם את training: מצב האימון בנאמנות גבוהה של הדמות, בצורה { status, error, trainedAt, imageCount }. הערך של status הוא אחד מהערכים untrained, queued, training, succeeded, failed או cancelled. קראו אותו כדי לבדוק את המצב של אימון שהתחיל ב-train_character.
create_character
יוצר דמות עם הזהות שלה. לדמות עדיין אין פורטרט: צרו אותו בשלב הבא עם generate_character.
הרשאה: assets:write. קרדיטים: חינם.
| פרמטר | סוג | הערות |
|---|---|---|
name | string | נדרש. שם התצוגה, כגון Kira, עד 200 תווים. השם חייב להיות ייחודי בין הדמויות הפעילות שלכם; שם כפול מחזיר name_taken. |
description | string | מי הדמות, עד 2,000 תווים. |
gender | string | עד 50 תווים. |
style | string | הסגנון החזותי, כגון realistic, anime, 3d-pixar או illustration. |
base_outfit | string | הבגדים שהדמות לובשת כברירת מחדל, עד 1,000 תווים. |
seed_prompt | string | פרומפט קצר שמעצב את הפורטרט הראשון, עד 4,000 תווים. |
identity_lock | string | עד כמה אולפן הדמות שומר על הפנים בווריאנטים שנוצרים: off (ברירת המחדל), soft או strict. |
מה חוזר: המזהה של הדמות החדשה.
update_character
משנה את הזהות של דמות. רק השדות שאתם שולחים נכתבים.
הרשאה: assets:write. קרדיטים: חינם.
| פרמטר | סוג | הערות |
|---|---|---|
id | string | נדרש. מזהה הדמות. |
name, description, gender, style, base_outfit, seed_prompt, identity_lock | כמו ב-create_character. | |
expected_updated_at | string | הערך updatedAt מ-get_character. השינוי נדחה אם הדמות השתנתה מאז שקראתם אותה. |
מה חוזר: אישור, או שגיאת התנגשות כשהערך של expected_updated_at לא עדכני.
approve_portrait
הופך תוצאה מוכנה של generate_character לפורטרט של הדמות, ומבקש ממודל ראייה לתאר אותה כדי למלא את התיאור הקנוני של הדמות.
הרשאה: assets:write. קרדיטים: קריאה אחת למודל הראייה Claude Sonnet 4.6 לכתיבת התיאור, שמחויבת לפי הטוקנים שהיא השתמשה בהם (איך מחויבות קריאות LLM). האישור אף פעם לא נדחה בגלל קרדיטים. כשהיתרה שלכם נמוכה מדי לתיאור, התמונה בכל זאת מאושרת, והתיאור לא נכתב. הריצו אחר כך את recaption_character כדי לכתוב אותו.
| פרמטר | סוג | הערות |
|---|---|---|
character_id | string | נדרש. הדמות. |
candidate_job_id | string | נדרש. משימת generate_character שלכם שהושלמה. |
מה חוזר: כתובת הפורטרט והתיאור. כשכתיבת התיאור נכשלת, הפורטרט בכל זאת נקבע והתיאור נשאר ריק; הריצו את recaption_character.
recaption_character
מבקש ממודל הראייה לתאר שוב את הפורטרט הנוכחי, ושומר את התיאור הקנוני החדש. השתמשו בו אחרי החלפת פורטרט, או כשהתיאור לא מדויק.
הרשאה: assets:write. קרדיטים: קריאה אחת למודל הראייה Claude Sonnet 4.6, שמחויבת לפי הטוקנים שהיא השתמשה בהם, כמו התיאור שנכתב באישור.
| פרמטר | סוג | הערות |
|---|---|---|
id | string | נדרש. הדמות. |
מה חוזר: התיאור החדש. כשאין לדמות פורטרט, הכלי מחזיר 400 no_portrait.
generate_character
יוצר פורטרט של דמות (kind: "main") או וריאנט של הדמות (kind: "asset").
הרשאה: workflows:execute. קרדיטים: המחיר של מודל התמונה.
| פרמטר | סוג | הערות |
|---|---|---|
name | string | נדרש. שם הדמות. |
kind | string | main (ברירת המחדל) לפורטרט, או asset לווריאנט. |
description, gender, style, base_outfit | string | הזהות, לפורטרט. |
model | string | מודל התמונה. ברירת המחדל: gpt-image-2. |
asset_type | string | נדרש עבור asset: expressions, poses, lighting, headAngles, bodyAngles או custom. הערך angles הוא שם ישן יותר של headAngles. |
variant | string | נדרש עבור asset: הווריאנט, כגון smile או angry להבעות, front, 3/4 left, left profile, right profile, 3/4 right או back לזוויות, standing או walking לתנוחות, ו-daylight, night או dramatic לתאורה. |
attach_to_character_id | string | שומר את התוצאה בדמות הזאת ומשתמש בפורטרט המאושר שלה כמקור. בלי פורטרט מאושר, הקריאה מחזירה portrait_required. |
attach_to_column | string | נדרש עם attach_to_character_id בווריאנט custom: איפה לשמור אותו, כגון expressions, poses, angles, body_angles, lighting_variations, sheets, detail_closeups, outfit_variations או boards. |
attach_name | string | השם של הווריאנט השמור. ברירת המחדל: הערך של variant. |
source_image_url | string | תמונת מקור, כשהתוצאה לא נשמרת בדמות. |
מה חוזר: מזהה משימה. כשמדובר בפורטרט, העבירו את המשימה ל-approve_portrait אם התוצאה מוצאת חן בעיניכם.
generate_character_motion
מנפיש דמות לקליפ תנועה קצר, מאחת התמונות שלה.
הרשאה: workflows:execute. קרדיטים: המחיר של מודל הווידאו.
| פרמטר | סוג | הערות |
|---|---|---|
motion_prompt | string | נדרש. מה זז ואיך, עד 2,000 תווים, למשל "slow head turn left, eyes track the camera, soft smile" (סיבוב ראש איטי שמאלה, העיניים עוקבות אחרי המצלמה, חיוך רך). |
name | string | נדרש. שם הדמות. |
attach_to_character_id | string | בוחר את תמונת המקור מתוך הדמות ושומר את הקליפ בתנועות שלה. |
source_image_url | string | תמונת מקור לבחירתכם. נדרש כשאין attach_to_character_id. |
provider | string | kling (ברירת המחדל), kling-turbo, kling-3.0, wan-i2v או wan-2.7-i2v. |
attach_name | string | השם של התנועה השמורה, כגון walking. |
description, motion_description, gender, style, base_outfit | string | פרטי זהות ותנועה אופציונליים. |
עם attach_to_character_id, תמונת המקור נבחרת לפי הסדר הזה: ה-source_image_url שלכם, זווית הגוף החזיתית של הדמות, כל זווית גוף אחרת, ולבסוף הפורטרט. תמונה של גוף מלא מונפשת טוב בהרבה מפורטרט של ראש, ולכן צרו קודם זוויות גוף.
מה חוזר: מזהה משימה. הכרטיס מציג את הקליפ כשהוא מוכן.
train_character
מאמן מודל בנאמנות גבוהה של דמות שמורה, על התמונות של הדמות עצמה. רכיב יצירת תמונה שהפרומפט שלו מזכיר עם @ את הדמות הזאת בלבד שומר אז על הזהות שלה בנאמנות רבה. המדריך אימון דמויות מתאר את אותה יכולת באפליקציה.
הרשאה: workflows:execute ו-assets:write. קרדיטים: 1,650 לכל אימון. ב-Nodaro Cloud בלבד.
| פרמטר | סוג | הערות |
|---|---|---|
id | string | נדרש. מזהה הדמות מ-list_characters. |
selected_image_urls | array | אימון רק על התמונות האלה של הדמות, לפחות 4 תמונות שונות. ברירת המחדל: כל התמונות שמתאימות לאימון. |
לדמות צריכות להיות לפחות 4 תמונות שונות, ונספרים בהן הפורטרט, תמונות הייחוס, ההבעות, התנוחות, הזוויות ווריאציות התאורה.
מה חוזר: תשובה מיידית, עם jobId, trainingId ו-triggerWord. האימון לוקח כ-15 דקות. בדקו את המצב שלו עם get_character, בשדה training.
- דחיות. הכלי מחזיר
already_training_or_not_foundכשאימון של הדמות כבר בעיצומו, ו-insufficient_training_imagesכשיש פחות מ-4 תמונות. - קרדיטים. הקרדיטים מוחזרים כשהאימון נכשל או מבוטל. אימון חוזר של דמות שכבר אומנה עולה שוב אותו מחיר.
- הסרת מודל מאומן. אין כלי MCP שמסיר אותו, כי ההסרה מוחקת אימון שכבר שולם, ואי אפשר לבטל אותה. השתמשו ב-
DELETE /v1/characters/:id/lora, ב-client.characters.deleteLora(id)ב-SDK או ב-nodaro characters delete-lora <id>ב-CLI. ראו את דף ה-API אימון דמויות.
שאלות נפוצות
איך עוזר AI יוצר דמות עקבית ב-Nodaro?
העוזר קורא לכלי create_character עם שם ותיאור, יוצר פורטרט עם הכלי generate_character ומאשר את הטוב ביותר עם הכלי approve_portrait. הפורטרט המאושר הופך אז לעוגן של כל וריאנט וכל קליפ תנועה של הדמות.
איך משתמשים בדמות שמורה בתמונה או בסרטון?
מצאו את הדמות עם הכלי list_characters, קראו את התמונות שלה עם הכלי get_character, והעבירו את הכתובת של הפורטרט, ההבעה או התנוחה המתאימים בפרמטר reference_image_urls של generate_image, של image_to_image או של generate_video.
למה יצירת וריאנט נכשלת עם השגיאה portrait_required?
וריאנטים משתמשים בפורטרט המאושר כמקור שלהם. צרו קודם פורטרט עם הערך main בפרמטר kind, ואשרו אותו עם הכלי approve_portrait.
מאיזו תמונה כדאי להתחיל קליפ תנועה?
תמונה של גוף מלא מונפשת טוב בהרבה מפורטרט של ראש. צרו קודם את זוויות הגוף של הדמות, והכלי generate_character_motion ישתמש אז אוטומטית בזווית הגוף החזיתית.
האם עוזר AI יכול לאמן מודל של דמות דרך MCP?
כן, ב-Nodaro Cloud. הכלי train_character מאמן מודל בנאמנות גבוהה של דמות שמורה, על לפחות 4 תמונות שונות שלה. האימון עולה 1,650 קרדיטים, והקרדיטים מוחזרים אם האימון נכשל או מבוטל.
דפים קשורים
אולפן הדמות
אימון דמויות
דמויות עקביות
נכס דמות
מיקומים
עודכן לאחרונה