API تولید و بازتولید تصویر با هوش مصنوعی Flux | مستندات

API Flux به شما امکان ایجاد تصاویر سفارشی یا تولید نسخه‌های خلاقانه از یک تصویر موجود را می‌دهد. این سرویس از آخرین مدل‌های Black Forest Labs پشتیبانی می‌کند.

Flux AI Image Generator یک ابزار پیشرفته متن‌به‌تصویر و تصویر‌به‌تصویر است که توسط مدل‌های سری Flux قدرت گرفته شده است. این API به صورت اختصاصی، با سرعت بالا و پشتیبانی چندزبانه توسط TalkBot ارائه می‌شود.

مدل‌های پشتیبانی‌شده

🔹 FLUX-1-schnell

سریع‌ترین مدل Flux. مناسب برای تولید سریع تصاویر با کیفیت خوب در 1 تا 4 استپ. برای استفاده‌های عمومی و حجم بالا ایده‌آل است.

🔹 FLUX-1-dev

نسخه تعادل‌یافته بین سرعت و کیفیت. از 1 تا 50 استپ پشتیبانی می‌کند و انعطاف‌پذیری بیشتری نسبت به schnell دارد.

🔹 FLUX-2-dev

نسخه به‌روزشده dev با معماری مدولارتر و عملکرد بهتر. از image-to-image پایه‌ای نیز پشتیبانی می‌کند.

🔹 FLUX-pro

اولین مدل پرچمدار Black Forest Labs. کیفیت بالا، پشتیبانی از safety tolerance و تنظیمات پیشرفته‌تر.

🔹 FLUX-1.1-pro

نسخه بهبودیافته pro با پیروی بهتر از prompt، جزئیات غنی‌تر و تنوع بالاتر در خروجی.

🔹 FLUX-2-pro

مدل پیشرفته‌تر با دقت رنگی و استدلال فضایی بی‌نظیر. مناسب برای تصاویر فوتورئالیسم با کنترل دقیق.

🔹 FLUX-2-max

بالاترین کیفیت در سری Flux. برای کاربردهای حرفه‌ای و خروجی‌های چاپی یا HD طراحی شده است.

🔹 FLUX-1-Redux-dev

مدل "تنوع تصویر" (image variation). از یک تصویر ورودی، نسخه‌های خلاقانه با سبک یا ترکیب‌بندی متفاوت تولید می‌کند. prompt اختیاری است و فقط از طریق multipart/form-data قابل استفاده است.

نقاط پایانی API

نقطه پایانی	توضیحات
/v1/media/flux/REQ	ایجاد تصویر سفارشی یا بازتولید تصویر ورودی بر اساس مدل انتخابی.

احراز هویت

کلید API باید در هدر Authorization به صورت زیر ارسال شود:

$headers = [
'Authorization: Bearer sk-1e3f1c5850b4a1e8e5c4d7e8b7cfa3b2'
];

پارامترهای درخواست

پارامتر	توضیحات	الزامی
model	یکی از مقادیر زیر: schnell, dev, flux-2-dev, pro, flux-1.1-pro, flux-2-pro, flux-2-max, redux-dev	بله
prompt	متن پیشنهاد شده (فارسی/انگلیسی/عربی/ترکی). برای redux-dev اختیاری است.	بله (به جز redux-dev)
image	فایل تصویر ورودی (فقط برای redux-dev). ارسال با multipart/form-data.	بله (فقط برای redux-dev)
width	عرض تصویر (مضرب 32). - schnell/dev/flux-2-dev/redux: 128–1920 - pro/flux-1.1-pro/flux-2-pro/flux-2-max: 256–1440	خیر (پیش‌فرض: 1024)
height	ارتفاع تصویر (مضرب 32). محدوده مشابه width.	خیر (پیش‌فرض: 1024)
response_format	قالب خروجی: jpeg یا png. خروجی همیشه به صورت b64_json است.	خیر (پیش‌فرض: jpeg)
num_inference_steps	تعداد استپ‌ها: - schnell: 1–50 - dev/flux-2-dev/redux: 1–50 (flux-2-dev: 1–100) - pro/flux-1.1-pro/flux-2-pro/flux-2-max: تنظیم داخلی	خیر
guidance_scale	وفاداری به prompt (0–20). در pro/max کاربرد محدودتری دارد.	خیر
safety_tolerance	سطح تحمل فیلتر (0–6). فقط در مدل‌های pro و بالاتر.	خیر
seed	عدد ثابت برای تکرارپذیری.	خیر

مثال: تولید تصویر (PHP - JSON)

$headers = [
'Authorization: Bearer sk-1e3f1c5400b4a1e8045607e8b7cfa3b3',
'Content-Type: application/json'
];
$data = json_encode([
'model' => 'schnell',
'prompt' => 'a cat in the city.',
'width' => 1024,
'height' => 1024,
'response_format' => 'png'
]);
$url = 'https://api.talkbot.ir/v1/media/flux/REQ';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
echo $response;
curl_close($ch);

مثال: بازتولید تصویر (Redux Dev - PHP)

$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.talkbot.ir/v1/media/flux/REQ',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer sk-1e3f1c5400b4a1e8045607e8b7cfa3b3'],
CURLOPT_POSTFIELDS => [
'model' => 'redux-dev',
'width' => 1024,
'height' => 1024,
'image' => new CURLFile('path/to/image.jpg')
]
]);
$response = curl_exec($curl);
echo $response;
curl_close($curl);

تعرفه‌ها (بر اساس مدل)

هزینه هر درخواست بر اساس مدل و پارامترهای آن محاسبه و از اعتبار کاربر (به صورت توکن) کسر می‌شود:

• FLUX-1-schnell: 12,000 توکن
• FLUX-1-dev: 13,000 توکن
• FLUX-2-dev: 14,000 توکن
• FLUX-pro: 15,000 توکن
• FLUX-1.1-pro: 15,500 توکن
• FLUX-2-pro: 16,000 توکن
• FLUX-2-max: 17,000 توکن
• FLUX-1-Redux-dev: 13,000 توکن

⚠️ توجه: مصرف توکن مستقل از پارامترهای تصویر (مثل اندازه) است و بر اساس مدل ثابت در نظر گرفته شده است.

آزمایش رایگان:

برای آزمایش و تست رایگان این وب سرویس (API) ابتدا در سایت ثبتنام کنید، و سپس از طریق کنترل پنل کاربری، کلید اختصاصی خود را ایجاد کنید. پس از ایجاد کلید، آن را در نمونه کدهای بالا جایگزاری کرده و خروجی را مشاهده کنید. امکان استفاده از کلید آزمایشی فقط تا 15000 توکن میسر است.

سایر وب سرویس ها:

با خرید بسته یاقوتی و یا یکی از بسته های فرایاقوتی، شما علاوه بر وب سرویس یا API پیش رو، از وب سرویس های زیر نیز میتوانید استفاده کنید.