Recraft: Recraft V4 Styles
Recraft V4 Styles יוצר תמונות רסטר ב־1K בסגנון חזותי המוגדר באמצעות ייחוסים. הוא מיועד לעבודת מותג וקמפיין יומיומית שבה כל נושא חדש צריך לשמור על אותו אופן המחשה, מרקם ומראה כללי.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Recraft V4 Styles הוא מהדורת הרסטר הרגילה של משפחת היצירה הייעודית לעקביות סגנון של Recraft. הוא יוצר תמונה חדשה מהנחיה טקסטואלית תוך מעקב אחר סגנון שנקבע באמצעות נכסי ייחוס. המודל שימושי לסדרת איורים, באנרים או סצנות מוצר שצריכים לחלוק טיפול חזותי מזוהה. הייחוס נושא את אופן ההמחשה, המרקם והיגיון הצבע; ההנחיה מציגה את הנושא ואת הסצנה של כל נכס חדש.
היצרן מציין פלט רסטר ב־1K בפורמט WebP ללא אובדן או PNG. הגודל הריבועי הוא 1024 × 1024 פיקסלים, והגודל המתועד של 16:9 הוא 1344 × 768; יחסים לאורך ויחסים נתמכים אחרים משתמשים בגדלים משלהם. המהדורה הזו נפרדת מפלט הרסטר ב־2K של Styles Pro וממודלי Vector המפיקים SVG. בחרו את יחס הממדים לפריסה הסופית במקום להניח שהתווית 1K אומרת שלכל תמונה אותו רוחב וגובה.
סגנון הוא חובה. השתמשו באחד עד עשרה ייחוסים בפורמט PNG, JPG או WebP, או בסגנון תואם שנשמר מיצירת סגנון קודמת. תהליך העבודה המתועד אינו מקבל מזהה סגנון שמור וייחוסים חדשים יחד. ייחוסים יכולים להיות נכסי מותג או קמפיין קיימים ולא בהכרח תמונות שנוצרו במקור ב־Recraft. עליהם להיות קטנים מ־20 MB לקובץ ולא יותר מ־64 MB יחד. אין משימת אימון נפרדת שהמשתמש צריך להריץ לפני שאפשר להשתמש בסגנון. לכל ייחוס חייבת להיות צלע קצרה של לפחות 256 פיקסלים, צלע ארוכה שאינה עולה על 4,096 פיקסלים ורזולוציה כוללת שאינה עולה על 16 מגה־פיקסלים.
התחילו בייחוס חזק אחד, או בכמה ייחוסים שכבר מסכימים על השפה החזותית. ייחוסים עקביים עוזרים להחיל את הסגנון מעבר לעצם או לתנוחה אחת; לוח השראה שאינו קשור יכול להכניס מוטיבים מתחרים. התאמה גמישה היא ברירת המחדל ומשאירה יותר מרחב פרשנות; התאמה מדויקת עוקבת ביתר היצמדות אחר אופן ההמחשה, הפלטה, הקומפוזיציה והתאורה של הייחוס. שחזור צבע מדויק עדיין אינו מובטח.
לסדרת באנרים, תארו שליח המניח חבילה על מפתן דלת, קומפוזיציה אופקית רגועה ומרחב פתוח בצד אחד לטקסט בהמשך. בריפים עוקבים יכולים לשנות את האירוע או את זווית המצלמה תוך שמירה על אותו סגנון. היצרן מתיר הנחיות של עד 10,000 תווים, צבעים מועדפים, צבע רקע רצוי, ערך seed אקראי ואחת עד שש תמונות. הוא אינו תומך ב־negative_prompt, בשמות סגנונות שנבחרו מראש או ב־text_layout, לכן תארו את הנושא ואת הפריסה הרצויים ישירות בבריף.
קו Styles אינו מציע תמונה־לתמונה או מילוי אזורים בתמונה. ייחוס סגנון מנחה תמונה חדשה שנוצרת, ולא מבטיח שימור של העצמים או הפיקסלים שבייחוס. אם המערך נראה חזרתי, תקנו תנוחה, פעולה, מסגור או פרטי סצנה במקום להוסיף ייחוס סותר. העריכו כל תוצאה בפריסה המיועדת מבחינת בהירות הנושא, מרחב שימושי ואופן המחשה מגובש, ואז שמרו על אותו סגנון תואם לנכס הבא. כך המודל מעשי לשפה חזותית חוזרת עם תוכן משתנה.
Ailoot Ultra · תמונות POST /v1/images/generations recraft/recraft-v4-styles
recraft/recraft-v4-stylesהתחלה
Recraft V4 Styles יוצר תמונות רסטר ב־1K בסגנון חזותי המוגדר באמצעות ייחוסים. הוא מיועד לעבודת מותג וקמפיין יומיומית שבה כל נושא חדש צריך לשמור על אותו אופן המחשה, מרקם ומראה כללי.
- סוגי קלט נתמכים
- טקסט · תמונות
- תוצאות
- תמונות
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · תמונות POST /v1/images/generations
- סוגי קלט
text,image- סוגי פלט
image
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות recraft/recraft-v4-styles | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות אורך מזערי: 1 | ברירת מחדל— |
שדה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 | ברירת מחדל— |
שדהn | סוגinteger | דרישהרשות | ערכים ומגבלות מינימום: 1 מקסימום: 6 | ברירת מחדל— |
שדהinput_references | סוגarray | דרישהרשות | ערכים ומגבלות מספר פריטים מזערי: 1 מספר פריטים מרבי: 10 | ברירת מחדל— |
שדה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.01 לכל בקשה |
| תצורהתמונת פלט | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל תמונה בפלט | תנאי חיוב— | חיוב פלט · תמונת פלט · אומדן להשוואה בלבד $0.07 לכל תמונה בפלט |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | יחידת חיוב— | תנאי חיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.07 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
דוגמאות לבקשות
Ailoot Ultra · תמונות
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-styles', '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"<svg",b"<?xml")) else "bin"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
קבלה ושמירה של תוצאות
Ailoot Ultra · תמונות
הורידו כל תמונה שהוחזרה או שמרו את תוכן ה-Base64 שלה
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
קריאות תוכן נוספות
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
שמירת כל התוצאות שהושלמו
שמרו כל תמונה שהושלמה; אחזרו אותה מכל URL שהוחזר או פענחו את תוכן ה-Base64 שלה.
שמרו את התשובה המלאה ואת הכותרות, כל פלט שהתקבל בפועל, את המזהים המקוריים שהוחזרו ואת כל שדות השימוש. שחזרו את הפעולה המקורית בלי לשלוח שוב בקשת יצירה.
כשצריך לבדוק את התגובה המקורית
שמרו את X-Client-Request-ID שהוחזר לצורך התאמת רישומים. קראו רק ערכי task_id/asset_id שהוחזרו בפועל או את ספריית המדיה שבבעלותכם; לעולם אל תבנו URL של משימה ממזהה הפעולה ואל תשלחו שוב בקשת יצירה.
שדות התגובה
| שדה | סוג |
|---|---|
שדהcreated | סוג |
שדהdata[].url | סוג |
שדהdata[].b64_json | סוג |
שדהusage | סוג |
כינויים
כינויים למודל
Ailoot Ultra recraft/recraft-v4-styles
כינויים לנתיבי שיטות
/v1/images
מזהי מודלים קשורים IDs
FAQ · Recraft: Recraft V4 Styles
- אילו קלטים ותוצאות זמינים?
POST /v1/images/generations·recraft/recraft-v4-styles:text,image→image- באילו שדות הבקשה משתמשת?
POST /v1/images/generations·recraft/recraft-v4-styles:model,prompt,aspect_ratio,n,input_references,provider- אילו מגבלות חלות?
POST /v1/images/generations·recraft/recraft-v4-styles:n.minimum:1;n.maximum:6