{ "aboutHtml": "

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

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

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

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

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

يدعم V4.1 أيضًا مسارًا مستقلًا من صورة إلى صورة، بصورة موجودة ونص وقوة من 0 إلى 1. تستخدم العملية القوة للتحكّم في مدى قرب الصورة الجديدة من المصدر، ولا تقبل عناصر أسلوب V4.1 المخصّص. ويستبعد مرجع التوليد الحالي للنموذج negative_prompt والأساليب المنسّقة وtext_layout وartistic_level وno_text. صِف المشهد المقصود مباشرة وافحص الصورة الناتجة في التخطيط المستهدف، بما فيها التفاصيل والاقتصاص وأي حروف، قبل اختيار الاتجاه البصري الذي ستحتفظ به. وللتحويل من صورة إلى صورة، قدّم PNG أو JPG أو WebP أو SVG بحجم أقل من 20 MB، ودقة لا تتجاوز 16 ميغابكسل، وكلا الضلعين بين 256 و4,096 بكسل.

", "aboutText": "Recraft V4.1 النموذج النقطي الرئيسي في عائلة V4.1 لدى Recraft. صُمّم لإنشاء صور معبّرة، بما فيها صور فوتوغرافية طبيعية المظهر ورسوم توضيحية ومفاهيم بصرية مجسّمة. وتقدّمه الجهة المصنّعة كنموذج يستطيع اتخاذ قرارات جمالية من توجيه قصير مع الاستجابة أيضًا لاتجاه إبداعي أكثر تفصيلًا. استخدمه للاستكشاف وتطوير المفاهيم والصور التي يكون فيها المزاج والإضاءة والتكوين جزءًا من النتيجة، بدلًا من اختزالها في منظر منتج أمامي بسيط.\n\nرمز المنتج المحدّد recraftv4_1. يعيد صورًا نقطية 1K بصيغة WebP من دون فقدان أو PNG، مع مخرج مربع 1024 × 1024 بكسل و16:9 بأبعاد 1344 × 768. وتستخدم النسب المدعومة الأخرى أبعادها الخاصة. V4.1 Pro الإصدار النقطي المستقل 2K، ويعيد Vector ملفات SVG قابلة للتحرير، ويفضّل Utility إضاءة ومشاهد أبسط. تخدم هذه الفروع نواتج مختلفة ولا ينبغي دمجها في مجموعة واحدة من خصائص الإخراج.\n\nتبرز الجهة المصنّعة مشاهد فوتوغرافية أكثر طبيعية وخلفية أهدأ وتدرّجات أنعم ومجال رسم واسعًا. وتشمل أمثلتها حروفًا معبّرة ورسم شخصية مسطّحًا وورقة مراجع لشخصية مرسومة. يمكن لتوجيه قصير ترك مجال لتفسير النموذج؛ ويمكن لتوجيه تفصيلي تحديد العنصر والوضعية والمادة والخلفية والتكوين. ولمرئية مجسّمة، حدّد معالجة السطح والإضاءة، مع تذكّر أن الناتج صورة لا شبكة مجسّمة أو مشروع ثلاثي الأبعاد قابل للتحرير.\n\nلمفهوم مساحة قراءة، اطلب صورة حميمة لركن قراءة صغير بضوء نهاري دافئ وكتب وجسم خزفي واحد، بترتيب مريح لا يشبه صالة عرض. ويمكن لتوجيه رسم منضبط بدلًا من ذلك تسمية العنصر الرسومي وعلاقات الألوان ومعالجة الخطوط. اذكر نسبة الأبعاد المقصودة والقرارات البصرية الأهم. وهذا يسهّل تحديد ما إذا كان تفصيل غير متوقّع تفسيرًا إبداعيًا مفيدًا أم شيئًا ينبغي تغييره في التوجيه التالي.\n\nيسمح مرجع التوليد بتوجيهات حتى 10,000 حرف وبذرة عشوائية وألوان مفضّلة ولون خلفية مطلوب، مع مخرج واحد إلى ستة مخرجات. ويمكن لصور مرجعية اختيارية أو أساليب محفوظة متوافقة تحديد لغة بصرية بمطابقة مرنة أو دقيقة. وليست مطلوبة في إصدار V4.1 الرئيسي. اختر مراجع نظيفة متّفقة واستخدم التوجيه للمحتوى الجديد؛ ولا يُضمن إعادة إنتاج ألوان المرجع. وللتوليد بأسلوب مرجعي، استخدم من صورة واحدة إلى عشر صور PNG أو JPG أو WebP، بإجمالي لا يتجاوز 64 MB وحجم أقل من 20 MB لكل صورة. ويحتاج كل مرجع إلى ضلع أقصر لا يقل عن 256 بكسل وضلع أطول لا يزيد على 4,096 بكسل ودقة لا تتجاوز 16 ميغابكسل. استخدم هذه المراجع أو أسلوبًا محفوظًا متوافقًا، لا كليهما.\n\nيدعم V4.1 أيضًا مسارًا مستقلًا من صورة إلى صورة، بصورة موجودة ونص وقوة من 0 إلى 1. تستخدم العملية القوة للتحكّم في مدى قرب الصورة الجديدة من المصدر، ولا تقبل عناصر أسلوب V4.1 المخصّص. ويستبعد مرجع التوليد الحالي للنموذج negative_prompt والأساليب المنسّقة وtext_layout وartistic_level وno_text. صِف المشهد المقصود مباشرة وافحص الصورة الناتجة في التخطيط المستهدف، بما فيها التفاصيل والاقتصاص وأي حروف، قبل اختيار الاتجاه البصري الذي ستحتفظ به. وللتحويل من صورة إلى صورة، قدّم PNG أو JPG أو WebP أو SVG بحجم أقل من 20 MB، ودقة لا تتجاوز 16 ميغابكسل، وكلا الضلعين بين 256 و4,096 بكسل.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "6108f9a9b8863a4488aa5eba9d0a2846cfeabff8e4792a9a27a324c2427efd6e", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ar", "methods": [ { "html": "
•

Recraft: Recraft V4.1

Recraft /recraft/recraft-v4.1

البداية

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

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

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

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

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

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

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

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

يدعم V4.1 أيضًا مسارًا مستقلًا من صورة إلى صورة، بصورة موجودة ونص وقوة من 0 إلى 1. تستخدم العملية القوة للتحكّم في مدى قرب الصورة الجديدة من المصدر، ولا تقبل عناصر أسلوب V4.1 المخصّص. ويستبعد مرجع التوليد الحالي للنموذج negative_prompt والأساليب المنسّقة وtext_layout وartistic_level وno_text. صِف المشهد المقصود مباشرة وافحص الصورة الناتجة في التخطيط المستهدف، بما فيها التفاصيل والاقتصاص وأي حروف، قبل اختيار الاتجاه البصري الذي ستحتفظ به. وللتحويل من صورة إلى صورة، قدّم PNG أو JPG أو WebP أو SVG بحجم أقل من 20 MB، ودقة لا تتجاوز 16 ميغابكسل، وكلا الضلعين بين 256 و4,096 بكسل.

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

Ailoot Ultra · الصور POST /v1/images/generations
الإدخال
text, image
الإخراج
image
الحقلالنوعالمتطلبالقيم والحدودالقيمة الافتراضية
الحقلmodelالنوعstringالمتطلبمطلوبالقيم والحدود
recraft/recraft-v4.1
القيمة الافتراضية—
الحقل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 مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →

أمثلة للطلبات

Ailoot Ultra · الصور

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'recraft/recraft-v4.1', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n    if not items: raise SystemExit("No completed images; retain the full response")\n    for index, item in enumerate(items):\n        encoded=item.get("b64_json")\n        uri=item.get("url", "")\n        if not encoded and uri.startswith("data:image/"):\n            header, separator, encoded=uri.partition(",")\n            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n        if encoded:\n            raw=base64.b64decode(encoded,validate=True)\n        elif uri:\n            uri=urljoin("https://api.ailoot.ai",uri)\n            parsed=urlsplit(uri)\n            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n                raise SystemExit("Invalid returned image URL")\n            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n            args=["curl","--fail-with-body","--silent","--show-error",uri]\n            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n            temporary=Path(f"image-{index}.bin")\n            subprocess.run(args+["-o",str(temporary)],check=True)\n            raw=temporary.read_bytes()\n            temporary.unlink()\n        else: raise SystemExit("Image has neither bytes nor URL")\n        if not raw: raise SystemExit("Empty image result")\n        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"\n        Path(f"image-{index}.{ext}").write_bytes(raw)\n    print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\n

استلام النتائج وحفظها

Ailoot Ultra · الصور

نزّل كل صورة مُرجعة أو احفظ محتواها بصيغة Base64

عمليات أخرى لقراءة المحتوى
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\n
الاحتفاظ بكل النتائج المكتملة

احفظ كل صورة مكتملة؛ نزّلها من كل URL مُرجع، أو فك ترميز محتواها بصيغة Base64.

احتفظ بالاستجابة كاملة وبجميع الترويسات، وبكل مخرج فعلي، وبالمعرّفات الأصلية المُعادة، وبجميع حقول الاستخدام. استعد العملية الأصلية دون إرسال طلب الإنشاء مجددًا.

عند الحاجة إلى التحقق من الاستجابة الأصلية

احتفظ بقيمة X-Client-Request-ID المُعادة للمطابقة. اقرأ فقط قيم task_id/asset_id الفعلية المُعادة أو مكتبة الوسائط المملوكة لك؛ ولا تنشئ عنوان URL لمهمة من معرّف العملية، ولا تُعِد إرسال طلب الإنشاء مطلقًا.

حقول الاستجابة
الحقلالنوع
الحقلcreatedالنوع
الحقلdata[].urlالنوع
الحقلdata[].b64_jsonالنوع
الحقلusageالنوع

الأسماء البديلة

الأسماء البديلة للنموذج

Ailoot Ultra recraft/recraft-v4.1

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

/v1/images

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

recraft/recraft-v4.1

", "method_identity": { "effective_request_model_id": "recraft/recraft-v4.1", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "recraft/recraft-v4.1", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|recraft%2Frecraft-v4.1", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "احتفظ بقيمة X-Client-Request-ID المُعادة للمطابقة. اقرأ فقط قيم task_id/asset_id الفعلية المُعادة أو مكتبة الوسائط المملوكة لك؛ ولا تنشئ عنوان URL لمهمة من معرّف العملية، ولا تُعِد إرسال طلب الإنشاء مطلقًا." }, "outputs": { "all_results": "احتفظ بالاستجابة كاملة وبجميع الترويسات، وبكل مخرج فعلي، وبالمعرّفات الأصلية المُعادة، وبجميع حقول الاستخدام. استعد العملية الأصلية دون إرسال طلب الإنشاء مجددًا.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] }, "parameters": [ { "enum": [ "recraft/recraft-v4.1" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "maximum": 6, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maximum_items": 1, "minimum_items": 0, "name": "input_references", "required": false, "type": "array" }, { "name": "provider", "required": false, "type": "object" } ], "request_schema": { "properties": { "aspect_ratio": { "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "type": "string" }, "input_references": { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 1, "minItems": 0, "type": "array" }, "model": { "enum": [ "recraft/recraft-v4.1" ], "type": "string" }, "n": { "maximum": 6, "minimum": 1, "type": "integer" }, "prompt": { "minLength": 1, "type": "string" }, "provider": { "description": "Exact image provider preferences from the documented image request schema.", "type": "object" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "recraft/recraft-v4.1", "prompt": "a red panda astronaut floating in space, studio lighting" }, "content_type": "application/json" } }, "input": { "content_type": "application/json", "material_types": [ "text", "image" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "قيمة task_id الفعلية المُعادة أو سجل مكتبة الوسائط", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Keep the returned X-Client-Request-ID for reconciliation. Read only actual returned task_id/asset_id values or the owned media library; never build a task URL from the operation ID and never resubmit creation." }, "method": { "http": "POST", "path": "/v1/images/generations" }, "output": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per output image" }, "label": "output image", "units": [ { "amount": "0.07", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.07", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "تكلفة التوليد التقديرية", "units": [ { "amount": "0.07", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.07", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'recraft/recraft-v4.1', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit(\"No completed images; retain the full response\")\n for index, item in enumerate(items):\n encoded=item.get(\"b64_json\")\n uri=item.get(\"url\", \"\")\n if not encoded and uri.startswith(\"data:image/\"):\n header, separator, encoded=uri.partition(\",\")\n if not separator or \";base64\" not in header: raise SystemExit(\"Unsupported image data URI\")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin(\"https://api.ailoot.ai\",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!=\"https\" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit(\"Invalid returned image URL\")\n owned=parsed.netloc==\"api.ailoot.ai\" and parsed.path.startswith(\"/v1/media/assets/\") and parsed.path.endswith(\"/content\")\n args=[\"curl\",\"--fail-with-body\",\"--silent\",\"--show-error\",uri]\n if owned: args += [\"-H\",\"Authorization: Bearer \"+os.environ[\"AILOOT_API_KEY\"]]\n temporary=Path(f\"image-{index}.bin\")\n subprocess.run(args+[\"-o\",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit(\"Image has neither bytes nor URL\")\n if not raw: raise SystemExit(\"Empty image result\")\n 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\"