FLUX 3 Image: لے آؤٹ باکسز اور مخصوص ترمیمات کے لیے رہنما

FLUX 3 Image آپ کو امیج پرامپٹ کے حصے کے طور پر مستطیلیں استعمال کرتے ہوئے یہ بتانے دیتا ہے کہ الگ الگ عناصر کہاں رکھے جائیں۔ یہی نظام حوالہ جاتی تصویر میں ترمیم بھی کرتا ہے: ہر عنصر کے لیے اصل جگہ، نئی جگہ اور مطلوبہ تبدیلی کی وضاحت دی جا سکتی ہے۔ Black Forest Labs نے امیج اینڈ پوائنٹ کو اپنے یکم اکتوبر 2026 کے ریلیز نوٹس میں شامل کیا۔

ڈیزائنرز اور تخلیق کاروں کے لیے اہم فرق یہ ہے کہ آیا پوری ترکیب پہلے سے بنانی ہے یا موجودہ تصویر کے کسی عنصر کو تبدیل کرنا ہے۔ یہ گائیڈ بتاتی ہے کہ دونوں میں سے کس کا انتخاب کریں، مستطیل کو مطلوبہ نقاط میں کیسے بدلیں، اور API کا نتیجہ کیسے حاصل کریں۔ یہ صرف دستاویزات پر مبنی گائیڈ ہے، جسے 3 اکتوبر 2026 کو جانچا گیا۔ BIG CHANGE نے اس پروڈکٹ سے کوئی تصویر تیار یا ترمیم نہیں کی۔

بڑی تبدیلی

• کیا بدلا: BFL کی یکم اکتوبر کی ریلیز میں کمپوزیشن اور ترمیم کے لیے یہ اینڈ پوائنٹ درج ہے: v1/flux-3-image۔ منظر کی وضاحت اور عناصر کی JSON فہرست ایک ہی پرامپٹ میں شامل ہوتی ہے، جبکہ باکسز پوزیشن یا ترمیم متعین کرتے ہیں۔ BFL کے ریلیز نوٹس
• یہ کیوں اہم ہے: تخلیق کار پہلے طے کیے گئے مستطیل کو نقاط میں تبدیل کر سکتے ہیں، پھر بتا سکتے ہیں کہ حوالہ جاتی تصویر کے کن عناصر کو برقرار رکھنا، منتقل کرنا یا بدلنا ہے۔ عملی انتخاب یہ ہے کہ کتنی تفصیل دینی ہے: پوری کمپوزیشن، سادہ ہدایت یا ترمیم کی واضح جدول۔ BFL کا باکس ٹیوٹوریل
• کن باتوں پر نظر رکھیں: درخواست بھیجنے سے پہلے ریزولوشن اور بجٹ طے کریں: درج شدہ 1k اور 4k فی تصویر 0.048 اور 0.607 ڈالر ہیں۔ مکمل نتیجہ دیکھیں، کیونکہ باکسز سے عناصر باہر نکل سکتے ہیں اور ترمیم آس پاس کی روشنی، سائے یا عکس کو متاثر کر سکتی ہے۔ BFL کی قیمتیں، ترمیم کی حدود

براؤزر یا API کا راستہ منتخب کریں

BFL کا پروڈکٹ صفحہ داخلے کے دو طریقے بتاتا ہے: اس کے براؤزر والے Playground میں باکسز بنائیں یا API کے ذریعے لے آؤٹ پرامپٹ بھیجیں۔ دستاویزات Playground سے جوڑتی ہیں جہاں کوڈ کے بغیر استعمال کیا جا سکتا ہے۔ اگر آپ خود خطے بنانا چاہتے ہیں تو براؤزر کا راستہ اختیار کریں؛ اگر درخواست میں نقاط دینا اور نتیجہ پروگرام کے ذریعے حاصل کرنا ہو تو API استعمال کریں۔ ہم نے موجودہ Playground کنٹرولز نہیں دیکھے، اس لیے ذیل کی ہدایات دستاویزی درخواست کی شکل سمجھاتی ہیں، براؤزر میں بٹن دبانے کے مراحل نہیں۔

API استعمال کرنے کے لیے BFL اکاؤنٹ بنائیں، اس میں کریڈٹ شامل کریں اور ڈیش بورڈ سے کلید حاصل کریں۔ JSON کے ساتھ POST درخواست کو https://api.bfl.ai/v1/flux-3-image پر بھیجیں، Content-Type: application/json استعمال کریں اور کلید x-key ہیڈر میں رکھیں۔ صرف prompt درکار ہے۔ BFL کی جنریشن گائیڈ، قیمتیں اور سیٹ اپ

