رفتن به محتوا

FLUX.3 Klein

یکپارچه‌سازی

شناسه مدل blackforestlabs/flux-3/klein/text-to-image
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/blackforestlabs/flux-3/klein/text-to-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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

فایل‌هایی مانند نمونه: ⁨‎$۰٫۰۰۹⁩ ۹ اعتبار API · ≈ ⁨‎₽۰٫۹۷⁩ فایل‌های شما پیش از اجرا اندازه‌گیری می‌شوند اجرای آن در این صفحه

دریافت کلید API
Black Forest Labs متن به تصویر #image-generation#text-to-image#typography#graphic-design

تبدیل متن به تصویر با اندازه‌های بومی 4K، کنترل اختیاری چیدمان با کادر محدودکننده و حداکثر 4 تصویر در هر درخواست

ساخته‌شده در Doitong

آثار عمومی ساخته‌شده با FLUX.3 Klein توسط جامعه Doitong. یک پرامپت را با یک کلیک دوباره استفاده کنید.

آثار عمومی نمایش‌داده‌شده: 9
Close-up portrait seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lemb...

Close-up portrait seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut kebiruan, dikelilingi bunga teratai berkelopak penuh yang bermekaran indah di permukaan air. Rambutnya pirang pucat tersanggul longgar dengan beberapa helaian tipis jatuh alami membingkai sisi...

Close-up portrait seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lemb...

Close-up portrait seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut kebiruan, dikelilingi bunga teratai berkelopak penuh yang bermekaran indah di permukaan air. Rambutnya pirang pucat tersanggul longgar dengan beberapa helaian tipis jatuh alami membingkai sisi...

Prompt Details Seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut ...

Prompt Details Seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut kebiruan, dikelilingi bunga teratai berkelopak penuh yang bermekaran indah di permukaan air. Rambutnya pirang pucat tersanggul longgar dengan beberapa helaian tipis jatuh alami membingkai sisi...

Seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut kebiruan, dikel...

Seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut kebiruan, dikelilingi bunga teratai berkelopak penuh yang bermekaran indah di permukaan air. Rambutnya pirang pucat tersanggul longgar dengan beberapa helaian tipis jatuh alami membingkai sisi wajahnya. Ia memeluk...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat men...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat menggemaskan dengan mata cokelat besar yang ekspresif, rambut hitam berantakan yang tebal, mengenakan kaus putih kerah henley. Dia berpose dengan kedua tangan terkatup di depan dada, menunjukkan senyum...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat men...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat menggemaskan dengan mata cokelat besar yang ekspresif, rambut hitam berantakan yang tebal, mengenakan kaus putih kerah henley. Dia berpose dengan kedua tangan terkatup di depan dada, menunjukkan senyum...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat men...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat menggemaskan dengan mata cokelat besar yang ekspresif, rambut hitam berantakan yang tebal, mengenakan kaus putih kerah henley. Dia berpose dengan kedua tangan terkatup di depan dada, menunjukkan senyum...

Foto sinematik hiper-realistis resolusi tinggi menampilkan seorang pria muda Indonesia dengan tub...

Foto sinematik hiper-realistis resolusi tinggi menampilkan seorang pria muda Indonesia dengan tubuh ramping dan proporsional, rambut hitam pendek agak acak, mengenakan jaket kulit hitam, celana riding fit, dan sepatu motor. Ia sedang melakukan aksi freestyle ekstrem dengan motor sport 500cc...

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

•الزامی

دستورهای تولید تصویر که سوژه، کادر، نورپردازی و پس‌زمینه را با جزئیات توصیف می‌کنند و با شرح‌های جزئی استفاده‌شده برای آموزش مدل مطابقت دارند.

image_size پیش‌فرض square_hd

عرض و ارتفاع خروجی را به‌طور مستقل در محدوده 256–4096 پیکسل تنظیم کنید؛ تولید بومی 4K پشتیبانی می‌شود.

num_images پیش‌فرض 1

تعداد تصاویر درخواستی برای تولید.

پیشرفته output_format · seed · enable_prompt_expansion · enable_safety_checker · bounding_boxes
output_format پیش‌فرض png

قالب فایل تصویر نهایی.

seed برای تصاویر تکرارپذیر: پرامپت و seed یکسان، در صورت ثابت‌بودن نسخه مدل، تصویر یکسانی تولید می‌کنند.

چیدمان کادری اختیاری که هر شیء توصیف‌شده را به کادر اختصاص‌یافته محدود می‌کند؛ کادرها را با برچسب‌های پرامپت شناسایی کنید، مانند `A red fox <fox> sits under a red umbrella <umbrella>`. مختصات لبه‌های کادر را به‌صورت کسری از ابعاد تصویر و از مبدأ بالا-چپ (0, 0) بیان می‌کنند.

POST /run/blackforestlabs/flux-3/klein/text-to-image?wait=20 قیمت → ⁨‎$۰٫۰۰۹⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/blackforestlabs/flux-3/klein/text-to-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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

اجرای این درخواست

کلید شما در این مرورگر باقی می‌ماند: فقط به Doitong API ارسال می‌شود و فقط در صورت فعال‌کردن گزینه «یادآوری»، در localStorage ذخیره می‌شود. دریافت کلید API

درباره FLUX.3 Klein

از `prompt` متنی دقیق تصویر تولید می‌کند. هر ضلع `image_size` می‌تواند از 256 تا 4096 پیکسل باشد و در هر فراخوانی می‌توان 1 تا 4 تصویر درخواست کرد. حداکثر 32 `bounding_boxes` امکان قرار دادن اشیای نام‌گذاری‌شده در موقعیت‌های تعیین‌شده فریم را می‌دهند. خروجی می‌تواند png، jpeg یا webp باشد و گسترش پرامپت را می‌توان فعال یا غیرفعال کرد.

پارامترها

نام استاندارد یا نام بومی را ارسال کنید، نه هر دو. نام‌های استاندارد

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
دستورهای تولید تصویر که سوژه، کادر، نورپردازی و پس‌زمینه را با جزئیات توصیف می‌کنند و با شرح‌های جزئی استفاده‌شده برای آموزش مدل مطابقت دارند.
enable_prompt_expansionاختیاری
نوعboolean
پیش‌فرضtrue
گسترش پرامپت به شرحی جزئی پیش از تولید، در صورت true فعال می‌شود. هنگام ویرایش، شرح بر اساس تصاویر مرجع تهیه می‌شود.
seedاختیاری
نوعinteger | null
seed برای تصاویر تکرارپذیر: پرامپت و seed یکسان، در صورت ثابت‌بودن نسخه مدل، تصویر یکسانی تولید می‌کنند.
num_imagesاختیاری num_outputs
نوعinteger
پیش‌فرض1
۱ – ۴
تعداد تصاویر درخواستی برای تولید.
enable_safety_checkerاختیاری
نوعboolean
پیش‌فرضtrue
فعال‌سازی بررسی‌کننده ایمنی؛ true بررسی را فعال می‌کند.
output_formatاختیاری
نوعenum
پیش‌فرضpng
jpegpngwebp
قالب فایل تصویر نهایی.
image_sizeاختیاری
نوعobject
پیش‌فرضsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
عرض و ارتفاع خروجی را به‌طور مستقل در محدوده 256–4096 پیکسل تنظیم کنید؛ تولید بومی 4K پشتیبانی می‌شود.
bounding_boxesاختیاری
نوعobject[]
≤ ۳۲ مورد
چیدمان کادری اختیاری که هر شیء توصیف‌شده را به کادر اختصاص‌یافته محدود می‌کند؛ کادرها را با برچسب‌های پرامپت شناسایی کنید، مانند `A red fox <fox> sits under a red umbrella <umbrella>`. مختصات لبه‌های کادر را به‌صورت کسری از ابعاد تصویر و از مبدأ بالا-چپ (0, 0) بیان می‌کنند.
bounding_boxes[].labelاختیاری
نوعstring | null
≤ 64 characters
برچسب کوتاه شیء برای کادر، مانند `fox`؛ مقدار پیش‌فرض `obj_<n>` است. برای مرتبط‌کردن کلمات با کادر، `<fox>` را در پرامپت بگنجانید؛ کادرهای ذکرنشده در پرامپت به صحنه افزوده می‌شوند.
bounding_boxes[].descriptionالزامی
نوعstring
≤ 500 characters
شیئی که باید در کادر رندر شود، شامل ظاهر آن.
bounding_boxes[].boxالزامی
نوعobject
جای‌گذاری شیء در تصویر خروجی.
bounding_boxes[].box.x_minالزامی
نوعnumber
۰ – ۱
مرز چپ نسبت به عرض تصویر، از 0 تا 1.
bounding_boxes[].box.y_minالزامی
نوعnumber
۰ – ۱
مرز بالا نسبت به ارتفاع تصویر، از 0 تا 1.
bounding_boxes[].box.x_maxالزامی
نوعnumber
۰ – ۱
مرز راست نسبت به عرض تصویر، از 0 تا 1.
bounding_boxes[].box.y_maxالزامی
نوعnumber
۰ – ۱
مرز پایین نسبت به ارتفاع تصویر، از 0 تا 1.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "blackforestlabs/flux-3/klein/text-to-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": 9,
    "usd": "0.009",
    "charged": 9,
    "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",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
فایل‌های شما، انتخاب شماهر outputs[].url کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
images
array of object {url, content_type, file_name, file_size, width, height}تصاویر تولیدشده توسط مدل.
timings
objectاطلاعات زمان‌بندی فرایند تولید.
seed
integerseed تولید برای تصویر اول.
has_nsfw_concepts
array of booleanمشخص می‌کند مفاهیم NSFW در تصاویر تولیدشده ظاهر می‌شوند یا خیر.
prompt
stringپرامپت استفاده‌شده هنگام تولید تصویر.

مدل‌های بیشتر: متن به تصویر

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/blackforestlabs/flux-3/klein/text-to-image.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt