Recraft: Recraft V4.1

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

Ailoot Ultra · תמונות POST /v1/images/generations recraft/recraft-v4.1

על המודל

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

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

קוד היצרן המדויק הוא recraftv4_1. הוא מחזיר תמונות רסטר ב־1K בפורמט WebP ללא אובדן או PNG, עם פלט ריבועי ב־1024 × 1024 פיקסלים ו־16:9 ב־1344 × 768. יחסים נתמכים אחרים משתמשים בממדים משלהם. V4.1 Pro הוא מהדורת הרסטר הנפרדת ב־2K, Vector מחזיר SVG הניתן לעריכה, ו־Utility מעדיף תאורה וסצנות פשוטות יותר. הענפים האלה משרתים תוצרים שונים ואין למזג אותם למערך אחד של תכונות פלט.

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

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

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

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

Ailoot Ultra · תמונות POST /v1/images/generations recraft/recraft-v4.1

recraft/recraft-v4.1

Recraft /recraft/recraft-v4.1

התחלה

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

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

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

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

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות recraft/recraft-v4.1	ברירת מחדל—
שדה`prompt`	סוג`string`	דרישהחובה	ערכים ומגבלות אורך מזערי: ⁦1⁩	ברירת מחדל—
שדה`aspect_ratio`	סוג`string`	דרישהרשות	ערכים ומגבלות 1:1, 4:3, 3:4, 16:9, 9:16, auto	ברירת מחדל—
שדה`n`	סוג`integer`	דרישהרשות	ערכים ומגבלות מינימום: ⁦1⁩ מקסימום: ⁦6⁩	ברירת מחדל—
שדה`input_references`	סוג`array`	דרישהרשות	ערכים ומגבלות מספר פריטים מזערי: ⁦0⁩ מספר פריטים מרבי: ⁦1⁩	ברירת מחדל—
שדה`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.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.1', '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.1

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

/v1/images

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

recraft/recraft-v4.1

FAQ · Recraft: Recraft V4.1

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

Recraft: Recraft V4.1