النماذج

Recraft: Recraft V4 Styles

Markdown · JSON

Recraft: Recraft V4 Styles

يولّد Recraft V4 Styles صورًا نقطية 1K بأسلوب بصري تحدّده المراجع. صُمّم للعمل اليومي للعلامات التجارية والحملات، حيث يجب أن يحتفظ كل عنصر جديد بالمعالجة والملمس والمظهر العام نفسه.

عن النموذج

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

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

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

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

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

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

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

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

recraft/recraft-v4-styles

Recraft /recraft/recraft-v4-styles

البداية

يولّد Recraft V4 Styles صورًا نقطية 1K بأسلوب بصري تحدّده المراجع. صُمّم للعمل اليومي للعلامات التجارية والحملات، حيث يجب أن يحتفظ كل عنصر جديد بالمعالجة والملمس والمظهر العام نفسه.

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

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

Ailoot Ultra · الصور POST /v1/images/generations
الإدخال
text, image
الإخراج
image
الحقلالنوعالمتطلبالقيم والحدودالقيمة الافتراضية
الحقلmodelالنوعstringالمتطلبمطلوبالقيم والحدود
recraft/recraft-v4-styles
القيمة الافتراضية—
الحقل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.07 لكل صورة مُخرجة
الإعداداتتكلفة التوليد التقديريةجدول التعرفة—الكمية المتوقعةتقدير لتوليد واحدوحدة الفوترة—شروط الفوترة—الرسوم
الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.07 تقدير قبل الإنشاء

هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.

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

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

/v1/images

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

recraft/recraft-v4-styles

FAQ · Recraft: Recraft V4 Styles
ما المدخلات والنتائج المتاحة؟

POST /v1/images/generations · recraft/recraft-v4-styles: text, image → image

ما الحقول التي يستخدمها الطلب؟

POST /v1/images/generations · recraft/recraft-v4-styles: model, prompt, aspect_ratio, n, input_references, provider

ما الحدود المطبقة؟

POST /v1/images/generations · recraft/recraft-v4-styles: n.minimum: 1; n.maximum: 6

المزيد من التفاصيل

اربط Ailoot بخدمة Claude Code أوOpenCode أوHermes أوتطبيقك.

الشركة ومحفظة مشاريعها

الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.

اشتر الرموز بخصم.

خصم اشتراك للعمل المنتظم. الرموز الترويجية حتى 50% على شراء الرموز.

الاشتراك
اختر خطة بخصم لطلباتك المنتظمة.
رمز خصم حتى 50%
أدخل الرمز عند الشراء. يعاد حساب السعر وفق العرض الساري.
المصروفات في السجل
يحفظ النموذج والرموز والمبلغ لكل طلب.

اختر اشتراكا · اعرض أسعار النماذج

اربط API بالمنتج الذي تبيعه.

SaaS والتطبيقات والبوتات وفق العرض واتفاقية ترخيص Ailoot. لإعادة البيع، اطلب ترخيص موزع.

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

اطلب ترخيص إعادة بيع · العرض واتفاقية الترخيص