Recraft: Recraft V4.1 Pro Vector

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

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

על המודל

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

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

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

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

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

Recraft מתעדת תהליך נפרד מתמונה לתמונה למודלי רסטר ווקטור של V4.1. הוא משלב תמונה קיימת והנחיה, כאשר strength בין 0 ל־1 שולט במידת ההתרחקות של התוצאה החדשה מהמקור. strength נמוך נשאר קרוב יותר, וגבוה מאפשר שינוי גדול יותר. פעולה זו אינה מקבלת את בקרות הסגנון המותאם של V4/V4.1, ולכן יש להכין שינוי של תמונת מקור ויצירה לפי סגנון ייחוס כתהליכים נפרדים. קלט התמונה יכול להיות PNG, ‏JPG, ‏WebP או SVG במסגרת מגבלות התמונה המתועדות. בתהליך מתמונה לתמונה, ספקו PNG, ‏JPG, ‏WebP או SVG בנפח קטן מ־20 MB, עד 16 מגה־פיקסל, כששתי הצלעות בין 256 ל־4,096 פיקסלים.

V4.1 אינו תומך בבקרות שמות סגנון מאוצרים, negative_prompt, ‏text_layout, ‏artistic_level או no_text. הגדירו את הסידור והכיתוב המיועדים בתדריך החיובי במקום להסתמך על מנגנוני V3 ישנים. בנכס מותג מפורט, השתמשו ב־SVG כקובץ העבודה, בחנו את הגאומטריה והתאימו צבעים או צורות לפי הצורך לפני הצבתו בפריסה הסופית. מהדורת Pro Vector זו שומרת על זהותה; היא אינה ניתנת להחלפה עם גרסאות הרסטר הרגילות או Utility רק משום שהן חולקות את השם V4.1.

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

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

recraft/recraft-v4.1-pro-vector

אחר /recraft/recraft-v4.1-pro-vector

התחלה

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

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

Ailoot Ultra · Images POST /v1/images/generations

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

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

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

מטקסט לתמונה

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

פרמטר	מפרט
פרמטר`content_type`	מפרטapplication/json
פרמטר`required`	מפרטmodel, prompt
פרמטר`optional`	מפרטn, aspect_ratio, output_format, input_references, 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.6 לכל תמונה בפלט
תצורהעלות יצירה משוערת	טבלת תעריפים—	כמות חזויהאומדן ליצירה אחת	יחידת חיוב—	חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.6 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה.

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

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

Ailoot Ultra · Images

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

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=json.loads('{"model": "recraft/recraft-v4.1-pro-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field."}')

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.1-pro-vector

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

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

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

recraft/recraft-v4.1-pro-vector

FAQ · Recraft: Recraft V4.1 Pro Vector

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

Recraft: Recraft V4.1 Pro Vector