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

FLUX.1 [dev]

التكامل

معرّف النموذج flux/dev
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/flux/dev?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A lighthouse keeper'\''s cottage on a windswept cliff at blue hour, warm light glowing from small square windows, waves breaking far below, long-exposure sea mist, moody cinematic landscape photograph, 35mm, rich detail.",
    "num_outputs": 1
  }'

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

هذا الطلب: ⁨‏0.025 $⁩ 25 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API
Black Forest Labs من نص إلى صورة #open-weights#realism#versatile

نموذج FLUX الأساسي مفتوح الأوزان، أكثر حدة ووفاءً للمطالبات الطويلة من schnell.

أمثلة

المخرجات · ~31 ث
A lighthouse keeper's cottage on a windswept cliff at blue hour, warm light glowing from small square windows, waves ...

المطالبةA lighthouse keeper's cottage on a windswept cliff at blue hour, warm light glowing from small square windows, waves breaking far below, long-exposure sea mist, moody cinematic landscape photograph, 35mm, rich detail.

1⁨‏0.025 $⁩ · 25 رصيد API

إنشاء طلب

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

•مطلوب

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

image_size الافتراضي landscape_4_3

أبعاد الصورة المُولّدة.

num_images

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

متقدم output_format · acceleration · num_inference_steps · guidance_scale · seed
output_format الافتراضي jpeg

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

acceleration الافتراضي none

تسريع التوليد، إذ تقلل الإعدادات الأعلى الوقت اللازم لتوليد النتائج.

الافتراضي 28

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

الافتراضي 3.5

قوة الالتزام بالموجّه لاختيار الصورة، معبَّر عنها بصيغة CFG (Classifier Free Guidance).

بذرة لصور قابلة لإعادة الإنتاج: ينتج الموجّه والبذرة المتطابقان الصورة نفسها عند عدم تغيير إصدار النموذج.

POST /run/flux/dev?wait=20 عرض السعر → ⁨‏0.025 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/flux/dev?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A lighthouse keeper'\''s cottage on a windswept cliff at blue hour, warm light glowing from small square windows, waves breaking far below, long-exposure sea mist, moody cinematic landscape photograph, 35mm, rich detail.",
    "num_outputs": 1
  }'

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

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

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

حول FLUX.1 [dev]

نموذج FLUX المقطّر بالتوجيه، ذو 12 مليار معلمة، مع جدول أخذ عينات كامل (28 خطوة افتراضيًا، قابل للضبط من 1 إلى 50) ومقياس توجيه قابل للضبط. يتبع المطالبات التفصيلية ويرسم الأيدي والوجوه و النصوص القصيرة بصورة أفضل بوضوح من إصدار schnell، بسعر أعلى. أحجام محددة مسبقًا أو مخصصة، وما يصل إلى أربع صور لكل طلب، وإخراج JPEG أو PNG.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
الموجّه الذي يوجّه توليد الصورة.
image_sizeاختياري
النوعobject
الافتراضيlandscape_4_3
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
أبعاد الصورة المُولّدة.
num_inference_stepsاختياري
النوعinteger
الافتراضي28
1 – 50
عدد خطوات الاستدلال المطلوب تنفيذها.
seedاختياري
النوعinteger | null
بذرة لصور قابلة لإعادة الإنتاج: ينتج الموجّه والبذرة المتطابقان الصورة نفسها عند عدم تغيير إصدار النموذج.
guidance_scaleاختياري
النوعnumber
الافتراضي3.5
1 – 20
قوة الالتزام بالموجّه لاختيار الصورة، معبَّر عنها بصيغة CFG (Classifier Free Guidance).
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 4
عدد الصور المطلوب توليده.
output_formatاختياري
النوعenum
الافتراضيjpeg
jpegpng
تنسيق ملف الصورة الناتجة.
accelerationاختياري
النوعenum
الافتراضيnone
noneregularhigh
تسريع التوليد، إذ تقلل الإعدادات الأعلى الوقت اللازم لتوليد النتائج.
مطلوب الاسم الأساسي، مقبول أيضًا

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "flux/dev",
  "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": 25,
    "usd": "0.025",
    "charged": 25,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field, telephoto lens",
    "image_size": "landscape_4_3",
    "num_outputs": 1
  },
  "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://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/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/flux/dev.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt