Sourceful: Riverflow V2.5 Fast

Riverflow 2.5 Fast هو ملف Fast من Sourceful لتوليد صور المنتجات والتسويق وتحريرها. استخدمه لاستكشاف التكوينات والتعديلات المحددة ضمن سير عمل العائلة القائم على الاستدلال، مع مراجع وطباعة ومعايير مراجعة واضحة.

Ailoot Ultra · الصور POST /v1/images/generations sourceful/riverflow-v2.5-fast

عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.

Riverflow 2.5 Fast هو ملف Fast من عائلة Riverflow 2.5 لدى Sourceful لتوليد الصور وتحريرها. يناسب التكرار الإبداعي المبكر وخطوات التطبيق القابلة للتكرار عندما يحتاج الموجز إلى صورة مرشحة مفيدة سريعًا. تجمع العائلة تعليمة مكتوبة وصورًا مصدرية مع عملية تحرير قائمة على الاستدلال تراجع النتائج المرشحة وتجري تصحيحات. أما Pro فهو الملف المنفصل الذي يركز على الجودة ضمن الجيل نفسه.

للاستكشاف، حدّد سؤالًا بصريًا واحدًا لكل موجز: البيئة أو التكوين أو ترتيب المنتجات أو تغييرًا محددًا في صورة موجودة. ينبغي أن يظل مرجع المنتج الأصلي نقطة الارتكاز بينما تتغير البيئة أو عملية الاقتصاص حوله. يمكن لمهمة كتالوج مفيدة أن تستكشف مشهد زجاجة على طاولة، ثم تقارن ما إذا كانت الصورة تترك مساحة كافية لعنوانها المعتمد. حافظ على اتساق هوية المنتج وموضعه المقصود بين النتائج المرشحة كي تتناول المقارنة الخيار الإبداعي بدلًا من تغيير عرضي في الموضوع.

يتيح التقييم المخصص في عائلة 2.5 استخدام سلم معايير يعبّر عما يجعل النتيجة المرشحة مفيدة. حدّد معايير مثل عبوة قابلة للتعرّف، وحروف مقروءة، وإضاءة متسقة، واقتصاص عملي. افصل هذا السلم عن تعليمة التوليد: فإحداهما تصف الصورة المطلوب إنشاؤها، والآخر يحدد منظور مراجعتها. يفيد مستوى التفكير الأقل في مرحلة الاستكشاف المبكرة؛ ثم يمكن توجيه مراجعة إضافية إلى المعايير التي أخفقت فيها النتيجة الأولى.

إعداد المراجع جوهري للتعديل المحدد. عيّن الصورة التي تقدّم المنتج، والتي تقدّم البيئة أو الرسم أو الجو البصري. حدّد العنصر المطلوب تغييره والسمات التي يجب الحفاظ عليها، مثل شكل الغطاء أو لون الملصق أو اسم المنتج المقروء. ولمجموعة من النسخ المترابطة، ثبّت اتجاه الإضاءة ووصف الأسلوب مع تغيير الخاصية الوحيدة التي تميّز كل مادة. يدعم وعي العائلة بالسياق صور المنتجات والحملات، لكن ينبغي للموجز مع ذلك أن يقدّم الحقائق والمراجع التي تعرّف العنصر.

يمكن لميزة Font Control استخدام ما يصل إلى ملفَّي خطوط مخصصين مقدَّمين ضمن سير عمل 2.5. قدّم العنوان والعبارة التوضيحية بدقة، وموضعهما، ودور خط كل منهما. تجعل كتل نصية قليلة ومحددة جيدًا تقييم التسلسل البصري أسهل من لوحة مكتظة بتوجيهات متعارضة. راجع الإملاء والأرقام وفواصل الأسطر ووزن الخط في الصورة الناتجة بالحجم الذي ستُستخدم فيه. الصورة مادة مصيّرة، وليست ملف تنضيد قابلًا للتحرير أو واجهة تعمل.

