Recraft: Recraft V4 Styles Pro

يولّد Recraft V4 Styles Pro صورًا نقطية 2K بأسلوب بصري تحدّده المراجع. صُمّم لمواد الحملات التفصيلية ومجموعات الصور التي ينبغي أن يبقى ملمسها ومعالجتها وألوانها ومظهرها العام متّسقًا مع تغيّر العنصر.

Ailoot Ultra · الصور POST /v1/images/generations recraft/recraft-v4-styles-pro

عن النموذج

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

Recraft V4 Styles Pro النموذج النقطي الأعلى دقة في عائلة V4 Styles المخصّصة لدى Recraft. ينشئ صورة جديدة من وصف نصي وأسلوب بصري يُقدَّم عبر صور مرجعية أو أسلوب محفوظ. يستهدف النموذج الحملات ورسوم العلامات التجارية ومجموعات الصور الأخرى التي يجب أن تنتقل فيها المعالجة والملمس وطابع التكوين من صورة إلى التالية. وهو مستقل عن Recraft V4 Pro وV4.1 Pro، اللذين يكون مدخل الأسلوب فيهما اختياريًا بدلًا من كونه المتطلب المعرِّف للنموذج.

ينتج Styles Pro مخرجات نقطية 2K بصيغتَي WebP من دون فقدان أو PNG. يبلغ المخرج المربع في جدول أحجام المنتج 2048 × 2048 بكسل، بينما يبلغ مخرج 16:9 أبعاد 2688 × 1536؛ وللنسب المدعومة الأخرى أبعادها الخاصة. وقد تفيد مخرجات Pro الأكبر لمرئيات الحملات التفصيلية والتخطيطات الأكبر. وتنتج النسخ المتجهية بدلًا من ذلك SVG من دون حجم بكسلات ثابت، لذا لا ينبغي اختيار هذا الإصدار النقطي Pro عندما يكون التسليم المقصود ملفًا متجهيًا قابلًا للتحرير.

يتطلّب كل توليد في عائلة Styles أسلوبًا. قدّم من صورة واحدة إلى عشر صور مرجعية PNG أو JPG أو WebP، أو أعد استخدام أسلوب محفوظ متوافق؛ فمعرّف الأسلوب والمراجع الجديدة مدخلان بديلان لا زوج يُجمع. يسمح مسار المنتج بما يصل إلى 64 MB للمراجع مجتمعة، مع كل ملف أقل من 20 MB. ولا يتطلّب إنشاء الأسلوب خطوة تدريب يجريها المستخدم. ويمكن لمرجع واضح واحد تحديد اتجاه مترابط، وتساعد عدة مراجع عندما تشترك بالفعل في اللغة البصرية نفسها بدلًا من مظاهر متنافسة. يجب ألّا يقل الضلع الأقصر لكل مرجع عن 256 بكسل أو يزيد الأطول على 4,096 بكسل أو تتجاوز دقته الإجمالية 16 ميغابكسل.

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

يقبل النموذج توجيهات حتى 10,000 حرف، ويدعم الألوان المفضّلة ولون الخلفية المطلوب، ويمكنه استخدام بذرة عشوائية. ويمكن لمسار التوليد الموثّق إعادة صورة واحدة إلى ست صور. وتختلف عناصر تحكّمه المفيدة عن إصدارات Recraft الأقدم: لا تُدعم أسماء الأساليب المنسّقة أو negative_prompt أو text_layout، ولا توفّر عائلة Styles تحويل صورة إلى صورة أو الترميم داخل المناطق. المرجع مصدر أسلوب، وليس قناعًا أو تعليمة للحفاظ على صورة موجودة بكسلًا ببكسل.

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

Ailoot Ultra · الصور POST /v1/images/generations recraft/recraft-v4-styles-pro

recraft/recraft-v4-styles-pro

Recraft /recraft/recraft-v4-styles-pro

البداية

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

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

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

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

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود recraft/recraft-v4-styles-pro	القيمة الافتراضية—
الحقل`prompt`	النوع`string`	المتطلبمطلوب	القيم والحدود الحد الأدنى للطول: ⁦1⁩	القيمة الافتراضية—
الحقل`aspect_ratio`	النوع`string`	المتطلباختياري	القيم والحدود 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto	القيمة الافتراضية—
الحقل`n`	النوع`integer`	المتطلباختياري	القيم والحدود الحد الأدنى: ⁦1⁩ الحد الأقصى: ⁦6⁩	القيمة الافتراضية—
الحقل`input_references`	النوع`array`	المتطلباختياري	القيم والحدود الحد الأدنى للعناصر: ⁦1⁩ الحد الأقصى للعناصر: ⁦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.01 لكل طلب
الإعداداتصورة ناتجة	جدول التعرفة—	الكمية المتوقعة—	وحدة الفوترةلكل صورة مُخرجة	شروط الفوترة—	الرسوم الإخراج · صورة ناتجة · تقدير للمقارنة فقط $0.2 لكل صورة مُخرجة
الإعداداتتكلفة التوليد التقديرية	جدول التعرفة—	الكمية المتوقعةتقدير لتوليد واحد	وحدة الفوترة—	شروط الفوترة—	الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.2 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.

تحجز 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-styles-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 recraft/recraft-v4-styles-pro

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

/v1/images

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

recraft/recraft-v4-styles-pro

FAQ · Recraft: Recraft V4 Styles Pro

ما المدخلات والنتائج المتاحة؟: POST /v1/images/generations · recraft/recraft-v4-styles-pro: text, image → image
ما الحقول التي يستخدمها الطلب؟: POST /v1/images/generations · recraft/recraft-v4-styles-pro: model, prompt, aspect_ratio, n, input_references, provider
ما الحدود المطبقة؟: POST /v1/images/generations · recraft/recraft-v4-styles-pro: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4 Styles Pro