تخطّي إلى المحتوى

Nucleus Image

التكامل

معرّف النموذج nucleus-image
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/nucleus-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

هذا الطلب: ≈⁨‏0.01 $⁩ 10 أرصدة API تشغيله في هذه الصفحة

الحصول على مفتاح API
Open model من نص إلى صورة #stylized#transform#typography

نموذج لتحويل النص إلى صورة بتصميم انتشار يعتمد على مزيج متناثر من الخبراء و7 إعدادات مسبقة لنسبة الأبعاد

Open model · صورة

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب

الموجّه الذي يوجّه توليد الصورة.

aspect_ratio الافتراضي 1:1

نسبة أبعاد الصورة المولّدة، المختارة من مجموعة الإعدادات المسبقة الثابتة في Nucleus-Image.

num_images الافتراضي 1

عدد الصور المطلوب توليده.

متقدم negative_prompt · output_format · num_inference_steps · guidance_scale · seed · enable_safety_checker
الافتراضي

الموجّه السلبي المطبق أثناء التوليد.

output_format الافتراضي png

تنسيق ملف الصورة الناتجة.

الافتراضي 50

عدد خطوات الاستدلال المطلوب تنفيذها.

الافتراضي 8

المقياس المطبق على التوجيه الخالي من المصنّف.

قيمة البذرة التي تجعل التوليد قابلاً لإعادة الإنتاج.

POST /run/nucleus-image?wait=20 عرض السعر → ⁨‏0.01 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/nucleus-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول Nucleus Image

ينشئ صورًا من `prompt` نصية، مع توفر `negative_prompt`. تُختار نسبة الأبعاد من سبعة إعدادات مسبقة: 1:1 و16:9 و9:16 و4:3 و3:4 و3:2 و2:3. يمكنك التحكم في `num_inference_steps` (من 1 إلى 100) و`guidance_scale` (من 0 إلى 20) و`seed`، وطلب ما يصل إلى صورتين بصيغة png أو jpeg.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
الموجّه الذي يوجّه توليد الصورة.
negative_promptاختياري
النوعstring
الافتراضي
الموجّه السلبي المطبق أثناء التوليد.
aspect_ratioاختياري
النوعenum
الافتراضي1:1
1:116:99:164:33:43:22:3
نسبة أبعاد الصورة المولّدة، المختارة من مجموعة الإعدادات المسبقة الثابتة في Nucleus-Image.
num_inference_stepsاختياري
النوعinteger
الافتراضي50
1 – 100
عدد خطوات الاستدلال المطلوب تنفيذها.
guidance_scaleاختياري
النوعnumber
الافتراضي8
0 – 20
المقياس المطبق على التوجيه الخالي من المصنّف.
seedاختياري
النوعinteger | null
قيمة البذرة التي تجعل التوليد قابلاً لإعادة الإنتاج.
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 2
عدد الصور المطلوب توليده.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
فحص السلامة، الذي يعيد صورًا سوداء بدلًا من أي صور مصنفة على أنها غير آمنة. تُمكّن القيمة true الفحص؛ وتعطله false للحسابات المخولة فقط، بينما تُفحص الطلبات من دون تخويل على أي حال.
output_formatاختياري
النوعenum
الافتراضيpng
jpegpng
تنسيق ملف الصورة الناتجة.
مطلوب الاسم الأساسي، مقبول أيضًا

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "nucleus-image",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 10,
    "usd": "0.01",
    "charged": 10,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "width": 1024,
        "height": 768,
        "content_type": "image/jpeg"
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
images
array of object {url, width, height, content_type}معلومات الملفات الخاصة بالصور المولّدة.
timings
object
seed
integerبذرة توليد الصورة، بما في ذلك القيمة المختارة عشوائيًا إذا لم يتضمن المدخل بذرة؛ وإلا تكرر القيمة المقدمة.
has_nsfw_concepts
array of booleanيشير إلى ما إذا كانت مفاهيم NSFW تظهر في الصور المُولّدة.
prompt
stringالموجّه المستخدم أثناء توليد الصورة.

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/nucleus-image.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt