Recraft: Recraft V4 Styles Pro Vector

Recraft V4 Styles Pro Vector הוא מהדורת ה־SVG מסוג Pro במשפחת יצירת התמונות בסגנון עקבי של Recraft. הוא יוצר גרפיקה וקטורית הניתנת לעריכה מתוך תדריך טקסטואלי וסגנון ייחוס נדרש, לאיורי מותג מפורטים, לכיתוב ולנכסים גרפיים מתואמים.

Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-styles-pro-vector

על המודל

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

Recraft V4 Styles Pro Vector הוא מודל הווקטור Pro במשפחת V4 Styles הייעודית. מטרתו ליצור עבודות SVG חדשות שהטיפול החזותי בהן עוקב אחר סגנון ייחוס מצורף. המודל משלב תיאור טקסטואלי של מה לצייר עם מקורות ייחוס הקובעים כיצד הדבר אמור להיראות. העבודה המעשית כוללת איורי מותג, רעיונות כיתוב ונכסים גרפיים מתואמים שבהם המרקם, העיבוד החזותי, היגיון הצבע והקומפוזיציה זקוקים לכיוון משותף.

קוד המודל המדויק של היצרן הוא recraftv4_styles_pro_vector, והוא נפרד הן ממודל Styles Vector הרגיל והן ממודל הרסטר Styles Pro. הוא מחזיר SVG הניתן לעריכה. מסמך המידות של היצרן מציין במפורש שלפלטים וקטוריים אין מידות פיקסלים קבועות ושהם מקבלים יחסי ממדים בלבד, ולכן מידות הרסטר 2K של Styles Pro אינן הבטחת רזולוציית פיקסלים למהדורת Pro Vector זו. התווית Pro שייכת לגרסת הווקטור ששמה מצוין; הכינו את העבודה לגאומטריה ולשימוש המיועדים שלה במקום להתייחס אליה כתמונת רסטר מוגדלת.

כל יצירה ב־Styles זקוקה לסגנון. סגנון שמור תואם או תמונה אחת עד עשר בפורמט PNG, ‏JPG או WebP יכולים לספק אותו; אלו שתי חלופות קלט. בתהליך המתועד, כל תמונת ייחוס חייבת להיות בנפח קטן מ־20 MB, והנפח הכולל לא יעלה על 64 MB. העדיפו איור אחד נקי כאשר הכיוון שלו כבר ברור. אם נחוצים כמה מקורות ייחוס, בחרו נכסים עם צורה, צבעים ועיבוד עקביים, כדי שהמודל יכליל את השפה החזותית במקום להרכיב מוטיבים מתחרים. הצלע הקצרה של כל תמונת ייחוס חייבת להיות באורך 256 פיקסלים לפחות, הצלע הארוכה עד 4,096 פיקסלים והרזולוציה הכוללת עד 16 מגה־פיקסל.

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

היצרן תומך בבקרות לצבעים מועדפים ולצבע רקע, ב־seed אקראי, בהנחיות של עד 10,000 תווים ובהפקת אחד עד שישה פלטים בכל יצירה. התוצאה הווקטורית שלו נשארת SVG ללא תלות בהגדרת image_format של רסטר. קו Styles הייעודי אינו תומך בתמונה לתמונה או ב־inpainting, ואינו מקבל את מנגנוני הסגנון המאוצר, negative_prompt או text_layout הישנים. התאמת ייחוס ועריכת ציור קיים הן אפוא פעולות שונות, ולא משמעויות חלופיות של קלט תמונה.

השתמשו במקורות ייחוס ברורים ברזולוציה גבוהה; שחזור צבע מדויק אינו מובטח. השאירו בתדריך את השימוש המיועד גלוי: לוגו זקוק לצורות קריאות בגודל קטן, בעוד איור מערכתי עשוי לאפשר יותר פרטים. בדקו את הכיתוב, המרווחים, הצלליות ואזורי הצבע של ה־SVG בקומפוזיציית היעד, ואז חדדו את תדריך הטקסט כאשר יש לשנות נושא או פריסה. השתמשו שוב באותו סגנון תואם לנכסים הבאים במקום להוסיף תמונות ייחוס לא קשורות כדי לכפות גיוון.

דרך Ailoot, בחרו את מזהה המודל המדויק הזה ב־/v1/images/generations וספקו את הנחיית היצירה. שמרו כל רשומת data שהוחזרה, בין שהתשובה מכילה URL ובין שהיא מכילה תוכן תמונה מקודד, ושמרו את הבתים בפועל עם סוג התוכן שהוחזר עבורם. שמרו usage וכל task_id של המדיה עם הנכס, ואז בדקו את צורותיו, הכיתוב ואזורי הצבע שלו בעיצוב המיועד.

Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-styles-pro-vector

recraft/recraft-v4-styles-pro-vector

אחר /recraft/recraft-v4-styles-pro-vector

התחלה

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

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

Ailoot Ultra · Images POST /v1/images/generations

סוגי קלט: text, image
סוגי פלט: image
פורמט פלט: קובץ תמונה

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות recraft/recraft-v4-styles-pro-vector תנאים: השתמשו בבורר הניתוב הזה של Ailoot בדיוק כפי שהוא.	ברירת מחדל—
שדה`prompt`	סוג`string`	דרישהחובה	ערכים ומגבלות תנאים:	ברירת מחדל—
שדה`n`	סוג`integer`	דרישהרשות	ערכים ומגבלות מינימום: ⁦1⁩ מקסימום: ⁦6⁩ תנאים:	ברירת מחדל—
שדה`aspect_ratio`	סוג`string`	דרישהרשות	ערכים ומגבלות 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto תנאים:	ברירת מחדל—
שדה`output_format`	סוג`string`	דרישהרשות	ערכים ומגבלות svg תנאים:	ברירת מחדל—
שדה`input_references`	סוג`array`	דרישהחובה	ערכים ומגבלות תנאים:	ברירת מחדל—
שדה`quality`	סוג`string`	דרישהרשות	ערכים ומגבלות auto, low, medium, high, xhigh, max תנאים:	ברירת מחדל—

שילובים של חומרי קלט

reference_guided_image

פרמטרים ומחזור חיים של השיטה

פרמטר	מפרט
פרמטר`content_type`	מפרטapplication/json
פרמטר`required`	מפרטmodel, prompt, input_references
פרמטר`optional`	מפרטn, aspect_ratio, output_format, quality
פרמטר`material_types`	מפרטtext, image
פרמטר`conditions`	מפרטהשתמשו בבורר הניתוב הזה של Ailoot בדיוק כפי שהוא., איכות היא אפשרות בקרה משותפת ומתועדת; ספקים שאין אצלם אפשרות לכוונון איכות מתעלמים ממנה. אין הבטחה לשיפור איכות בכל מודל בנפרד.

מחזור חיים: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · ערך task_id שהוחזר בפועל או רשומת הספרייה שנבחרה; operation_id הוא מזהה נפרד

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

תעריפים

אופן חישוב החיוב הסופי

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

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

מצב מהיר: לא צוין כאשר נבחר מצב מהיר
מצב Flex: לא צוין כאשר נבחר מצב flex
מאמץ חשיבה מרבי: לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)

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

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

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

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

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

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

Ailoot Ultra · Images

curl · צרו פעם אחת ושמרו את התוצאה המלאה

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
: "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "recraft/recraft-v4-styles-pro-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field.", "input_references": [{"type": "image_url", "image_url": {"url": "YOUR_ACCESSIBLE_IMAGE_URL"}}]}')
p['input_references'][0]['image_url']['url']=os.environ['AILOOT_IMAGE_URL']
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
# Submit once. Retain the complete result, original identifiers and every response header.

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

Ailoot Ultra · Images

הורידו כל תמונה שהוחזרה או שמרו את תוכן ה-Base64 שלה

GET /v1/media/tasks/{task_id}
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

שמירת כל התוצאות שהושלמו

שמרו כל תמונה שהושלמה; אחזרו אותה מכל URL שהוחזר או פענחו את תוכן ה-Base64 שלה.

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

כשצריך לבדוק את התגובה המקורית

שמרו את X-Client-Request-ID המקורי, את התגובה ואת הכותרות. תוצאה לא ידועה או result_pending_check אינה מתירה יצירה נוספת.

שדות התגובה

שדה	סוג
שדה`data[].url`	סוגstring
שדה`data[].b64_json`	סוגstring
שדה`usage`	סוגobject

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

תגובה	תנאי	השלב הבא
תגובה⁦400⁩ · `invalid_request_error`	תנאישדה חובה, בורר המודל, סוג או ייצוג הקלט אינם תקינים.	השלב הבאבדקו את פרטי האימות שהוחזרו לפני הכנת בקשה נפרדת.
תגובה	תנאיהבקשה המקורית או התוצאה אינן ידועות או דורשות בדיקה.	השלב הבאשמרו את המזהים והכותרות המקוריים; קראו רק רשומות נתמכות של מצב או ספרייה. אל תשלחו שוב בקשת יצירה.

כינויים

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

Ailoot Ultra recraft/recraft-v4-styles-pro-vector

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

השתמשו בנתיבי השיטות המוצגים למעלה.

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

recraft/recraft-v4-styles-pro-vector

FAQ · Recraft: Recraft V4 Styles Pro Vector

אילו קלטים ותוצאות זמינים?: POST /v1/images/generations · recraft/recraft-v4-styles-pro-vector: text, image → image
באילו שדות הבקשה משתמשת?: POST /v1/images/generations · recraft/recraft-v4-styles-pro-vector: model, prompt, n, aspect_ratio, output_format, input_references, quality
אילו מגבלות חלות?: POST /v1/images/generations · recraft/recraft-v4-styles-pro-vector: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4 Styles Pro Vector