FLUX 3 Image اور FLUX 3 Dev کو الگ رکھیں: یہ ہدایات BFL کے میزبان کردہ Image اینڈ پوائنٹ کے لیے ہیں۔ Image پروڈکٹ صفحہ سیلز کے ذریعے کمرشل ویٹس لائسنس کی پیش کش کرتا ہے۔ اس گائیڈ کے لیے دیکھی گئی دستاویزات میں FLUX 3 Image کے اوپن ویٹس ڈاؤن لوڈ کی تصدیق نہیں ملتی۔ FLUX 3 Image تک رسائی

طے کریں کہ تصویر کے کتنے حصے خود متعین کرنے ہیں

BFL کے مطابق، سادہ ترمیم میں پرامپٹ کی توسیع کے دوران خودکار طور پر باکس حاصل کیا جا سکتا ہے۔ واضح کنٹرول کے لیے اپنی جدول فراہم کریں۔ عام ہدایات میں “image 1” سے مراد پہلا حوالہ ہوتا ہے؛ ترمیم کی قطاروں میں یہی حوالہ ref_image_0 ہوتا ہے۔ BFL کی ترمیمی گائیڈ

حوالہ جات کو images میں URL یا base64 ڈیٹا کی صورت میں بطور متن یا فہرست بھیجیں۔ ایسا کرنے پر 1 سے 10 تصاویر دی جا سکتی ہیں، ہر تصویر 256 × 256 پکسل سے 16 میگا پکسل تک ہو۔ طے شدہ aspect_ratio ہے auto؛ یہ پہلے حوالہ جاتی تصویر کی پیروی کرتا ہے، یا حوالہ نہ ہو تو مربع تصویر بناتا ہے۔ اگر لے آؤٹ کے لیے خاص شکل درکار ہو تو اسے واضح طور پر مقرر کریں۔ BFL کا اینڈ پوائنٹ جائزہ

مستطیل کو باکس میں تبدیل کریں

ہر باکس [top, left, bottom, right] ہوتا ہے، جس کے نقاط 0 سے 1000 تک کے صحیح اعداد ہیں۔ عمودی نقاط پہلے آتے ہیں۔ ہر محور پوری تصویر پر الگ الگ پھیلا ہوتا ہے، اس لیے یہ گرڈ افقی یا عمودی کینوس کے مطابق کھنچ جاتا ہے۔ BFL کا باکس فارمیٹ

پکسل کی پوزیشنوں کو تبدیل کرنے کے لیے اوپر اور نیچے کے اعداد کو تصویر کی اونچائی پر، اور بائیں اور دائیں کے اعداد کو اس کی چوڑائی پر تقسیم کریں۔ ہر حاصل کو 1000 سے ضرب دیں اور قریب ترین عدد تک گول کریں۔ BFL نے اس تبدیلی کی وضاحت 1920 × 1080 کے کینوس سے کی ہے:

اس لیے باکس [100, 200, 900, 800] ہے۔ اس کا عمودی پھیلاؤ فریم کے 10% سے 90% تک، اور افقی پھیلاؤ 20% سے 80% تک ہے۔ اس حساب سے واضح ہوتا ہے کہ چوڑائی اور اونچائی بدل دینے یا اوپر کے بجائے بائیں کا عدد پہلے دینے سے مطلوبہ خطہ بدل جاتا ہے۔ لے آؤٹ بناتے وقت استعمال کیا گیا پہلو کا تناسب برقرار رکھیں۔ BFL کے نقاط کی تبدیلی

نئی تصویر بنائیں

پوری کمپوزیشن کی وضاحت لکھیں اور عناصر کی نشاندہی <id> مارکرز سے کریں۔ اس کے بعد ہر عنصر کے لیے id، bbox اور desc کے ساتھ JSON کی ایک فہرست شامل کریں۔ یہ فہرست prompt کے اندر متن ہوتی ہے، API کی ایک اور بالائی سطح کی فیلڈ نہیں۔

BFL کی دستاویزی دوڑتے ہوئے انسانی خاکے کی مثال میں پس منظر پورے کینوس کو ڈھانپتا ہے اور شکل درمیانی باکس میں آتی ہے۔ یہ مختصر درخواست اسی مثال کے لے آؤٹ پر مبنی ہے؛ BIG CHANGE نے اسے نہیں چلایا:

