Sourceful: Riverflow V2.5 Pro
Riverflow 2.5 Pro הוא פרופיל יצירת התמונות ועריכתן של Sourceful המתמקד באיכות לקריאייטיב מוצר וקמפיין. משפחתו משלבת עריכה מרובת שלבים, שיפוט מותאם ושליטה בגופנים, המסייעים לתדריך מפורט לשמר את זהות המותג ואת הפריסה המיועדת.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Riverflow 2.5 Pro הוא פרופיל Pro במשפחת יצירת ועריכת התמונות Riverflow 2.5 של Sourceful, המיועד לעבודה יצירתית שבה שליטה ואיכות התמונה הסופית חשובות. תיאור טקסטואלי יכול ליצור תמונה, ותמונות ייחוס מספקות את המוצר, היצירה או הסצנה לעריכה. הגישה שמייחדת את המשפחה מתכננת כמה שלבי עריכה, בודקת את התוצרים המועמדים ומתקנת אותם לקראת התוצאה המבוקשת, במקום להתייחס לתמונה הראשונה כתהליך העבודה כולו.
לתמונת קמפיין, הכינו את חומרי הייחוס של המוצר ואת הכיוון המותגי לפני תיאור הסצנה. הגדירו את מאפייני המוצר שמבדילים SKU אחד מאחר, את הסידור, התאורה והמקום הדרוש לטקסט. תיאור שימושי יכול למקם שלושה מוצרים מסומנים בקומפוזיציה אחידה, תוך שמירה על הבדלים בצבעים, בגדלים ובזהות החזותית שלהם. לסצנת לייף סטייל עם מוצר יחיד, ציינו איזה מקור ייחוס מספק את החפץ ואיזה מספק את האווירה או הסביבה, ואז הגדירו מה צריך להישמר בשינוי.
Riverflow 2.5 מוסיפה מחוון הערכה מותאם לתהליך החשיבה והבדיקה. תארו את הקריטריונים שחשובים לתוצר: זהות המוצר, קריאות התווית, קומפוזיציה, סבירות הסצנה או כמות המקום לכותרת. אחרי שלבי העריכה, מודל החשיבה יכול להעריך מועמדים לפי המחוון ולהחליט איך להמשיך. תוצר לאריזה ותמונה אקספרסיבית לקמפיין דורשים סדרי עדיפויות שונים בבדיקה, ולכן הפרידו בין הוראת היצירה לבין הקריטריונים לשיפוט התוצאה.
מאמץ החשיבה קובע כמה עבודה איטרטיבית וכמה בדיקה מחמירה המשפחה מפעילה לפני שהיא מאשרת תמונה. תהליך העבודה של יצרן 2.5 נע בין low ל-xhigh: מאמץ נמוך יותר מתאים לחקירה ראשונית, ומאמץ גבוה יותר שימושי כשהתיאור דורש עוד ליטוש. בדיקה פנימית נוספת אינה מייתרת את הצורך לבחון את התוצר המוגמר. בפריסת מוצר מורכבת, הגדירו במפורש את הפרטים החשובים ואת קריטריוני הקבלה כדי שלעבודת העריכה הנוספת יהיה יעד ברור.
Font Control מקבל עד שני קובצי גופנים מותאמים ומשתמש בצורות האותיות, בריווח ובמשקל שסופקו כהנחיה. ספקו את המילים המדויקות להצגה, את התפקיד של כל מקטע טקסט ואת הגופן המתאים לו. כותרת וכיתוב תומך קצר יכולים להשתמש בגופנים שונים בלי להשאיר את ההיררכיה הטיפוגרפית מרומזת. בדקו את האותיות והמספרים בפלט עצמו, במיוחד כשהתווית על האריזה או שם המוצר מזהים את הפריט, במקום לראות בגופן ייחוס הוכחה שכל תו נכון.
משפחת 2.5 מספקת מצבי פלט עם רקע רגיל, בצבע אחיד או שקוף, כולל PNG שקוף לשילוב בקומפוזיציות, עם אפשרויות ייצוא ב-1K, ב-2K ועד 4K. בחרו את התוצר לפי השימוש בו: אובייקט מופרד לשילוב בעיצוב אחר, רקע אחיד ומבוקר לסדרות מוצרים עקביות או סצנה גמורה לקמפיין. תכננו יחד את צורת הפלט ואת מיקום הטקסט, כדי שיותר פרטים בקובץ הסופי לא יהפכו לניסיון לפתור קומפוזיציה שבה הנושא הראשי נמצא במקום הלא נכון.
Pro נפרד מפרופיל Fast ומדור Riverflow 2.0 הקודם. משפחת 2.5 נבנית על התשתית הרב-שלבית של 2.0, עם שליטה מעמיקה יותר בבדיקה, שיפוט מותאם ואפשרויות רקע וייצוא מורחבות. בדיקה סופית שימושית משווה את התמונה לחומרי הייחוס של המוצר, למחוון ולטיפוגרפיה, ואז משנה את ההוראה או הקריטריון המסוימים שאחראים לאי-ההתאמה. שמרו את התמונה הנבחרת עם התיאור וחומרי הייחוס שלה, כדי שהעריכה הבאה תלטש את אותו כיוון יצירתי במקום לאבד את הזהות שכבר נבנתה.
Ailoot Ultra · תמונות POST /v1/images/generations sourceful/riverflow-v2.5-pro
sourceful/riverflow-v2.5-proהתחלה
Riverflow 2.5 Pro הוא פרופיל יצירת התמונות ועריכתן של Sourceful המתמקד באיכות לקריאייטיב מוצר וקמפיין. משפחתו משלבת עריכה מרובת שלבים, שיפוט מותאם ושליטה בגופנים, המסייעים לתדריך מפורט לשמר את זהות המותג ואת הפריסה המיועדת.
- סוגי קלט נתמכים
- טקסט · תמונות
- תוצאות
- תמונות
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · תמונות POST /v1/images/generations
- סוגי קלט
text,image- סוגי פלט
image
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות sourceful/riverflow-v2.5-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 | ברירת מחדל— |
שדהoutput_format | סוגstring | דרישהרשות | ערכים ומגבלות png, jpeg, webp | ברירת מחדל— |
שדהbackground | סוגstring | דרישהרשות | ערכים ומגבלות auto, transparent, opaque | ברירת מחדל— |
שדה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.26 לכל תמונה בפלט |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | יחידת חיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.26 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה 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': 'sourceful/riverflow-v2.5-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}/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 sourceful/riverflow-v2.5-pro
כינויים לנתיבי שיטות
/v1/images
מזהי מודלים קשורים IDs
FAQ · Sourceful: Riverflow V2.5 Pro
- אילו קלטים ותוצאות זמינים?
POST /v1/images/generations·sourceful/riverflow-v2.5-pro:text,image→image- באילו שדות הבקשה משתמשת?
POST /v1/images/generations·sourceful/riverflow-v2.5-pro:model,prompt,resolution,aspect_ratio,output_format,background,n,input_references,provider- אילו מגבלות חלות?
POST /v1/images/generations·sourceful/riverflow-v2.5-pro:n.minimum:1;n.maximum:1