Sourceful: Riverflow V2 Pro

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

Ailoot Ultra · תמונות POST /v1/images/generations sourceful/riverflow-v2-pro

על המודל

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

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

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

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

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

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

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

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

Ailoot Ultra · תמונות POST /v1/images/generations sourceful/riverflow-v2-pro

sourceful/riverflow-v2-pro

Sourceful /sourceful/riverflow-v2-pro

התחלה

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

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

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

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

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות sourceful/riverflow-v2-pro	ברירת מחדל—
שדה`prompt`	סוג`string`	דרישהחובה	ערכים ומגבלות אורך מזערי: ⁦1⁩	ברירת מחדל—
שדה`resolution`	סוג`string`	דרישהרשות	ערכים ומגבלות 1K, 2K, 4K	ברירת מחדל—
שדה`aspect_ratio`	סוג`string`	דרישהרשות	ערכים ומגבלות 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	ברירת מחדל—
שדה`n`	סוג`integer`	דרישהרשות	ערכים ומגבלות מינימום: ⁦1⁩ מקסימום: ⁦1⁩	ברירת מחדל—
שדה`input_references`	סוג`array`	דרישהרשות	ערכים ומגבלות מספר פריטים מזערי: ⁦0⁩ מספר פריטים מרבי: ⁦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.06 לכל תמונה
תצורהחומר עזר בקלט	טבלת תעריפים—	כמות חזויה—	יחידת חיובלכל תמונה	חיוב קלט · חומר עזר בקלט · אומדן להשוואה בלבד $0.4 לכל תמונה
תצורהתמונת פלט	טבלת תעריפים—	כמות חזויה—	יחידת חיובלכל תמונה בפלט	חיוב פלט · תמונת פלט · אומדן להשוואה בלבד $0.3 לכל תמונה בפלט
תצורהעלות יצירה משוערת	טבלת תעריפים—	כמות חזויהאומדן ליצירה אחת	יחידת חיוב—	חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.3 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה.

לפני הבקשה 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': 'sourceful/riverflow-v2-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 sourceful/riverflow-v2-pro

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

/v1/images

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

sourceful/riverflow-v2-pro

FAQ · Sourceful: Riverflow V2 Pro

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

Sourceful: Riverflow V2 Pro