OpenAI: DALL·E 3
يولّد DALL·E 3 الصور من موجز مكتوب للمشهد. استخدم معرّف النموذج الدقيق openai/dall-e-3 أو اسمه البديل dall-e-3 مع طريقة توليد الصور، ثم احفظ كل URL صورة مُعاد والنتيجة المصاحبة. ينتج طلب البداية الموثّق صورة واحدة بمقاس 1024x1024 من النص.
- Ailoot Ultra · Images
POST /v1/images/generationsopenai/dall-e-3 - Ailoot Ultra · Images
POST /v1/images/generationsdall-e-3
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في 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 Ultra · Images POST /v1/images/generations openai/dall-e-3
openai/dall-e-3openai/dall-e-3dall-e-3
البداية
يولّد DALL·E 3 الصور من موجز مكتوب للمشهد. استخدم معرّف النموذج الدقيق openai/dall-e-3 أو اسمه البديل dall-e-3 مع طريقة توليد الصور، ثم احفظ كل URL صورة مُعاد والنتيجة المصاحبة. ينتج طلب البداية الموثّق صورة واحدة بمقاس 1024x1024 من النص.
- المدخلات المقبولة
- النص
- النتائج
- الصور
متاح في 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
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "openai/dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
استلام النتائج وحفظها
Ailoot Ultra · Images
نزّل كل صورة مُرجعة أو احفظ محتواها بصيغة Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
الاحتفاظ بكل النتائج المكتملة
احفظ كل صورة مكتملة؛ نزّلها من كل 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
Ailoot Ultra · Images POST /v1/images/generations dall-e-3
dall-e-3openai/dall-e-3dall-e-3
البداية
يولّد DALL·E 3 الصور من موجز مكتوب للمشهد. استخدم معرّف النموذج الدقيق openai/dall-e-3 أو اسمه البديل dall-e-3 مع طريقة توليد الصور، ثم احفظ كل URL صورة مُعاد والنتيجة المصاحبة. ينتج طلب البداية الموثّق صورة واحدة بمقاس 1024x1024 من النص.
- المدخلات المقبولة
- النص
- النتائج
- الصور
متاح في 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
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
استلام النتائج وحفظها
Ailoot Ultra · Images
نزّل كل صورة مُرجعة أو احفظ محتواها بصيغة Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
الاحتفاظ بكل النتائج المكتملة
احفظ كل صورة مكتملة؛ نزّلها من كل 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
FAQ · OpenAI: DALL·E 3
- ما المدخلات والنتائج المتاحة؟
POST /v1/images/generations·openai/dall-e-3:text→imagePOST /v1/images/generations·dall-e-3:text→image- ما الحقول التي يستخدمها الطلب؟
POST /v1/images/generations·openai/dall-e-3:model,prompt,stream,n,sizePOST /v1/images/generations·dall-e-3:model,prompt,stream,n,size