Source: https://ailoot.ai/models/ar/recraft-recraft-v4-1-utility/ Canonical: https://ailoot.ai/models/ar/recraft-recraft-v4-1-utility/ Language: ar # Recraft: Recraft V4.1 Utility [Markdown](https://ailoot.ai/models/ar/recraft-recraft-v4-1-utility/index.md) · [JSON](https://ailoot.ai/models/ar/recraft-recraft-v4-1-utility/facts.json) ## [Recraft: Recraft V4.1 Utility](https://ailoot.ai/models/ar/recraft-recraft-v4-1-utility/) يولّد Recraft V4.1 Utility صورًا نقطية بدقة 1K للقطات المنتجات الواضحة والنماذج التصويرية والمشاهد البسيطة. يفضّل إضاءة مسطّحة وتكوينًا مواجهًا للأمام، مع توجيهات نصية ومدخلات صورية أو أسلوبية اختيارية لاتجاه بصري متوقَّع. - [**Ailoot Ultra · الصور** `POST /v1/images/generations` `recraft/recraft-v4.1-utility`](https://ailoot.ai/models/ar/recraft-recraft-v4-1-utility/#method-0) عن النموذج يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة. Recraft V4.1 Utility نموذج Utility النقطي القياسي في عائلة V4.1 لدى Recraft. يفضّل المشاهد البسيطة والإضاءة المسطّحة والتكوين المواجه للأمام، بدلًا من اختيارات الزاوية والضوء والمزاج الأكثر تعبيرًا في نموذج V4.1 الرئيسي. ودوره العملي لقطة منتج أو نموذج تصويري واضح يتصدّر فيه الجسم وتفاصيله الضرورية. وإصدار Utility المحدّد مستقل عن Utility Pro ونموذج V4.1 الرئيسي والنسخ المتجهية التي تنتج SVG. رمز النموذج لدى المنتج recraftv4\_1\_utility. يعيد صورًا نقطية 1K بصيغة WebP من دون فقدان أو PNG، بأحجام تُختار من نسب الأبعاد المدعومة. تبلغ الصورة المربعة 1024 × 1024 بكسل، وصورة 4:3 أبعاد 1216 × 896. ويستخدم إصدار Pro Utility أبعادًا أكبر من فئة 2K، لذا لا ينبغي إسناد تلك الأحجام إلى Utility القياسي. اختر شكل صفحة العرض أو النموذج التصويري المقصود قبل وصف المشهد. يسمّي التوجيه المفيد المنتج وزاوية الرؤية والمادة والسطح والخلفية والإضاءة بعبارات بسيطة. ولعرض منتج، اطلب زجاجة عازلة مواجهة للأمام على خلفية فاتحة، بإضاءة متساوية وشكل خارجي ظاهر كاملًا ومن دون عناصر مشهد مشتّتة. وإذا كان للمنتج أبعاد فعلية أو أجزاء مميّزة، فقدّم تلك التفاصيل صراحة. فتفضيل Utility للعرض المباشر لا يثبت حقائق عن منتج حقيقي لم يتضمّنها التوجيه. يدعم التوليد توجيهات حتى 10,000 حرف، وعناصر تحكّم في الألوان المفضّلة ولون الخلفية، وبذرة عشوائية، ومن مخرج واحد إلى ستة مخرجات. ويمكن لأساليب مخصّصة متوافقة أو صور مرجعية اختيارية توجيه اللغة البصرية للكتالوج. استخدم مواد مرجعية متّفقة في الإضاءة والمعالجة، واحتفظ بالأسلوب المتوافق نفسه لتوجيهات المنتجات اللاحقة. ولا يُضمن التطابق اللوني الدقيق بين المرجع والمخرجات، لذا قارن الصورة النهائية بالألوان المطلوبة. وللتوليد بأسلوب مرجعي، استخدم من صورة واحدة إلى عشر صور PNG أو JPG أو WebP، بإجمالي لا يتجاوز 64 MB وحجم أقل من 20 MB لكل صورة. ويحتاج كل مرجع إلى ضلع أقصر لا يقل عن 256 بكسل وضلع أطول لا يزيد على 4,096 بكسل ودقة لا تتجاوز 16 ميغابكسل. استخدم هذه المراجع أو أسلوبًا محفوظًا متوافقًا، لا كليهما. وفي التوليد بأسلوب مرجعي، تسمح المطابقة المرنة بتفسير أوسع، بينما تتبع المطابقة الدقيقة المعالجة والألوان والتكوين والإضاءة بصورة أوثق. يستخدم المسار المستقل من صورة إلى صورة صورة موجودة وتوجيهًا، مع قوة من 0 إلى 1 تتحكّم في مدى التغيير. تُبقي القوة الأقل النتيجة أقرب إلى المصدر؛ وتسمح الأعلى بابتعاد أكبر. ويمكن لمدخله أن يكون PNG أو JPG أو WebP أو SVG بحجم أقل من 20 MB وحتى 16 MP، وبأضلاع بين 256 و4096 بكسل. ولا تُقبل أساليب V4.1 المخصّصة في عملية التحويل تلك، وهي مستقلة عن إرفاق مرجع أسلوب بتوليد جديد. لا يقبل V4.1 Utility أسماء الأساليب المنسّقة أو عناصر negative\_prompt أو text\_layout أو artistic\_level أو no\_text. قدّم المشهد النهائي المطلوب مباشرة في التوجيه الإيجابي. ولسلسلة صور منتجات، أبقِ تعليمات التأطير والخلفية ثابتة، ثم قارن كل صورة بشكل المنتج ومادته وتفاصيله المقدَّمة قبل استخدامها في تخطيط. Utility القياسي أداة نقطية متخصّصة لعرض هادئ؛ اختر صيغة الإخراج والإصدار المحدّدين وفق المهمة. **Ailoot Ultra · الصور** `POST /v1/images/generations` `recraft/recraft-v4.1-utility` [`recraft/recraft-v4.1-utility`](https://ailoot.ai/models/ar/#m=recraft%2Frecraft-v4.1-utility&route=Ultra&caller=recraft%2Frecraft-v4.1-utility&fmt=images) Recraft /`recraft/recraft-v4.1-utility` ### البداية يولّد Recraft V4.1 Utility صورًا نقطية بدقة 1K للقطات المنتجات الواضحة والنماذج التصويرية والمشاهد البسيطة. يفضّل إضاءة مسطّحة وتكوينًا مواجهًا للأمام، مع توجيهات نصية ومدخلات صورية أو أسلوبية اختيارية لاتجاه بصري متوقَّع. المدخلات المقبولة النص · الصور النتائج الصور ### متاح في Ailoot · المدخلات والطرائق **Ailoot Ultra · الصور** `POST /v1/images/generations` الإدخال `text`, `image` الإخراج `image` | الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية | | --- | --- | --- | --- | --- | | الحقل`model` | النوع`string` | المتطلبمطلوب | القيم والحدود recraft/recraft-v4.1-utility | القيمة الافتراضية— | | الحقل`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.07** لكل صورة مُخرجة | | الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | وحدة الفوترة— | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط **$0.07** تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. | تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. [كيفية عمل حجز المبلغ وتسوية الرسوم →](https://ailoot.ai/docs/ar/billing/reserve/) ### أمثلة للطلبات #### Ailoot Ultra · الصور curl ```bash 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', '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"