{
  "prompt": "A black running silhouette <silhouette_1> on a chartreuse background <background_1>. [{\"id\":\"background_1\",\"bbox\":[0,0,1000,1000],\"desc\":\"Chartreuse background with paper texture\"},{\"id\":\"silhouette_1\",\"bbox\":[150,150,850,850],\"desc\":\"Black running silhouette with stippled texture\"}]",
  "aspect_ratio": "1:1",
  "resolution": "1k"
}

متن والے لے آؤٹ کے لیے ہر سطر کی الگ قطار بنائیں اور مطلوبہ عین الفاظ desc میں رکھیں۔ باکسز جگہ اور پیمانے کی رہنمائی کرتے ہیں؛ BFL خبردار کرتا ہے کہ عنصر اپنی مستطیل سے باہر پھیل سکتا ہے۔ یہ سخت تراشنے والے ماسک نہیں ہیں۔ BFL کا کمپوزیشن ٹیوٹوریل اور حدود

موجودہ تصویر میں ترمیم کریں

ماخذ تصویر images میں دیں۔ ترمیم کی قطاروں میں id اور desc برقرار رہتے ہیں، مگر ان کی جگہ bbox کے یہ فیلڈز آتے ہیں:

ہدایت اور ترمیم کی فہرست کو prompt میں یکجا کریں، جیسا کہ نئی کمپوزیشن میں کرتے ہیں۔ نئی چیزوں کے اضافے اور ہٹانے دونوں جگہ واضح کریں۔ جن عناصر کو اپنی جگہ برقرار رکھنا ہو، ان کے لیے keep قطاریں شامل کریں۔ BFL کی گائیڈ کے مطابق باکسز سے باہر کے پکسلز عموماً یکساں رہتے ہیں، لیکن قریب کی روشنی، عکس اور سائے بدل سکتے ہیں۔ ترمیم قبول کرنے سے پہلے پورے نتیجے کا ماخذ سے موازنہ کریں۔ BFL نے یہ بھی بتایا کہ اس کی اپنی جانچ میں تقریباً 40 × 25 پکسل کے باکسز میں نئے عناصر اکثر نظر نہیں آئے؛ یہ فراہم کنندہ کا مشاہدہ ہے، کوئی عالمگیر کم از کم حد یا BIG CHANGE کی جانچ نہیں۔ BFL کی ترمیمی رہنمائی، ترمیمی قطار کا خاکہ

ریزولوشن اور بجٹ منتخب کریں

جائزے کے صفحے پر یہ درج ہیں 768sq، 1k، 1.5k، 2k اور 4k، جبکہ 1k طے شدہ ہے۔ قیمتوں کا صفحہ یہ نرخ دیتا ہے؛ اس میں 1.5k کی قیمت درج نہیں۔ یہ اختیار استعمال کرنے سے پہلے اس کی لاگت معلوم کریں۔ BFL کا جائزہ

یہ BFL کے درج کردہ امریکی ڈالر کے نرخ ہیں، جنہیں 3 اکتوبر کو جانچا گیا۔ دس درخواستوں کا کالم حسابی مثال ہے، اصل خرچ کی پیمائش نہیں۔ BFL API اور Playground کے لیے ایک ہی قیمت درج کرتا ہے، جہاں ایک کریڈٹ 0.01 ڈالر کے برابر ہے۔ جمع کرانے کے جواب میں cost شامل ہوتا ہے۔ 4k درخواست کی درج شدہ لاگت تقریباً 12.6 گنا 1k کی درج شدہ لاگت ہے؛ اپنے کام کی ضرورت کے مطابق آؤٹ پٹ سائز منتخب کریں اور اضافی کوششوں کے لیے بجٹ رکھیں۔ ریزولوشن بدلنا نئی درخواست ہے، اور اس گائیڈ سے یہ ثابت نہیں ہوتا کہ دو درخواستوں کے نتائج میں کمپوزیشن یکساں ہوگی۔ BFL کی قیمتیں

اختیاری grounding سیٹنگ بطورِ طے شدہ true ہے، جو جنریشن سے پہلے ویب اور تصویر کی تلاش کی اجازت دیتی ہے۔ BFL کے مطابق اسے بند کرنے سے صرف پرامپٹ استعمال ہو گا اور نتیجہ تیزی سے ملے گا۔ ہم نے اس رفتار کے فرق کی پیمائش یا تلاش سے گراؤنڈ کیے گئے نتیجے کی درستگی کی توثیق نہیں کی۔ BFL کی گراؤنڈنگ دستاویزات

جمع کریں، نتیجے کا انتظار کریں اور آؤٹ پٹ محفوظ کریں