تشمل العائلة مسارات عمل للخلفيات العادية وأحادية اللون والشفافة. جهّز عنصرًا مقصوصًا بخلفية شفافة عندما يلزم تركيب الصورة في تخطيط آخر، أو خلفية أحادية اللون مضبوطة عندما تحتاج مجموعة منتجات إلى قاعدة بصرية مشتركة. استخدم مشهدًا مكتملًا لصورة حملة. اختر الدقة والاقتصاص المتاحين بما يناسب موضع الإخراج الفعلي، ثم افحص تفاصيل المنتج والنص المرئية بدلًا من افتراض أن اللوحة الأكبر وحدها تثبت دقتها.

يختلف Fast عن Pro وعن جيل 2.0. يضيف Riverflow 2.5 استدلالًا أعمق ومعايير مراجعة مخصصة وعناصر تحكم محسّنة في الخطوط والخلفيات إلى النهج السابق متعدد الخطوات. ولحلقة تكرار مفيدة، احتفظ بالنتيجة المرشحة التي تناسب التكوين، وحدّد المشكلة الدقيقة المتبقية، وعدّل ذلك الجزء من الموجز أو سلم المعايير. احتفظ بالصورة المختارة والمراجع المصدرية ومعايير المراجعة معًا كي تطوّر التغييرات اللاحقة المادة الإبداعية نفسها بدلًا من إعادة تأسيس هويتها.

Ailoot Ultra · الصور POST /v1/images/generations sourceful/riverflow-v2.5-fast

sourceful/riverflow-v2.5-fast

Sourceful /sourceful/riverflow-v2.5-fast

البداية

المدخلات المقبولة: النص · الصور
النتائج: الصور

متاح في Ailoot · المدخلات والطرائق

Ailoot Ultra · الصور POST /v1/images/generations

الإدخال: text, image
الإخراج: image

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود sourceful/riverflow-v2.5-fast	القيمة الافتراضية—
الحقل`prompt`	النوع`string`	المتطلبمطلوب	القيم والحدود الحد الأدنى للطول: ⁦1⁩	القيمة الافتراضية—
الحقل`resolution`	النوع`string`	المتطلباختياري	القيم والحدود 1K, 2K	القيمة الافتراضية—
الحقل`aspect_ratio`	النوع`string`	المتطلباختياري	القيم والحدود 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	القيمة الافتراضية—
الحقل`output_format`	النوع`string`	المتطلباختياري	القيم والحدود jpeg	القيمة الافتراضية—
الحقل`background`	النوع`string`	المتطلباختياري	القيم والحدود auto, transparent, opaque	القيمة الافتراضية—
الحقل`n`	النوع`integer`	المتطلباختياري	القيم والحدود الحد الأدنى: ⁦1⁩ الحد الأقصى: ⁦1⁩	القيمة الافتراضية—
الحقل`input_references`	النوع`array`	المتطلباختياري	القيم والحدود الحد الأدنى للعناصر: ⁦0⁩ الحد الأقصى للعناصر: ⁦4⁩	القيمة الافتراضية—
الحقل`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.038 لكل صورة مُخرجة
الإعداداتتكلفة التوليد التقديرية	جدول التعرفة—	الكمية المتوقعةتقدير لتوليد واحد	وحدة الفوترة—	الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.038 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.

تحجز 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.5-fast', '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.5-fast

الأسماء البديلة لمسارات الطرائق

/v1/images

معرّفات النماذج ذات الصلة IDs

sourceful/riverflow-v2.5-fast

FAQ · Sourceful: Riverflow V2.5 Fast

ما المدخلات والنتائج المتاحة؟: POST /v1/images/generations · sourceful/riverflow-v2.5-fast: text, image → image
ما الحقول التي يستخدمها الطلب؟: POST /v1/images/generations · sourceful/riverflow-v2.5-fast: model, prompt, resolution, aspect_ratio, output_format, background, n, input_references, provider
ما الحدود المطبقة؟: POST /v1/images/generations · sourceful/riverflow-v2.5-fast: n.minimum: 1; n.maximum: 1

Sourceful: Riverflow V2.5 Fast