Recraft: Recraft V4 Styles Pro

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

Ailoot Ultra · תמונות POST /v1/images/generations recraft/recraft-v4-styles-pro

על המודל

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

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

Styles Pro מפיק פלט רסטר ב־2K, בפורמט WebP ללא אובדן או PNG. פלט ריבועי בטבלת הגדלים של היצרן הוא 2048 × 2048 פיקסלים, ואילו פלט 16:9 הוא 2688 × 1536; ליחסים נתמכים אחרים יש ממדים משלהם. הפלט הגדול יותר של Pro יכול להיות שימושי לחזות קמפיין מפורטת ולפריסות גדולות יותר. הווריאנטים הווקטוריים מפיקים במקום זאת SVG ואין להם גודל פיקסלים קבוע, לכן אין לבחור במהדורת רסטר Pro הזו כאשר התוצר המיועד הוא קובץ וקטורי הניתן לעריכה.

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

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

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

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

Ailoot Ultra · תמונות POST /v1/images/generations recraft/recraft-v4-styles-pro

recraft/recraft-v4-styles-pro

Recraft /recraft/recraft-v4-styles-pro

התחלה

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

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

Ailoot Ultra · תמונות POST /v1/images/generations

סוגי קלט: text, image
סוגי פלט: image

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות recraft/recraft-v4-styles-pro	ברירת מחדל—
שדה`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.2 לכל תמונה בפלט
תצורהעלות יצירה משוערת	טבלת תעריפים—	כמות חזויהאומדן ליצירה אחת	יחידת חיוב—	תנאי חיוב—	חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.2 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה.

לפני הבקשה 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-pro', '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-pro

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

/v1/images

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

recraft/recraft-v4-styles-pro

FAQ · Recraft: Recraft V4 Styles Pro

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

Recraft: Recraft V4 Styles Pro