جمع کرانے کے بعد واپس ملنے والا polling_url محفوظ رکھیں اور اسی URL کو اپنی API کلید کے ساتھ دوبارہ چیک کریں۔ یہ اس ریجن کی طرف اشارہ کرتا ہے جہاں ٹاسک رکھا گیا ہے۔ Pending، Reasoning اور Generating کا مطلب ہے کہ کام ابھی جاری ہے۔ Ready پر result.sample ڈاؤن لوڈ کریں؛ اس کا دستخط شدہ لنک ایک گھنٹے بعد ختم ہو جاتا ہے۔ ڈاؤن لوڈ URL کو اپنا x-key ہیڈر نہ بھیجیں۔ نتیجے میں result.prompt بھی ہوتا ہے، جس میں توسیع شدہ ہدایت دکھائی جاتی ہے، اور result.duration بھی، جو جنریشن کا وقت بتاتا ہے۔ BFL کی بازیافت کی ہدایات

مسدود یا ناکام ٹاسک کا جواب جاری ٹاسک سے مختلف ہونا چاہیے۔ Request Moderated کا مطلب ہے کہ ان پٹ مسدود ہوا؛ Content Moderated کا مطلب ہے کہ آؤٹ پٹ مسدود ہوا۔ دوسری کوشش سے پہلے ان پٹ تبدیل کریں۔ Error کی صورت میں جواب دیکھیں؛ نامعلوم یا میعاد گزر چکا ٹاسک Task not found واپس کرتا ہے۔ BFL خبردار کرتا ہے کہ ناکام ٹاسک معمول کے JSON جواب کے ساتھ HTTP 503 کے طور پر آ سکتا ہے، اس لیے دوبارہ کوشش سے پہلے اس کا status پڑھیں۔ حد سے بڑی حوالہ جاتی تصاویر 400 دے سکتی ہیں؛ نامعلوم فیلڈ، غلط قدر، خالی پرامپٹ یا بہت چھوٹی تصویر 422 دے سکتی ہے۔ دوسرے اینڈ پوائنٹس کے فیلڈز جیسے seed، width اور input_image یہاں قبول نہیں کیے جاتے۔ BFL کی جنریشن اور غلطیوں کی گائیڈ

کوشش تب مکمل ہے جب آپ نے آؤٹ پٹ محفوظ کر لیا اور اس کی جگہ، مطلوبہ متن اور ترمیم کے آس پاس کے حصوں کا معائنہ کر لیا۔ Ready جواب سے ثابت ہوتا ہے کہ نتیجہ دستیاب ہے؛ آیا وہ کام کی ضرورت پوری کرتا ہے، یہ آپ کے بصری جائزے سے طے ہوگا۔

ماخذ اور مزید مطالعہ

• FLUX 3 Image کا پروڈکٹ صفحہ : براؤزر اور API کے راستوں اور کمرشل ویٹس تک رسائی کی تصدیق کرتا ہے۔ اس کے ڈیمو فراہم کنندہ کا مواد ہیں، ہمارے ٹیسٹ کے نتائج نہیں۔
• یکم اکتوبر کے ریلیز نوٹس : تصویر کی ریلیز کی تاریخ دیتے اور مشترکہ اینڈ پوائنٹ کی وضاحت کرتے ہیں۔ وسیع کنٹرول سے متعلق دعووں کو ٹیوٹوریلز میں درج محدود تر شرائط کے ساتھ پڑھیں۔
• اینڈ پوائنٹ کا جائزہ : پیرامیٹرز، حوالہ جاتی تصاویر کی حدود، ریزولوشن کے انتخاب اور گراؤنڈنگ کے رویے کی تفصیل دیتا ہے۔
• باؤنڈنگ باکس ٹیوٹوریل : اوپر ڈھالی گئی دو قطاری ساختوں اور دوڑتے انسانی خاکے کی مثال سمجھاتا ہے۔
• ترمیم کی گائیڈ : نقاط کی تبدیلی، حوالہ جاتی تصاویر کی ترتیب، چھوٹے خطوں اور اردگرد کے پکسلز سے متعلق احتیاطوں کی تائید کرتی ہے۔
• جنریشن گائیڈ : تصدیق، غیر ہم وقتی بازیافت، میعاد ختم ہونے والے لنکس اور غلطیوں کی وضاحت کرتی ہے۔
• قیمتیں : ہماری حسابی مثال میں استعمال شدہ نرخ دیتی ہے۔ کسی کوشش پر خرچ کرنے سے پہلے تازہ دستاویزات میں قیمتیں اور درخواست کے پیرامیٹرز دوبارہ دیکھیں۔ یہ براہِ راست اپ ڈیٹ ہونے والی دستاویزات ہیں۔