Recraft: Recraft V4.1 Utility Pro
يولّد Recraft V4.1 Utility Pro صورًا نقطية بدقة 2K مع التركيز على المشاهد البسيطة والمتوقعة والإضاءة المسطّحة والتكوين الأمامي. يناسب لقطات المنتجات التفصيلية والنماذج التصويرية التي تحتاج إلى عرض واضح بدلًا من اتجاه فني تعبيري.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
Recraft V4.1 Utility Pro هو النسخة النقطية الأعلى دقة من فرع Utility ضمن Recraft V4.1. تميّز الشركة المصنّعة عرض Utility المباشر عن خيارات نموذج V4.1 الرئيسي الأكثر تعبيرًا في الزوايا والإضاءة والتكوين. يفضّل Utility المشاهد البسيطة والإضاءة المسطّحة والموضوعات المواجهة للأمام. لذلك يناسب صور قوائم المنتجات والنماذج التصويرية وغيرها من الأعمال التي ينبغي فيها أن يكون العنصر سهل التبيّن وأن يخدم تكوين هادئ المهمة.
رمز النموذج المحدد هو recraftv4_1_utility_pro. ويسرد مرجع المنتج إخراجًا نقطيًا بدقة 2K وتفاصيل أدق، بصيغة WebP غير فاقدة للجودة أو PNG. يعطي جدول الأحجام 2048 × 2048 بكسل للصور المربعة و2432 × 1792 لنسبة 4:3، فيما تستخدم نسب الأبعاد المدعومة الأخرى أبعادها الخاصة. ويميّز ذلك Utility Pro عن إخراج Utility القياسي بدقة 1K. ولا يحوّل الصورة إلى ملف متجهي قابل للتحرير؛ إذ يوفّر إصدار Vector صيغة SVG لهذا الغرض.
ابدأ بموجز يسمّي العنصر والمادة وزاوية الرؤية والخلفية والتفاصيل القليلة التي يجب أن تظهر. لقائمة منتج، اطلب مرطبان تخزين خزفيًا مواجهًا للأمام على سطح فاتح محايد، بإضاءة متساوية وغطاء مغلق ومساحة واضحة حول حدوده الخارجية. وإذا وجب أن يظل المشهد مباشرًا، فقل ذلك صراحةً بدلًا من الاعتماد على اسم Utility لتضمين جميع خيارات العرض. ولمجموعة صور قوائم، ثبّت متطلبات التأطير والخلفية مع تغيير وصف المنتج.
يدعم مرجع توليد V4.1 تعليمات حتى 10,000 محرف، وعناصر تحكم في الألوان المفضلة ولون الخلفية، وبذرة عشوائية، ومن ناتج واحد إلى ستة. ويمكن لأسلوب محفوظ متوافق أو صور مرجعية اختيارية توجيه المظهر؛ أما عائلة V4 Styles المتخصصة فهي الخط المنفصل الذي يكون فيه الأسلوب إلزاميًا دائمًا. للمراجع الاختيارية، استخدم مواد واضحة ذات اتجاه بصري متوافق. لا تُضمن إعادة إنتاج اللون من مرجع بدقة، لذا تظل متطلبات ألوان العلامة بحاجة إلى موجز صريح وفحص للناتج. وللتوليد بأسلوب مرجعي، استخدم من صورة واحدة إلى عشر صور بصيغة PNG أو JPG أو WebP، بإجمالي لا يتجاوز 64 MB وأقل من 20 MB لكل صورة. يحتاج كل مرجع إلى ضلع أقصر لا يقل عن 256 بكسل، وضلع أطول لا يزيد على 4,096 بكسل، ودقة لا تتجاوز 16 ميغابكسل. استخدم إما هذه المراجع أو أسلوبًا محفوظًا متوافقًا، لا الاثنين معًا. وفي التوليد بأسلوب مرجعي، تتيح المطابقة المرنة تفسيرًا أكثر حرية، بينما تتبع المطابقة الدقيقة التصيير ولوحة الألوان والتكوين والإضاءة بصورة أوثق.
توثّق Recraft أيضًا تحويل الصورة إلى صورة لخط V4.1، بدمج صورة موجودة وتعليمة وقيمة قوة من 0 إلى 1. تبقى القوة الأقل أقرب إلى المصدر، وتسمح القيمة الأعلى بتغيير أكبر. يفيد ذلك عندما ينبغي أن يؤثر التكوين أو الموضوع الابتدائي في نسخة جديدة. ولا يقبل عناصر تحكم الأسلوب المخصص في V4.1 ضمن عملية التحويل نفسها. حدود مدخلات الصور لدى المنتج هي حجم أقل من 20 MB، ودقة حتى 16 MP، وأضلاع بين 256 و4096 بكسل.
يشترك Utility Pro في قيود V4.1 على عناصر التحكم negative_prompt وأسماء الأساليب المنتقاة وtext_layout وartistic_level وno_text. قدّم وصفًا إيجابيًا للمشهد المقصود، واترك عمل الحروف الدقيقة أو التخطيط لخطوة إنهاء مناسبة عند الحاجة. راجع صورة المنتج من حيث المادة والشكل والتفاصيل الضرورية المقدَّمة قبل اعتبارها مادة أمينة لقائمة المنتج. والنتيجة المفيدة تكوين نقطي أكبر أُعدّ لموجز واضح لمنتج أو نموذج تصويري، فيما تظل حقائق المنتج الدقيقة هي تلك المقدَّمة في المهمة.
Ailoot Ultra · الصور POST /v1/images/generations recraft/recraft-v4.1-utility-pro
recraft/recraft-v4.1-utility-pro
recraft/recraft-v4.1-utility-proالبداية
يولّد Recraft V4.1 Utility Pro صورًا نقطية بدقة 2K مع التركيز على المشاهد البسيطة والمتوقعة والإضاءة المسطّحة والتكوين الأمامي. يناسب لقطات المنتجات التفصيلية والنماذج التصويرية التي تحتاج إلى عرض واضح بدلًا من اتجاه فني تعبيري.
- المدخلات المقبولة
- النص · الصور
- النتائج
- الصور
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · الصور POST /v1/images/generations
- الإدخال
text,image- الإخراج
image
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود recraft/recraft-v4.1-utility-pro | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلبمطلوب | القيم والحدود الحد الأدنى للطول: 1 | القيمة الافتراضية— |
الحقلaspect_ratio | النوعstring | المتطلباختياري | القيم والحدود 1:1, 4:3, 3:4, 16:9, 9:16, auto | القيمة الافتراضية— |
الحقلn | النوعinteger | المتطلباختياري | القيم والحدود الحد الأدنى: 1 الحد الأقصى: 6 | القيمة الافتراضية— |
الحقلinput_references | النوعarray | المتطلباختياري | القيم والحدود الحد الأدنى للعناصر: 0 الحد الأقصى للعناصر: 1 | القيمة الافتراضية— |
الحقل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.42 لكل صورة مُخرجة |
| الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | وحدة الفوترة— | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.42 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. |
تحجز 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': 'recraft/recraft-v4.1-utility-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 recraft/recraft-v4.1-utility-pro
الأسماء البديلة لمسارات الطرائق
/v1/images
معرّفات النماذج ذات الصلة IDs
FAQ · Recraft: Recraft V4.1 Utility Pro
- ما المدخلات والنتائج المتاحة؟
POST /v1/images/generations·recraft/recraft-v4.1-utility-pro:text,image→image- ما الحقول التي يستخدمها الطلب؟
POST /v1/images/generations·recraft/recraft-v4.1-utility-pro:model,prompt,aspect_ratio,n,input_references,provider- ما الحدود المطبقة؟
POST /v1/images/generations·recraft/recraft-v4.1-utility-pro:n.minimum:1;n.maximum:6