{ "aboutHtml": "

DALL·E 3 نموذج OpenAI لتحويل النص إلى صورة. استخدم موجزًا مكتوبًا لإنشاء رسم توضيحي أو تصور مشهد أو توجه بصري لتصميم. صِف الموضوع والبيئة والتكوين والإضاءة والمعالجة في prompt. مثلًا، يمكن لموجز تصور أن يطلب دراجة توصيل بجوار متجر صغير عند الغسق، من منظور الشارع، مع موضوع واضح في المقدمة ولوحة ألوان هادئة.

أرسل POST /v1/images/generations مع جسم application/json. معرّف النموذج العام الدقيق هو openai/dall-e-3؛ ويختار الاسم البديل المعتمد dall-e-3 بطاقة النموذج نفسها. تتضمن صيغة البداية الموثّقة model وprompt وn:1 وsize:"1024x1024". n عدد صحيح اختياري وقيمته الافتراضية 1. أرسل stream:false، أو احذف stream، للحصول على نتيجة JSON كاملة. استخدم prompt نصيًا غير فارغ، وأبقِ هذا الطلب مركزًا على موجز صورة واحد كامل. الطريقة المقدّمة هي توليد الصور من النص.

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

استجابة التوليد هي JSON مع طابع زمني created ومصفوفة data. يتضمن عنصر النتيجة الموثّق url وقد يتضمن revised_prompt وprompt_filter_results وcontent_filter_results. احتفظ بهذه الحقول مع الاستجابة كاملة، ونزّل الصورة من كل URL موقّع من Ailoot يُعاد إليك. تدوم روابط ملفات Ailoot الموقّعة 24 ساعة من إصدارها. احتفظ بـ URL المُعاد الدقيق، بما فيه سلسلة الاستعلام، حتى يُحفظ الملف؛ وحدّد صيغة الصورة المحفوظة من الاستجابة الفعلية أو بايتات الملف.

تعامل مع ملف الصورة المُعاد بوصفه أصل التصميم القابل للاستخدام، ومع JSON بوصفه سجل التوليد المصاحب. راجع الصورة وفق الموجز المقدّم قبل وضعها في صفحة أو عرض تقديمي أو تطبيق. إذا كانت الاستجابة ناقصة أو كانت نتيجة الإرسال غير مؤكدة، فاحتفظ بمعرّف الطلب الأصلي والمعلومات المُعادة أثناء فحص المحاولة الموجودة، بدل إنشاء صورة أخرى لمجرد استعادة النتيجة المفقودة. ولاسترجاع النتائج المحفوظة، استخدم مفتاح API نفسه لإرسال GET /v1/media/assets?family=image وتابع كل next_cursor. يظهر معرّف الأصل في كل URL مُعاد لمسار /v1/media/assets/{asset_id}/content وفي سجله بمكتبة الوسائط. اقرأ GET /v1/media/assets/{asset_id} لكل سجل مختار ونزّل content_url الدقيق الخاص به. إذا أعاد طلب الملف 404 مع الرمز link_expired، فاقرأ الأصل نفسه مجددًا للحصول على رابط محدّث. لا يتطلب تحديث رابط أصل طلبًا آخر لتوليد الصور.

", "aboutText": "DALL·E 3 نموذج OpenAI لتحويل النص إلى صورة. استخدم موجزًا مكتوبًا لإنشاء رسم توضيحي أو تصور مشهد أو توجه بصري لتصميم. صِف الموضوع والبيئة والتكوين والإضاءة والمعالجة في prompt. مثلًا، يمكن لموجز تصور أن يطلب دراجة توصيل بجوار متجر صغير عند الغسق، من منظور الشارع، مع موضوع واضح في المقدمة ولوحة ألوان هادئة.\n\nأرسل POST /v1/images/generations مع جسم application/json. معرّف النموذج العام الدقيق هو openai/dall-e-3؛ ويختار الاسم البديل المعتمد dall-e-3 بطاقة النموذج نفسها. تتضمن صيغة البداية الموثّقة model وprompt وn:1 وsize:\"1024x1024\". n عدد صحيح اختياري وقيمته الافتراضية 1. أرسل stream:false، أو احذف stream، للحصول على نتيجة JSON كاملة. استخدم prompt نصيًا غير فارغ، وأبقِ هذا الطلب مركزًا على موجز صورة واحد كامل. الطريقة المقدّمة هي توليد الصور من النص.\n\nاجعل المتطلبات المهمة لموضع الاستخدام صريحة. يمكن لرسم توضيحي تحريري أن يذكر الفكرة المحورية والعناصر التي تعبّر عنها. ويمكن لتصور مشهد أن يحدد موضع الكاميرا ووقت اليوم وأجزاء التكوين التي تحتاج إلى مساحة حولها. أبقِ الصياغة الدقيقة التي يجب أن تظهر في الصورة متميزة عن أوصاف المشهد، ثم افحص الكتابة المرسومة والترتيب البصري قبل استخدام النتيجة المختارة.\n\nاستجابة التوليد هي JSON مع طابع زمني created ومصفوفة data. يتضمن عنصر النتيجة الموثّق url وقد يتضمن revised_prompt وprompt_filter_results وcontent_filter_results. احتفظ بهذه الحقول مع الاستجابة كاملة، ونزّل الصورة من كل URL موقّع من Ailoot يُعاد إليك. تدوم روابط ملفات Ailoot الموقّعة 24 ساعة من إصدارها. احتفظ بـ URL المُعاد الدقيق، بما فيه سلسلة الاستعلام، حتى يُحفظ الملف؛ وحدّد صيغة الصورة المحفوظة من الاستجابة الفعلية أو بايتات الملف.\n\nتعامل مع ملف الصورة المُعاد بوصفه أصل التصميم القابل للاستخدام، ومع JSON بوصفه سجل التوليد المصاحب. راجع الصورة وفق الموجز المقدّم قبل وضعها في صفحة أو عرض تقديمي أو تطبيق. إذا كانت الاستجابة ناقصة أو كانت نتيجة الإرسال غير مؤكدة، فاحتفظ بمعرّف الطلب الأصلي والمعلومات المُعادة أثناء فحص المحاولة الموجودة، بدل إنشاء صورة أخرى لمجرد استعادة النتيجة المفقودة. ولاسترجاع النتائج المحفوظة، استخدم مفتاح API نفسه لإرسال GET /v1/media/assets?family=image وتابع كل next_cursor. يظهر معرّف الأصل في كل URL مُعاد لمسار /v1/media/assets/{asset_id}/content وفي سجله بمكتبة الوسائط. اقرأ GET /v1/media/assets/{asset_id} لكل سجل مختار ونزّل content_url الدقيق الخاص به. إذا أعاد طلب الملف 404 مع الرمز link_expired، فاقرأ الأصل نفسه مجددًا للحصول على رابط محدّث. لا يتطلب تحديث رابط أصل طلبًا آخر لتوليد الصور.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "5349a4d105efee29cbcb05dbbff286ebf20081e480ee2ee4909eb55dfce8e76d", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ar", "methods": [ { "html": "
O

OpenAI: DALL·E 3

OpenAI /openai/dall-e-3

البداية

يولّد DALL·E 3 الصور من موجز مكتوب للمشهد. استخدم معرّف النموذج الدقيق openai/dall-e-3 أو اسمه البديل dall-e-3 مع طريقة توليد الصور، ثم احفظ كل URL صورة مُعاد والنتيجة المصاحبة. ينتج طلب البداية الموثّق صورة واحدة بمقاس 1024x1024 من النص.

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

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

DALL·E 3 نموذج OpenAI لتحويل النص إلى صورة. استخدم موجزًا مكتوبًا لإنشاء رسم توضيحي أو تصور مشهد أو توجه بصري لتصميم. صِف الموضوع والبيئة والتكوين والإضاءة والمعالجة في prompt. مثلًا، يمكن لموجز تصور أن يطلب دراجة توصيل بجوار متجر صغير عند الغسق، من منظور الشارع، مع موضوع واضح في المقدمة ولوحة ألوان هادئة.

أرسل POST /v1/images/generations مع جسم application/json. معرّف النموذج العام الدقيق هو openai/dall-e-3؛ ويختار الاسم البديل المعتمد dall-e-3 بطاقة النموذج نفسها. تتضمن صيغة البداية الموثّقة model وprompt وn:1 وsize:"1024x1024". n عدد صحيح اختياري وقيمته الافتراضية 1. أرسل stream:false، أو احذف stream، للحصول على نتيجة JSON كاملة. استخدم prompt نصيًا غير فارغ، وأبقِ هذا الطلب مركزًا على موجز صورة واحد كامل. الطريقة المقدّمة هي توليد الصور من النص.

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

استجابة التوليد هي JSON مع طابع زمني created ومصفوفة data. يتضمن عنصر النتيجة الموثّق url وقد يتضمن revised_prompt وprompt_filter_results وcontent_filter_results. احتفظ بهذه الحقول مع الاستجابة كاملة، ونزّل الصورة من كل URL موقّع من Ailoot يُعاد إليك. تدوم روابط ملفات Ailoot الموقّعة 24 ساعة من إصدارها. احتفظ بـ URL المُعاد الدقيق، بما فيه سلسلة الاستعلام، حتى يُحفظ الملف؛ وحدّد صيغة الصورة المحفوظة من الاستجابة الفعلية أو بايتات الملف.

تعامل مع ملف الصورة المُعاد بوصفه أصل التصميم القابل للاستخدام، ومع JSON بوصفه سجل التوليد المصاحب. راجع الصورة وفق الموجز المقدّم قبل وضعها في صفحة أو عرض تقديمي أو تطبيق. إذا كانت الاستجابة ناقصة أو كانت نتيجة الإرسال غير مؤكدة، فاحتفظ بمعرّف الطلب الأصلي والمعلومات المُعادة أثناء فحص المحاولة الموجودة، بدل إنشاء صورة أخرى لمجرد استعادة النتيجة المفقودة. ولاسترجاع النتائج المحفوظة، استخدم مفتاح API نفسه لإرسال GET /v1/media/assets?family=image وتابع كل next_cursor. يظهر معرّف الأصل في كل URL مُعاد لمسار /v1/media/assets/{asset_id}/content وفي سجله بمكتبة الوسائط. اقرأ GET /v1/media/assets/{asset_id} لكل سجل مختار ونزّل content_url الدقيق الخاص به. إذا أعاد طلب الملف 404 مع الرمز link_expired، فاقرأ الأصل نفسه مجددًا للحصول على رابط محدّث. لا يتطلب تحديث رابط أصل طلبًا آخر لتوليد الصور.

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

Ailoot Ultra · Images POST /v1/images/generations
الإدخال
text
الإخراج
image
صيغة الإخراج
ملف صورة
الحقلالنوعالمتطلبالقيم والحدودالقيمة الافتراضية
الحقلmodelالنوعstringالمتطلبمطلوبالقيم والحدود
openai/dall-e-3
القيمة الافتراضية—
الحقلpromptالنوعstringالمتطلبمطلوبالقيم والحدودالقيمة الافتراضية—
الحقلstreamالنوعbooleanالمتطلباختياريالقيم والحدود
false
القيمة الافتراضيةfalse
الحقلnالنوعintegerالمتطلباختياريالقيم والحدود
⁦1⁩
القيمة الافتراضية—
الحقلsizeالنوعstringالمتطلباختياريالقيم والحدود
1024x1024
القيمة الافتراضية—
معلمات الطريقة ودورة حياتها
المعلمةالمواصفات
المعلمةcontent_typeالمواصفاتapplication/json
المعلمةrequiredالمواصفاتmodel, prompt
المعلمةoptionalالمواصفاتstream, n, size
المعلمةmaterial_typesالمواصفاتtext
المعلمةconditionsالمواصفاتUse stream:false or omit stream. The complete buffered JSON result contains all generated images.

دورة الحياة: synchronous_result_then_owned_library

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

الباقات

كيفية احتساب الرسوم النهائية

تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.

مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.

الوضع السريع
غير محدد عند اختيار الوضع السريع
الوضع المرن
غير محدد عند اختيار وضع flex
أقصى جهد للاستدلال
غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال

تعرفات تقديرية للمقارنة

الأسعار حسب الإعدادات

طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.

الإعداداتجدول التعرفةالكمية المتوقعةالرسوم
الإعداداتالتعرفات الأساسية للرموزجدول التعرفةالتعرفة الأساسيةالكمية المتوقعة—الرسوم
الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز
الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز
الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز
الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز
الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز
الإعداداتEstimated generation costجدول التعرفة—الكمية المتوقعةتقدير لتوليد واحدالرسوم
الإدخال · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.32768 تقدير قبل الإنشاء

This estimate is not an additional charge or a fixed rate for the completed generation.

تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →

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

Ailoot Ultra · Images

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=json.loads('{"model": "openai/dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')\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\n# Submit once. Retain the complete result, original identifiers and every response header.\n

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

Ailoot Ultra · Images

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

الاحتفاظ بكل النتائج المكتملة

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

Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.

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

Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.

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

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

Ailoot Ultra openai/dall-e-3, dall-e-3

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

استخدم مسارات الطرائق المعروضة أعلاه.

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

openai/dall-e-3, dall-e-3

", "method_identity": { "effective_request_model_id": "openai/dall-e-3", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "openai/dall-e-3", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|openai%2Fdall-e-3", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity.", "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, all actual results, original identifiers, usage and response headers.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "example_body": { "model": "openai/dall-e-3", "n": 1, "prompt": "A calm studio product photograph with a plain background.", "size": "1024x1024" }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "image" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "outputs": { "all_results": "Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.", "family": "image", "format": "JSON with all URL or base64 outputs" }, "parameters": [ { "default_known": false, "enum": [ "openai/dall-e-3" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "name": "prompt", "required": true, "type": "string" }, { "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" }, { "default_known": false, "enum": [ 1 ], "enum_known": true, "name": "n", "required": false, "type": "integer" }, { "default_known": false, "enum": [ "1024x1024" ], "enum_known": true, "name": "size", "required": false, "type": "string" } ], "request_schema": { "additionalProperties": true, "properties": { "model": { "enum": [ "openai/dall-e-3" ], "type": "string" }, "n": { "enum": [ 1 ], "type": "integer" }, "prompt": { "type": "string" }, "size": { "enum": [ "1024x1024" ], "type": "string" }, "stream": { "default": false, "enum": [ false ], "type": "boolean" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "body": { "model": "openai/dall-e-3", "n": 1, "prompt": "A calm studio product photograph with a plain background.", "size": "1024x1024" }, "content_type": "application/json" } }, "input": { "conditions": [ "Use stream:false or omit stream. The complete buffered JSON result contains all generated images." ], "content_type": "application/json", "material_types": [ "text" ], "optional": [ "stream", "n", "size" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "image" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "output": { "all_results": "Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.", "family": "image", "format": "JSON with all URL or base64 outputs" } }, "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" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.32768", "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.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "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=json.loads('{\"model\": \"openai/dall-e-3\", \"prompt\": \"A calm studio product photograph with a plain background.\", \"n\": 1, \"size\": \"1024x1024\"}')\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\n# Submit once. Retain the complete result, original identifiers and every response header.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "images", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "Images", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "image" ], "path": "/v1/images/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "cache_read_price": null, "cache_write_1h_price": null, "cache_write_price": null, "fast_multiplier": null, "flex_multiplier": null, "image_input_price": null, "image_output_price": null, "input_price": null, "intervals": null, "max_reasoning_effort_multiplier": null, "output_price": null, "per_request_price": null }, "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" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.32768", "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.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "request_estimate" } ] } ], "request_model_id": "openai/dall-e-3", "route_label": "Ultra", "status_reads": [], "tiers": [], "unit": "image", "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" }, { "amount": "0.32768", "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.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "request_estimate" } ] } }, { "html": "
O

OpenAI: DALL·E 3

OpenAI /dall-e-3

البداية

يولّد DALL·E 3 الصور من موجز مكتوب للمشهد. استخدم معرّف النموذج الدقيق openai/dall-e-3 أو اسمه البديل dall-e-3 مع طريقة توليد الصور، ثم احفظ كل URL صورة مُعاد والنتيجة المصاحبة. ينتج طلب البداية الموثّق صورة واحدة بمقاس 1024x1024 من النص.

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

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

DALL·E 3 نموذج OpenAI لتحويل النص إلى صورة. استخدم موجزًا مكتوبًا لإنشاء رسم توضيحي أو تصور مشهد أو توجه بصري لتصميم. صِف الموضوع والبيئة والتكوين والإضاءة والمعالجة في prompt. مثلًا، يمكن لموجز تصور أن يطلب دراجة توصيل بجوار متجر صغير عند الغسق، من منظور الشارع، مع موضوع واضح في المقدمة ولوحة ألوان هادئة.

أرسل POST /v1/images/generations مع جسم application/json. معرّف النموذج العام الدقيق هو openai/dall-e-3؛ ويختار الاسم البديل المعتمد dall-e-3 بطاقة النموذج نفسها. تتضمن صيغة البداية الموثّقة model وprompt وn:1 وsize:"1024x1024". n عدد صحيح اختياري وقيمته الافتراضية 1. أرسل stream:false، أو احذف stream، للحصول على نتيجة JSON كاملة. استخدم prompt نصيًا غير فارغ، وأبقِ هذا الطلب مركزًا على موجز صورة واحد كامل. الطريقة المقدّمة هي توليد الصور من النص.

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

استجابة التوليد هي JSON مع طابع زمني created ومصفوفة data. يتضمن عنصر النتيجة الموثّق url وقد يتضمن revised_prompt وprompt_filter_results وcontent_filter_results. احتفظ بهذه الحقول مع الاستجابة كاملة، ونزّل الصورة من كل URL موقّع من Ailoot يُعاد إليك. تدوم روابط ملفات Ailoot الموقّعة 24 ساعة من إصدارها. احتفظ بـ URL المُعاد الدقيق، بما فيه سلسلة الاستعلام، حتى يُحفظ الملف؛ وحدّد صيغة الصورة المحفوظة من الاستجابة الفعلية أو بايتات الملف.

تعامل مع ملف الصورة المُعاد بوصفه أصل التصميم القابل للاستخدام، ومع JSON بوصفه سجل التوليد المصاحب. راجع الصورة وفق الموجز المقدّم قبل وضعها في صفحة أو عرض تقديمي أو تطبيق. إذا كانت الاستجابة ناقصة أو كانت نتيجة الإرسال غير مؤكدة، فاحتفظ بمعرّف الطلب الأصلي والمعلومات المُعادة أثناء فحص المحاولة الموجودة، بدل إنشاء صورة أخرى لمجرد استعادة النتيجة المفقودة. ولاسترجاع النتائج المحفوظة، استخدم مفتاح API نفسه لإرسال GET /v1/media/assets?family=image وتابع كل next_cursor. يظهر معرّف الأصل في كل URL مُعاد لمسار /v1/media/assets/{asset_id}/content وفي سجله بمكتبة الوسائط. اقرأ GET /v1/media/assets/{asset_id} لكل سجل مختار ونزّل content_url الدقيق الخاص به. إذا أعاد طلب الملف 404 مع الرمز link_expired، فاقرأ الأصل نفسه مجددًا للحصول على رابط محدّث. لا يتطلب تحديث رابط أصل طلبًا آخر لتوليد الصور.

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

Ailoot Ultra · Images POST /v1/images/generations
الإدخال
text
الإخراج
image
صيغة الإخراج
ملف صورة
الحقلالنوعالمتطلبالقيم والحدودالقيمة الافتراضية
الحقلmodelالنوعstringالمتطلبمطلوبالقيم والحدود
dall-e-3
القيمة الافتراضية—
الحقلpromptالنوعstringالمتطلبمطلوبالقيم والحدودالقيمة الافتراضية—
الحقلstreamالنوعbooleanالمتطلباختياريالقيم والحدود
false
القيمة الافتراضيةfalse
الحقلnالنوعintegerالمتطلباختياريالقيم والحدود
⁦1⁩
القيمة الافتراضية—
الحقلsizeالنوعstringالمتطلباختياريالقيم والحدود
1024x1024
القيمة الافتراضية—
معلمات الطريقة ودورة حياتها
المعلمةالمواصفات
المعلمةcontent_typeالمواصفاتapplication/json
المعلمةrequiredالمواصفاتmodel, prompt
المعلمةoptionalالمواصفاتstream, n, size
المعلمةmaterial_typesالمواصفاتtext
المعلمةconditionsالمواصفاتUse stream:false or omit stream. The complete buffered JSON result contains all generated images.

دورة الحياة: synchronous_result_then_owned_library

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

الباقات

كيفية احتساب الرسوم النهائية

تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.

مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.

الوضع السريع
غير محدد عند اختيار الوضع السريع
الوضع المرن
غير محدد عند اختيار وضع flex
أقصى جهد للاستدلال
غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال

تعرفات تقديرية للمقارنة

الأسعار حسب الإعدادات

طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.

الإعداداتجدول التعرفةالكمية المتوقعةالرسوم
الإعداداتالتعرفات الأساسية للرموزجدول التعرفةالتعرفة الأساسيةالكمية المتوقعة—الرسوم
الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز
الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز
الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز
الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز
الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز
الإعداداتEstimated generation costجدول التعرفة—الكمية المتوقعةتقدير لتوليد واحدالرسوم
الإدخال · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.32768 تقدير قبل الإنشاء

This estimate is not an additional charge or a fixed rate for the completed generation.

تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →

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

Ailoot Ultra · Images

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=json.loads('{"model": "dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')\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\n# Submit once. Retain the complete result, original identifiers and every response header.\n

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

Ailoot Ultra · Images

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

الاحتفاظ بكل النتائج المكتملة

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

Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.

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

Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.

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

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

Ailoot Ultra openai/dall-e-3, dall-e-3

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

استخدم مسارات الطرائق المعروضة أعلاه.

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

openai/dall-e-3, dall-e-3

", "method_identity": { "effective_request_model_id": "dall-e-3", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "dall-e-3", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|dall-e-3", "ordinal": 1, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity.", "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, all actual results, original identifiers, usage and response headers.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "example_body": { "model": "dall-e-3", "n": 1, "prompt": "A calm studio product photograph with a plain background.", "size": "1024x1024" }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "image" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "outputs": { "all_results": "Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.", "family": "image", "format": "JSON with all URL or base64 outputs" }, "parameters": [ { "default_known": false, "enum": [ "dall-e-3" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "name": "prompt", "required": true, "type": "string" }, { "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" }, { "default_known": false, "enum": [ 1 ], "enum_known": true, "name": "n", "required": false, "type": "integer" }, { "default_known": false, "enum": [ "1024x1024" ], "enum_known": true, "name": "size", "required": false, "type": "string" } ], "request_schema": { "additionalProperties": true, "properties": { "model": { "enum": [ "dall-e-3" ], "type": "string" }, "n": { "enum": [ 1 ], "type": "integer" }, "prompt": { "type": "string" }, "size": { "enum": [ "1024x1024" ], "type": "string" }, "stream": { "default": false, "enum": [ false ], "type": "boolean" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "body": { "model": "dall-e-3", "n": 1, "prompt": "A calm studio product photograph with a plain background.", "size": "1024x1024" }, "content_type": "application/json" } }, "input": { "conditions": [ "Use stream:false or omit stream. The complete buffered JSON result contains all generated images." ], "content_type": "application/json", "material_types": [ "text" ], "optional": [ "stream", "n", "size" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "image" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "output": { "all_results": "Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.", "family": "image", "format": "JSON with all URL or base64 outputs" } }, "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" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.32768", "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.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "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=json.loads('{\"model\": \"dall-e-3\", \"prompt\": \"A calm studio product photograph with a plain background.\", \"n\": 1, \"size\": \"1024x1024\"}')\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\n# Submit once. Retain the complete result, original identifiers and every response header.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "images", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "Images", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "image" ], "path": "/v1/images/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "cache_read_price": null, "cache_write_1h_price": null, "cache_write_price": null, "fast_multiplier": null, "flex_multiplier": null, "image_input_price": null, "image_output_price": null, "input_price": null, "intervals": null, "max_reasoning_effort_multiplier": null, "output_price": null, "per_request_price": null }, "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" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.32768", "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.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "request_estimate" } ] } ], "request_model_id": "dall-e-3", "route_label": "Ultra", "status_reads": [], "tiers": [], "unit": "image", "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" }, { "amount": "0.32768", "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.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "request_estimate" } ] } } ], "model_id": "openai/dall-e-3", "nativeProvenance": { "input_facts_canonical_sha256": "9fc84054910fa20a0bd1460978aa8080a25b59b798d1095816e8c747d5f86e6f", "input_html_sha256": "e62d404688cf02623debe996baf5074d298cf1e92ff7869d6d5a689e69f4cb61", "private_audit_sha256": "6b6bea0d74e947c2b6d64aeb745d4d6ad305f3b8515ae190dbc955c3ff4d1b53", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/ar/openai-dall-e-3/", "description": "يولّد DALL·E 3 الصور من موجز مكتوب للمشهد. استخدم معرّف النموذج الدقيق openai/dall-e-3 أو اسمه البديل dall-e-3 مع طريقة توليد الصور، ثم احفظ كل URL صورة مُعاد والنتيجة المصاحبة. ينتج طلب البداية الموثّق صورة واحدة بمقاس 1024x1024 من النص.", "locale": "ar", "md_url": "https://ailoot.ai/models/ar/openai-dall-e-3/index.md", "title": "OpenAI: DALL·E 3 — Ailoot", "url": "https://ailoot.ai/models/ar/openai-dall-e-3/" }, "rawModel": { "about": "DALL·E 3 نموذج OpenAI لتحويل النص إلى صورة. استخدم موجزًا مكتوبًا لإنشاء رسم توضيحي أو تصور مشهد أو توجه بصري لتصميم. صِف الموضوع والبيئة والتكوين والإضاءة والمعالجة في prompt. مثلًا، يمكن لموجز تصور أن يطلب دراجة توصيل بجوار متجر صغير عند الغسق، من منظور الشارع، مع موضوع واضح في المقدمة ولوحة ألوان هادئة.\n\nأرسل POST /v1/images/generations مع جسم application/json. معرّف النموذج العام الدقيق هو openai/dall-e-3؛ ويختار الاسم البديل المعتمد dall-e-3 بطاقة النموذج نفسها. تتضمن صيغة البداية الموثّقة model وprompt وn:1 وsize:\"1024x1024\". n عدد صحيح اختياري وقيمته الافتراضية 1. أرسل stream:false، أو احذف stream، للحصول على نتيجة JSON كاملة. استخدم prompt نصيًا غير فارغ، وأبقِ هذا الطلب مركزًا على موجز صورة واحد كامل. الطريقة المقدّمة هي توليد الصور من النص.\n\nاجعل المتطلبات المهمة لموضع الاستخدام صريحة. يمكن لرسم توضيحي تحريري أن يذكر الفكرة المحورية والعناصر التي تعبّر عنها. ويمكن لتصور مشهد أن يحدد موضع الكاميرا ووقت اليوم وأجزاء التكوين التي تحتاج إلى مساحة حولها. أبقِ الصياغة الدقيقة التي يجب أن تظهر في الصورة متميزة عن أوصاف المشهد، ثم افحص الكتابة المرسومة والترتيب البصري قبل استخدام النتيجة المختارة.\n\nاستجابة التوليد هي JSON مع طابع زمني created ومصفوفة data. يتضمن عنصر النتيجة الموثّق url وقد يتضمن revised_prompt وprompt_filter_results وcontent_filter_results. احتفظ بهذه الحقول مع الاستجابة كاملة، ونزّل الصورة من كل URL موقّع من Ailoot يُعاد إليك. تدوم روابط ملفات Ailoot الموقّعة 24 ساعة من إصدارها. احتفظ بـ URL المُعاد الدقيق، بما فيه سلسلة الاستعلام، حتى يُحفظ الملف؛ وحدّد صيغة الصورة المحفوظة من الاستجابة الفعلية أو بايتات الملف.\n\nتعامل مع ملف الصورة المُعاد بوصفه أصل التصميم القابل للاستخدام، ومع JSON بوصفه سجل التوليد المصاحب. راجع الصورة وفق الموجز المقدّم قبل وضعها في صفحة أو عرض تقديمي أو تطبيق. إذا كانت الاستجابة ناقصة أو كانت نتيجة الإرسال غير مؤكدة، فاحتفظ بمعرّف الطلب الأصلي والمعلومات المُعادة أثناء فحص المحاولة الموجودة، بدل إنشاء صورة أخرى لمجرد استعادة النتيجة المفقودة. ولاسترجاع النتائج المحفوظة، استخدم مفتاح API نفسه لإرسال GET /v1/media/assets?family=image وتابع كل next_cursor. يظهر معرّف الأصل في كل URL مُعاد لمسار /v1/media/assets/{asset_id}/content وفي سجله بمكتبة الوسائط. اقرأ GET /v1/media/assets/{asset_id} لكل سجل مختار ونزّل content_url الدقيق الخاص به. إذا أعاد طلب الملف 404 مع الرمز link_expired، فاقرأ الأصل نفسه مجددًا للحصول على رابط محدّث. لا يتطلب تحديث رابط أصل طلبًا آخر لتوليد الصور.", "alias_of": null, "aliases": [ "dall-e-3" ], "author": "OpenAI", "ctx": null, "formats": [ "images" ], "id": "openai/dall-e-3", "input": [ "text" ], "kind": "image", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity.", "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, all actual results, original identifiers, usage and response headers.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "example_body": { "model": "openai/dall-e-3", "n": 1, "prompt": "A calm studio product photograph with a plain background.", "size": "1024x1024" }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "image" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "outputs": { "all_results": "Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.", "family": "image", "format": "JSON with all URL or base64 outputs" }, "parameters": [ { "default_known": false, "enum": [ "openai/dall-e-3" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "name": "prompt", "required": true, "type": "string" }, { "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" }, { "default_known": false, "enum": [ 1 ], "enum_known": true, "name": "n", "required": false, "type": "integer" }, { "default_known": false, "enum": [ "1024x1024" ], "enum_known": true, "name": "size", "required": false, "type": "string" } ], "request_schema": { "additionalProperties": true, "properties": { "model": { "enum": [ "openai/dall-e-3" ], "type": "string" }, "n": { "enum": [ 1 ], "type": "integer" }, "prompt": { "type": "string" }, "size": { "enum": [ "1024x1024" ], "type": "string" }, "stream": { "default": false, "enum": [ false ], "type": "boolean" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "body": { "model": "openai/dall-e-3", "n": 1, "prompt": "A calm studio product photograph with a plain background.", "size": "1024x1024" }, "content_type": "application/json" } }, "input": { "conditions": [ "Use stream:false or omit stream. The complete buffered JSON result contains all generated images." ], "content_type": "application/json", "material_types": [ "text" ], "optional": [ "stream", "n", "size" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "image" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "output": { "all_results": "Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.", "family": "image", "format": "JSON with all URL or base64 outputs" } }, "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" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.32768", "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.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "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=json.loads('{\"model\": \"openai/dall-e-3\", \"prompt\": \"A calm studio product photograph with a plain background.\", \"n\": 1, \"size\": \"1024x1024\"}')\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\n# Submit once. Retain the complete result, original identifiers and every response header.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "images", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "Images", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "image" ], "path": "/v1/images/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "cache_read_price": null, "cache_write_1h_price": null, "cache_write_price": null, "fast_multiplier": null, "flex_multiplier": null, "image_input_price": null, "image_output_price": null, "input_price": null, "intervals": null, "max_reasoning_effort_multiplier": null, "output_price": null, "per_request_price": null }, "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" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.32768", "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.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "request_estimate" } ] } ], "request_model_id": "openai/dall-e-3", "route_label": "Ultra", "status_reads": [], "tiers": [], "unit": "image", "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" }, { "amount": "0.32768", "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.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "request_estimate" } ] }, { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity.", "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, all actual results, original identifiers, usage and response headers.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "example_body": { "model": "dall-e-3", "n": 1, "prompt": "A calm studio product photograph with a plain background.", "size": "1024x1024" }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "image" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "outputs": { "all_results": "Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.", "family": "image", "format": "JSON with all URL or base64 outputs" }, "parameters": [ { "default_known": false, "enum": [ "dall-e-3" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "name": "prompt", "required": true, "type": "string" }, { "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" }, { "default_known": false, "enum": [ 1 ], "enum_known": true, "name": "n", "required": false, "type": "integer" }, { "default_known": false, "enum": [ "1024x1024" ], "enum_known": true, "name": "size", "required": false, "type": "string" } ], "request_schema": { "additionalProperties": true, "properties": { "model": { "enum": [ "dall-e-3" ], "type": "string" }, "n": { "enum": [ 1 ], "type": "integer" }, "prompt": { "type": "string" }, "size": { "enum": [ "1024x1024" ], "type": "string" }, "stream": { "default": false, "enum": [ false ], "type": "boolean" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "body": { "model": "dall-e-3", "n": 1, "prompt": "A calm studio product photograph with a plain background.", "size": "1024x1024" }, "content_type": "application/json" } }, "input": { "conditions": [ "Use stream:false or omit stream. The complete buffered JSON result contains all generated images." ], "content_type": "application/json", "material_types": [ "text" ], "optional": [ "stream", "n", "size" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "image" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "output": { "all_results": "Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.", "family": "image", "format": "JSON with all URL or base64 outputs" } }, "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" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.32768", "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.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "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=json.loads('{\"model\": \"dall-e-3\", \"prompt\": \"A calm studio product photograph with a plain background.\", \"n\": 1, \"size\": \"1024x1024\"}')\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\n# Submit once. Retain the complete result, original identifiers and every response header.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "images", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "Images", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "image" ], "path": "/v1/images/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "cache_read_price": null, "cache_write_1h_price": null, "cache_write_price": null, "fast_multiplier": null, "flex_multiplier": null, "image_input_price": null, "image_output_price": null, "input_price": null, "intervals": null, "max_reasoning_effort_multiplier": null, "output_price": null, "per_request_price": null }, "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" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.32768", "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.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "request_estimate" } ] } ], "request_model_id": "dall-e-3", "route_label": "Ultra", "status_reads": [], "tiers": [], "unit": "image", "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" }, { "amount": "0.32768", "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.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "openai/dall-e-3", "request_model_id": "openai/dall-e-3", "route_label": "Ultra" }, { "canonical_model_id": "openai/dall-e-3", "request_model_id": "dall-e-3", "route_label": "Ultra" } ], "name": "OpenAI: DALL·E 3", "price": { "in": null, "in_label": null, "out": null, "out_label": null, "sort_in": null, "sort_out": null, "varies": true }, "short": "يولّد DALL·E 3 الصور من موجز مكتوب للمشهد. استخدم معرّف النموذج الدقيق openai/dall-e-3 أو اسمه البديل dall-e-3 مع طريقة توليد الصور، ثم احفظ كل URL صورة مُعاد والنتيجة المصاحبة. ينتج طلب البداية الموثّق صورة واحدة بمقاس 1024x1024 من النص." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 }, { "contract_json_pointer": "/methods/1/rawMethod/contract", "html_json_pointer": "/methods/1/html", "method_ordinal": 1 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod", "/methods/1/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "يولّد DALL·E 3 الصور من موجز مكتوب للمشهد. استخدم معرّف النموذج الدقيق openai/dall-e-3 أو اسمه البديل dall-e-3 مع طريقة توليد الصور، ثم احفظ كل URL صورة مُعاد والنتيجة المصاحبة. ينتج طلب البداية الموثّق صورة واحدة بمقاس 1024x1024 من النص.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "2b6e2356e8d2476b3cf6816343ab4a36d5c42a1cd68472da654858e90ad6c6ce", "renderer_sha256": "081ee0fd5b6b1b60564b02c52d62547e01e922c8c0a16e91a0d055073e76a10e" }, "sourceRevision": "30e203e9af595ecb789d51414d592c5de9e45197678d0fa76cb0ee98066f57d0" }