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
أقصى جهد للاستدلال: غير محدد عندما يُطبَّق الضبط الافتراضي 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