Source: https://ailoot.ai/models/he/recraft-recraft-v4-1-utility/ Canonical: https://ailoot.ai/models/he/recraft-recraft-v4-1-utility/ Language: he # Recraft: Recraft V4.1 Utility [Markdown](https://ailoot.ai/models/he/recraft-recraft-v4-1-utility/index.md) · [JSON](https://ailoot.ai/models/he/recraft-recraft-v4-1-utility/facts.json) ## [Recraft: Recraft V4.1 Utility](https://ailoot.ai/models/he/recraft-recraft-v4-1-utility/) Recraft V4.1 Utility יוצר תמונות רסטר ב־1K לשוטים פשוטים של מוצרים, להדמיות ולסצנות פשוטות. הוא מעדיף תאורה אחידה וקומפוזיציה חזיתית, עם הנחיות טקסט וקלטי תמונה או סגנון אופציונליים לכיוון חזותי צפוי. - [**Ailoot Ultra · תמונות** `POST /v1/images/generations` `recraft/recraft-v4.1-utility`](https://ailoot.ai/models/he/recraft-recraft-v4-1-utility/#method-0) על המודל התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה. Recraft V4.1 Utility הוא מודל הרסטר הרגיל Utility במשפחת V4.1 של Recraft. הוא מעדיף סצנות פשוטות, תאורה אחידה וקומפוזיציה חזיתית על פני בחירות הזווית, התאורה והאווירה בעלות ההבעה הרבות יותר של מודל V4.1 המרכזי. תפקידו המעשי הוא שוט מוצר ברור או הדמיה שבה העצם והפרטים הנחוצים צריכים לשלוט. מהדורת Utility המדויקת נפרדת מ־Utility Pro, ממודל V4.1 המרכזי ומהווריאנטים הווקטוריים המפיקים SVG. קוד המודל של היצרן הוא recraftv4\_1\_utility. הוא מחזיר תמונות רסטר ב־1K בפורמט WebP ללא אובדן או PNG, עם גדלים שנבחרים מתוך יחסי הממדים הנתמכים. תמונה ריבועית היא 1024 × 1024 פיקסלים ותמונת 4:3 היא 1216 × 896. מהדורת Pro Utility משתמשת בממדי 2K גדולים יותר, ולכן אין לייחס את גדלי הפלט האלה ל־Utility הרגיל. בחרו את צורת הרשומה או ההדמיה המיועדת לפני תיאור הסצנה. בריף שימושי נוקב במוצר, בנקודת המבט, בחומר, במשטח, ברקע ובתאורה במונחים פשוטים. לרשומת מוצר, בקשו בקבוק מבודד במבט חזיתי על רקע בהיר, בתאורה אחידה, עם מלוא קווי המתאר גלויים וללא רכיבי סצנה מסיחים. אם למוצר יש ממדים עובדתיים או חלקים ייחודיים, ספקו את הפרטים האלה במפורש. ההעדפה של Utility להצגה פשוטה אינה מבססת עובדות על מוצר אמיתי שלא הופיעו בבריף. היצירה תומכת בהנחיות של עד 10,000 תווים, בבקרות צבע מועדף וצבע רקע, בערך seed אקראי ובאחד עד שישה פלטים. סגנונות מותאמים תואמים או תמונות ייחוס אופציונליים יכולים להנחות את השפה החזותית של קטלוג. השתמשו בנכסי ייחוס שמסכימים על התאורה ועל אופן ההמחשה, ושמרו על אותו סגנון תואם בבריפים הבאים למוצרים. התאמת צבע מדויקת בין הייחוס לפלט אינה מובטחת, לכן השוו את החזות הסופית לפלטה הנדרשת. ליצירה בסגנון ייחוס, השתמשו באחת עד עשר תמונות PNG, JPG או WebP, לא יותר מ־64 MB בסך הכול ופחות מ־20 MB לכל אחת. לכל ייחוס דרושה צלע קצרה של לפחות 256 פיקסלים, צלע ארוכה שאינה עולה על 4,096 פיקסלים ורזולוציה שאינה עולה על 16 מגה־פיקסלים. השתמשו בייחוסים האלה או בסגנון שמור תואם, ולא בשניהם יחד. ביצירה בסגנון ייחוס, התאמה גמישה מאפשרת פרשנות חופשית יותר, ואילו התאמה מדויקת עוקבת ביתר היצמדות אחר אופן ההמחשה, הפלטה, הקומפוזיציה והתאורה. תהליך תמונה־לתמונה הנפרד משתמש בתמונה קיימת ובהנחיה, עם עוצמה בין 0 ל־1 השולטת בהיקף השינוי. עוצמה נמוכה יותר שומרת את התוצאה קרובה יותר למקור; עוצמה גבוהה יותר מאפשרת לה להתרחק ממנו יותר. הקלט שלו יכול להיות PNG, JPG, WebP או SVG בגודל קטן מ־20 MB, עד 16 MP, עם צלעות בין 256 ל־4096 פיקסלים. סגנונות מותאמים של V4.1 אינם מתקבלים בפעולת השינוי הזו, הנפרדת מצירוף ייחוס סגנון ליצירה חדשה. V4.1 Utility אינו מקבל שמות סגנונות שנבחרו מראש או בקרות negative\_prompt, text\_layout, artistic\_level או no\_text. תארו ישירות את הסצנה המוגמרת הרצויה בהנחיה החיובית. לסדרת נכסי מוצר, שמרו על הוראות מסגור ורקע קבועות, ואז השוו כל תמונה לצורה, לחומר ולפרטים של המוצר שסופקו לפני שימוש בה בפריסה. Utility הרגיל הוא כלי רסטר ממוקד להצגה מאופקת; בחרו את פורמט הפלט ואת המהדורה המסוימים בהתאם למשימה. **Ailoot Ultra · תמונות** `POST /v1/images/generations` `recraft/recraft-v4.1-utility` [`recraft/recraft-v4.1-utility`](https://ailoot.ai/models/he/#m=recraft%2Frecraft-v4.1-utility&route=Ultra&caller=recraft%2Frecraft-v4.1-utility&fmt=images) Recraft /`recraft/recraft-v4.1-utility` ### התחלה Recraft V4.1 Utility יוצר תמונות רסטר ב־1K לשוטים פשוטים של מוצרים, להדמיות ולסצנות פשוטות. הוא מעדיף תאורה אחידה וקומפוזיציה חזיתית, עם הנחיות טקסט וקלטי תמונה או סגנון אופציונליים לכיוון חזותי צפוי. סוגי קלט נתמכים טקסט · תמונות תוצאות תמונות ### זמין ב-Ailoot · קלט ושיטות **Ailoot Ultra · תמונות** `POST /v1/images/generations` סוגי קלט `text`, `image` סוגי פלט `image` | שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל | | --- | --- | --- | --- | --- | | שדה`model` | סוג`string` | דרישהחובה | ערכים ומגבלות recraft/recraft-v4.1-utility | ברירת מחדל— | | שדה`prompt` | סוג`string` | דרישהחובה | ערכים ומגבלות אורך מזערי: ⁦1⁩ | ברירת מחדל— | | שדה`aspect_ratio` | סוג`string` | דרישהרשות | ערכים ומגבלות 1:1, 4:3, 3:4, 16:9, 9:16, auto | ברירת מחדל— | | שדה`n` | סוג`integer` | דרישהרשות | ערכים ומגבלות מינימום: ⁦1⁩ מקסימום: ⁦6⁩ | ברירת מחדל— | | שדה`input_references` | סוג`array` | דרישהרשות | ערכים ומגבלות מספר פריטים מזערי: ⁦0⁩ מספר פריטים מרבי: ⁦1⁩ | ברירת מחדל— | | שדה`provider` | סוג`object` | דרישהרשות | ערכים ומגבלות | ברירת מחדל— | פרמטרים ומחזור חיים של השיטה | פרמטר | מפרט | | --- | --- | | פרמטר`content_type` | מפרטapplication/json | | פרמטר`required` | מפרטmodel, prompt | | פרמטר`material_types` | מפרטtext, image | מחזור חיים: `synchronous_result_then_owned_library` `GET /v1/media/tasks/{task_id}` · ערך task\_id שהוחזר בפועל או רשומה בספריית המדיה `GET /v1/media/assets/{asset_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### תעריפים ##### אופן חישוב החיוב הסופי התעריפים המוצגים מספקים אומדן לעלות לפני היצירה. החיוב הסופי מחושב לפי העלות שנרשמה עבור היצירה המקורית. משך הפלט שנמדד והכמויות החזויות אינם הכמות הסופית לחיוב. מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה. מצב מהיר לא צוין כאשר נבחר מצב מהיר מצב Flex לא צוין כאשר נבחר מצב flex מאמץ חשיבה מרבי לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default) #### תעריפים משוערים להשוואה #### מחירים לפי תצורה התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות. | תצורה | טבלת תעריפים | כמות חזויה | יחידת חיוב | חיוב | | --- | --- | --- | --- | --- | | תצורהתעריפי בסיס לטוקנים | טבלת תעריפיםתעריף בסיס | כמות חזויה— | יחידת חיוב— | חיוב קלט · טוקני קלט · אומדן להשוואה בלבד **—** / 1K טוקנים פלט · טוקני פלט · אומדן להשוואה בלבד **—** / 1K טוקנים קלט · קריאה מהמטמון · אומדן להשוואה בלבד **—** / 1K טוקנים קלט · כתיבה למטמון · אומדן להשוואה בלבד **—** / 1K טוקנים קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד **—** / 1K טוקנים | | תצורהתמונת פלט | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל תמונה בפלט | חיוב פלט · תמונת פלט · אומדן להשוואה בלבד **$0.07** לכל תמונה בפלט | | תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | יחידת חיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד **$0.07** אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. | לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. [איך פועלים שריון הסכום והסדרת החיוב →](https://ailoot.ai/docs/he/billing/reserve/) ### דוגמאות לבקשות #### Ailoot Ultra · תמונות curl ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_REQUEST' import json,os from pathlib import Path p={'model': 'recraft/recraft-v4.1-utility', 'prompt': 'a red panda astronaut floating in space, studio lighting'} Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import base64, json, os, subprocess from pathlib import Path from urllib.parse import urlsplit, urljoin def save_images(items): if not items: raise SystemExit("No completed images; retain the full response") for index, item in enumerate(items): encoded=item.get("b64_json") uri=item.get("url", "") if not encoded and uri.startswith("data:image/"): header, separator, encoded=uri.partition(",") if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI") if encoded: raw=base64.b64decode(encoded,validate=True) elif uri: uri=urljoin("https://api.ailoot.ai",uri) parsed=urlsplit(uri) if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password: raise SystemExit("Invalid returned image URL") owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content") args=["curl","--fail-with-body","--silent","--show-error",uri] if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]] temporary=Path(f"image-{index}.bin") subprocess.run(args+["-o",str(temporary)],check=True) raw=temporary.read_bytes() temporary.unlink() else: raise SystemExit("Image has neither bytes nor URL") if not raw: raise SystemExit("Empty image result") ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"