Source: https://ailoot.ai/models/he/recraft-recraft-v3/ Canonical: https://ailoot.ai/models/he/recraft-recraft-v3/ Language: he # Recraft: Recraft V3 [Markdown](https://ailoot.ai/models/he/recraft-recraft-v3/index.md) · [JSON](https://ailoot.ai/models/he/recraft-recraft-v3/facts.json) ## [Recraft: Recraft V3](https://ailoot.ai/models/he/recraft-recraft-v3/) Recraft V3 יוצר צילומים, איורים ופריסות גרפיות עם קומפוזיציה מודעת לטקסט ובקרות סגנון. וריאנטי הרסטר וה־SVG הנפרדים שלו מתאימים לכרזות, למערכי תמונות ממותגים, לאייקונים ולעיצובים שבהם הניסוח והמבנה החזותי צריכים לעבוד יחד. - [**Ailoot Ultra · תמונות** `POST /v1/images/generations` `recraft/recraft-v3`](https://ailoot.ai/models/he/recraft-recraft-v3/#method-0) על המודל התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה. Recraft V3 הוא מודל ליצירת תמונות שנבנה לעיצוב גרפי וגם לסצנות צילומיות ומאוירות. בריף כתוב מתאר את הנושא, הסביבה והקומפוזיציה; התוצאה היא תמונה. V3 מפתח את רינדור הטקסט ואת הפוטוריאליזם של Recraft תוך שמירה על עקביות סגנון מתמונות דוגמה ללא אימון מחדש. #### טקסט כחלק מהקומפוזיציה V3 עובד עם טקסט בתוך התמונה, לרבות טקסט ארוך יותר וכיתוב בגודל בינוני. Recraft מתארת שלב פריסה שקובע מילים ואת מיקומן לפני יצירת התמונה. אפשר להפיק את הפריסה אוטומטית מהבריף או לסדר אותה ידנית בסביבת העיצוב של Recraft. הדבר עוזר לחבר כותרת, איור וטקסט תומך בתוך קומפוזיציה אחת. היצרן מתעד גם קואורדינטות מפורשות לפריסת טקסט, המבוטאות ביחס לתמונה ולא כרשת פיקסלים קבועה. כל רכיב טקסט מכיל מילה יחידה וארבע נקודות פינה בקואורדינטות מנורמלות: (0, 0) היא הפינה השמאלית העליונה ו־(1, 1) היא הימנית התחתונה. קואורדינטות יכולות לחרוג מהטווח הזה, ובמקרה כזה הצורה נחתכת. מילים בפריסת טקסט מפורשת חייבות לעמוד בהגבלות התווים המתועדות. לכרזה או לכריכה, ספקו את הניסוח המדויק ותארו את ההיררכיה שלו: איזו שורה מובילה, היכן היא יושבת וכיצד התמונה תומכת בה. בדקו את האיות ואת הריווח שנוצרו בעת בחירת תוצאה. #### סגנון, פלטה וכיוון אמנותי V3 כולל סגנונות צילום, איור וסמלים שנבחרו מראש, לצד ספריית סגנונות וקטוריים נפרדת. Recraft V3 Raw הוא סגנון ברירת המחדל של מודל הרסטר; Vector art הוא ברירת המחדל של הווריאנט הווקטורי. Photorealism מכוון למראה צילומי, ואילו Illustration מתאים למרקמים מסוגננים, להצללה ולמעברי צבע מורכבים יותר. סגנונות וקטוריים מעדיפים צורות, פלטות מוגבלות ומילויים שטוחים או מעברי צבע פשוטים. אפשר לבנות סגנונות מותאמים מתמונות ייחוס, מסגנונות תואמים קיימים או משילוב שלהם. הם מספקים כיוון חזותי לשימוש חוזר לאורך סדרת תמונות. בקרות הערבוב המתועדות מאפשרות לייחוסים ולסגנונות מקור לשאת משקלים נפרדים; מספר המשקלים תואם למספר המקורות. PaletteMatch ו־MaxWeight הן שתי מדיניויות הערבוב המופיעות. היצרן מאפשר עד 10 תמונות ייחוס לסגנון ומשתמש במצב התאמת הסגנון הרגיל ל־V3. סגנון מותאם שמור וייחוסי סגנון ישירים הם קלטים חלופיים, וסגנון מותאם חייב להתאים למודל המשמש ליצירה. צבעים מועדפים וצבע רקע מנחים את הפלטה. מתועדים עד 10 צבעי RGB, עם כל רכיב בין 0 ל־255. משקלים יחסיים אופציונליים נעים בין 0 ל־1; יש לספק אותם לכל צבע או לאף אחד, וסכומם אינו יכול לעלות על 1. הרמה האמנותית נעה בין 0 לטיפול סטטי ונקי לבין 5 לקומפוזיציות דינמיות וחריגות יותר. הנחיה שלילית מתארת רכיבים לא רצויים; בקרה נפרדת ללא טקסט משביתה פריסות טקסט מוטמעות. ערך seed אקראי זמין לשחזור. הבקרות האלה מספקות מנופים שונים לסצנה, לסגנון שלה ולפריסה החזותית שלה. #### תמונות רסטר ווריאנט SVG נפרד Recraft מתעדת שני וריאנטים של V3. מודל הרסטר מפיק WebP ללא אובדן או PNG ומתאים לפרטים צילומיים, להצללה ולאיור בעל מרקם. Recraft V3 Vector מפיק SVG: נתיבים וצורות שיכולים לשנות קנה מידה ללא רזולוציית פיקסלים קבועה. הוא מתאים לפיקטוגרמות, לקונספטים ללוגו, לתגים וליצירה וקטורית מפורטת. המרת רסטר לווקטור היא פעולה נפרדת מיצירת יצירה וקטורית ישירות. לשני הווריאנטים יש זהות משלהם. תמונה בעלת מראה וקטורי ופלט SVG בפועל הם בחירות שונות. בחרו את הפלט המיועד בעת הכנת תהליך עיצוב, במקום להתייחס לשם V3 המשותף כהוכחה שכל פעולה מחזירה אותו סוג קובץ. #### עריכה וגימור של יצירה קיימת התיעוד של Recraft ל־V3 מציין יצירה מתמונה לתמונה, מילוי אזורים בתמונה, הרחבת תמונה והחלפת רקע או יצירתו. עבודה מתמונה לתמונה משלבת תמונה קיימת עם בריף חדש. מילוי אזורים בתמונה יוצר מחדש את האזור שנבחר באמצעות תמונה ומסכה תואמת; הרחבת תמונה מוסיפה תוכן מחוץ למסגרת המקורית. פעולות רקע מטפלות בסביבה של נושא. ערכת הכלים הנלווית כוללת גם מחיקה, הסרת רקע, וקטוריזציה ושתי גישות להגדלת רזולוציה. הגדלה יצירתית יכולה להוסיף פרטים חדשים; הגדלה חדה מכוונת לגרסה גדולה וחדה יותר של תוכן קיים. אלה פעולות נפרדות עם קלטים ותוצאות משלהן, ולא משמעויות נוספות של שם מודל הרסטר או הווקטור. #### מגבלות הנחיה, גודל ותמונת מקור מפרט היצירה של V3 אצל היצרן מקבל הנחיה של עד 1000 תווים ו־1–6 תמונות לבקשה. הוא תומך ב־14 יחסי ממדים: 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 6:10, 14:10, 10:14, 16:9 ו־9:16. דוגמאות הרסטר המתועדות כוללות 1024x1024, 1820x1024 ו־1024x1820. ממדי רסטר מדויקים חייבים להיות מהרשימה הנתמכת; SVG משתמש ביחסי ממדים ללא גודל פיקסלים קבוע. כאשר הגודל אינו מצוין, מערכת היצרן בוחרת אותו מתוך ההנחיה. לפעולות עם קלט תמונה, היצרן מציין PNG, JPG ו־WebP, עם SVG כאשר הפעולה המסוימת מאפשרת אותו. קבצים חייבים להיות קטנים מ־20 MB, לא יותר מ־16 MP, עם צלע ארוכה של לכל היותר 4096 פיקסלים. הצלע הקצרה היא לפחות 256 פיקסלים, עם חריג של 32 פיקסלים להגדלה חדה. מסכות תואמות לגודל התמונה ומשתמשות בשחור ולבן טהורים; לייחוסי סגנון יש מגבלה משולבת של 64 MB. לפרויקט Ailoot API, הפכו את המשימה לבריף תמונה ממוקד: הטקסט המדויק, סידור העצמים, הסגנון החזותי והקומפוזיציה הרצויה. כרזה, סצנת מוצר וסדרת אייקונים דורשים בריפים שונים; שמרו על ההבחנות הרלוונטיות בין וריאנטים ופעולות של V3 בעת ההחלטה כיצד כל תוצאה תשמש. **Ailoot Ultra · תמונות** `POST /v1/images/generations` `recraft/recraft-v3` [`recraft/recraft-v3`](https://ailoot.ai/models/he/#m=recraft%2Frecraft-v3&route=Ultra&caller=recraft%2Frecraft-v3&fmt=images) Recraft /`recraft/recraft-v3` ### התחלה Recraft V3 יוצר צילומים, איורים ופריסות גרפיות עם קומפוזיציה מודעת לטקסט ובקרות סגנון. וריאנטי הרסטר וה־SVG הנפרדים שלו מתאימים לכרזות, למערכי תמונות ממותגים, לאייקונים ולעיצובים שבהם הניסוח והמבנה החזותי צריכים לעבוד יחד. סוגי קלט נתמכים טקסט · תמונות תוצאות תמונות ### זמין ב-Ailoot · קלט ושיטות **Ailoot Ultra · תמונות** `POST /v1/images/generations` סוגי קלט `text`, `image` סוגי פלט `image` פורמט פלט קובץ תמונה | שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל | | --- | --- | --- | --- | --- | | שדה`model` | סוג`string` | דרישהחובה | ערכים ומגבלות recraft/recraft-v3 | ברירת מחדל— | | שדה`prompt` | סוג`string` | דרישהחובה | ערכים ומגבלות אורך מזערי: ⁦1⁩ | ברירת מחדל— | | שדה`n` | סוג`integer` | דרישהרשות | ערכים ומגבלות מינימום: ⁦1⁩ מקסימום: ⁦6⁩ | ברירת מחדל— | | שדה`aspect_ratio` | סוג`string` | דרישהרשות | ערכים ומגבלות 1:1, 4:3, 3:4, 16:9, 9:16, auto | ברירת מחדל— | | שדה`input_references` | סוג`array` | דרישהרשות | ערכים ומגבלות מספר פריטים מזערי: ⁦0⁩ מספר פריטים מרבי: ⁦1⁩ | ברירת מחדל— | שילובים של חומרי קלט **מטקסט לתמונה** · נדרש: prompt פרמטרים ומחזור חיים של השיטה | פרמטר | מפרט | | --- | --- | | פרמטר`content_type` | מפרטapplication/json | | פרמטר`required` | מפרטmodel, prompt | | פרמטר`material_types` | מפרטtext, image | | פרמטר`optional_controls` | מפרטaspect\_ratio, n, input\_references | | פרמטר`exact_supported_parameters` | מפרט{"aspect\_ratio":{"type":"enum","values":\["1:1","4:3","3:4","16:9","9:16","auto"\]},"n":{"type":"range","min":1,"max":6},"input\_references":{"type":"range","min":0,"max":1}} | | פרמטר`reference_material_rule` | מפרטרק תמונות עזר ממשיות של הלקוח; חלים עליהן התנאים של נקודת הקצה אצל הספק. | כינויים לשיטה: `/v1/images` מחזור חיים: `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 טוקנים | | תצורהUltra | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל תמונה בפלט | חיוב פלט · פלט תמונה · אומדן להשוואה בלבד **$0.08** לכל תמונה בפלט | | תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | יחידת חיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד **$0.08** אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. | לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. [איך פועלים שריון הסכום והסדרת החיוב →](https://ailoot.ai/docs/he/billing/reserve/) #### פרטי תעריף הייחוס טבלאות הייחוס ברמת המודל אינן משנות את בחירת השיטה, הצעות המחיר או החיובים. החיובים בפועל משתמשים בתעריפי שיטת Ailoot שנבחרה. תצורות תמחור תמונות #### מחירים לפי תצורה | תצורה | תנאי חיוב | חיוב | | --- | --- | --- | | תצורהתמונת פלט | תנאי חיובלא הוצהרה חלופת תמחור. | חיוב פלט · תמונת פלט **$0.08** לכל תמונה רישומים מקבילים מתארים את אותו חיוב; הם אינם מוסיפים עמלה שנייה. | ### דוגמאות לבקשות #### Ailoot Ultra · תמונות curlPython SDKNode.js SDK ```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-v3', '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"