Recraft: Recraft V4 Vector
Recraft V4 Vector יוצר סמלי לוגו, איורים ונכסים גרפיים ב־SVG הניתן לעריכה מתוך תדריך יצירתי. זו מהדורת הווקטור הרגילה של V4, עם גאומטריה הניתנת לשינוי קנה מידה, מקורות ייחוס אופציונליים לסגנון ותהליך נפרד ומתועד מתמונה לתמונה.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Recraft V4 Vector הוא המהדורה הרגילה המפיקה SVG של Recraft V4. הוא מיועד לגרפיקה התלויה בצורות ברורות, באזורי צבע ובקומפוזיציה, לרבות סמלי לוגו, מערכות אייקונים ואיורים. היצרן מתאר את V4 כמשפחה המתמקדת בעיצוב עם פירוש חזק של הנחיות הן בעבודת רסטר והן בעבודה וקטורית. התוצר של מהדורה זו הוא עבודת SVG הניתנת לעריכה ולהתאמה בתהליך עיצוב, במקום תמונת רסטר PNG או WebP.
המודל המדויק הוא recraftv4_vector, הנפרד מ־V4 Pro Vector ומגרסאות הרסטר של V4. מדריך המידות של היצרן מאפשר ארבעה־עשר יחסי רוחב לגובה לפלט וקטורי ומציין במפורש של־SVG אין מידות פיקסלים קבועות. בחרו את צורת הנכס באמצעות יחס ממדים, ואז את מיקומו ואת גודל התצוגה שלו בעיצוב הסופי. תווית 1K של מודל הרסטר V4 אינה מגדירה את הרזולוציה של גרסת SVG זו.
הנחיות הווקטור של V4 ממליצות להגדיר סוג גרפיקה, היגיון צורות, מערכת צבעים, כללי קווים ופריסה. באייקון קטן, ציינו את העצם ואת הצללית ההופכת אותו למזוהה. במערכת איורים, שמרו על כללי קו ומילוי יציבים בין תדריכים. באייקון משלוחים, בקשו רכב מסחרי בקווי מתאר עם פינות מעוגלות, צורת חבילה גדולה אחת וצבעים מאופקים, ממורכז בקומפוזיציה ריבועית. תארו את הגאומטריה במקום להוסיף פרטי משטח צילומיים כאשר התוצאה המיועדת היא גרפיקה שטוחה.
היצירה תומכת בהנחיות של עד 10,000 תווים, ב־seed אקראי, באחת עד שש תמונות ובבקרות לצבעים מועדפים ולצבע רקע. סגנונות תואמים או תמונות ייחוס אופציונליים יכולים להנחות את השפה החזותית באמצעות התאמה גמישה או מדויקת. תמונת ייחוס אינה מחליפה הוראות על הנושא או הפריסה החדשים. השתמשו בנכס ברור אחד או במערכת עקבית של מקורות ייחוס; התאמת צבע מדויקת לייחוס אינה מובטחת. ליצירה לפי סגנון ייחוס, השתמשו באחת עד עשר תמונות בפורמט PNG, JPG או WebP, בנפח כולל של עד 64 MB ופחות מ־20 MB לכל תמונה. הצלע הקצרה של כל תמונת ייחוס צריכה להיות באורך 256 פיקסלים לפחות, הצלע הארוכה באורך של עד 4,096 פיקסלים והרזולוציה עד 16 מגה־פיקסל. השתמשו בתמונות ייחוס אלו או בסגנון שמור תואם, ולא בשניהם יחד.
תהליך נפרד מתמונה לתמונה יכול להשתמש במודל וקטורי V4 להפקת SVG מתמונה קיימת ובקשת שינוי טקסטואלית. הגדרת strength הנדרשת נעה בין 0 ל־1: ערכים נמוכים נשארים קרובים יותר למקור, בעוד ערכים גבוהים מאפשרים שינוי גדול יותר. הפעולה מקבלת PNG, JPG, WebP או SVG במסגרת מגבלות הנפח והרזולוציה המתועדות ואינה מקבלת את בקרות הסגנון של V4. ההבחנה הזו חשובה בבחירה אם תמונה צריכה לספק תוכן לשינוי או רק את הטיפול החזותי עבור נכס חדש. בתהליך מתמונה לתמונה, ספקו PNG, JPG, WebP או SVG בנפח קטן מ־20 MB, עד 16 מגה־פיקסל, כששתי הצלעות בין 256 ל־4,096 פיקסלים.
מסמך היצירה הנוכחי של V4 אינו כולל שמות סגנון מאוצרים, negative_prompt, text_layout, artistic_level ו־no_text. הציבו בתדריך החיובי את המבנה והנוסח המיועדים. בתוצאת לוגו או כיתוב, בדקו את ה־SVG בגדלים קטנים וגדולים כדי לבחון מרווחים, קריאות ופרטים לא רצויים. הגדירו במפורש את ההיררכיה הטיפוגרפית ואת הצורות הגאומטריות, ואז השלימו את הנכס הווקטורי ומקמו אותו לפי תדריך העיצוב.
דרך Ailoot, בחרו את מזהה המודל המדויק הזה ב־/v1/images/generations וספקו את הנחיית היצירה. שמרו כל רשומת data שהוחזרה, בין שהתשובה מכילה URL ובין שהיא מכילה תוכן תמונה מקודד, ושמרו את הבתים בפועל עם סוג התוכן שהוחזר עבורם. שמרו usage וכל task_id של המדיה עם הנכס, ואז בדקו את צורותיו, הכיתוב ואזורי הצבע שלו בעיצוב המיועד.
Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-vector
recraft/recraft-v4-vectorהתחלה
Recraft V4 Vector יוצר סמלי לוגו, איורים ונכסים גרפיים ב־SVG הניתן לעריכה מתוך תדריך יצירתי. זו מהדורת הווקטור הרגילה של V4, עם גאומטריה הניתנת לשינוי קנה מידה, מקורות ייחוס אופציונליים לסגנון ותהליך נפרד ומתועד מתמונה לתמונה.
- סוגי קלט נתמכים
- טקסט · תמונות
- תוצאות
- תמונות
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · Images POST /v1/images/generations
- סוגי קלט
text,image- סוגי פלט
image- פורמט פלט
- קובץ תמונה
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות recraft/recraft-v4-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.16 לכל תמונה בפלט |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | יחידת חיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.16 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
דוגמאות לבקשות
Ailoot Ultra · Images
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-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/assetsGET /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-vector
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
FAQ · Recraft: Recraft V4 Vector
- אילו קלטים ותוצאות זמינים?
POST /v1/images/generations·recraft/recraft-v4-vector:text,image→image- באילו שדות הבקשה משתמשת?
POST /v1/images/generations·recraft/recraft-v4-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- אילו מגבלות חלות?
POST /v1/images/generations·recraft/recraft-v4-vector:n.minimum:1;n.maximum:6