מודלים

Recraft: Recraft V4 Styles

Markdown · JSON

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 /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 · תמונות

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={'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}/content
  • GET /v1/media/assets
  • GET /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

recraft/recraft-v4-styles

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

פרטים נוספים

חברו Ailoot ל- Claude Code, OpenCode, Hermes או ליישום שלכם.

החברה ופורטפוליו הפרויקטים שלה

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

קנו אסימונים בהנחה.

הנחת מנוי לעבודה קבועה. קודי הנחה עד 50% על רכישת אסימונים.

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

בחירת מנוי · מחירי מודלים

חברו API למוצר שאתם מוכרים.

SaaS, יישומים ובוטים לפי ההצעה והסכם הרישוי של Ailoot. למכירה מחדש בקשו רישיון משווק.

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

בקשת רישיון למכירה מחדש · ההצעה והסכם הרישוי