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

API Flux به شما امکان ایجاد تصاویر سفارشی با استفاده از هوش مصنوعی را می‌دهد.

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

نقاط پایانی API

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


احراز هویت

برای استفاده از API Flux، شما به یک کلید API نیاز دارید. می‌توانید با ثبت‌نام در حساب تاک بات، کلید API دریافت کنید.

کلید API باید در هدر Authorization درخواست‌های API قرار داده شود، مانند این:


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

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

پارامتر توضیحات الزامی
model مدل Flux مورد استفاده برای ایجاد تصویر. مقادیر ممکن: schnell، dev، pro. بله
response_format قالب خروجی برای تصویر تولید شده. مقادیر ممکن: webp، jpg، png. خروجی به صورت b64_json خواهد بود. بله
prompt متن پیشنهاد شده برای ایجاد تصویر. (می تواند فارسی ، انگلیسی یا عربی و ترکی باشد) بله
aspectRatio نسبت ابعاد مورد نظر برای تصویر تولید شده. مقادیر ممکن بر اساس مدل به شرح زیر است:
  • schnell: 1:1, 16:9, 21:9, 2:3, 3:2, 4:5, 5:4, 9:16, 9:21
  • dev: 1:1, 16:9, 21:9, 2:3, 3:2, 4:5, 5:4, 9:16, 9:21
  • pro: 1:1, 16:9, 21:9, 2:3, 3:2, 4:5, 5:4, 9:16
بله


مثال استفاده (PHP)


$headers = [
    'Authorization: Bearer sk-1e3f1c5400b4a1e8045607e8b7cfa3b3'
];
$data = [
    'model' => 'schnell',
    'response_format' => 'png',
    'prompt' => 'a cat in the city.',
    'aspectRatio' => '1:1'
];
$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);
echo $response = curl_exec($ch);
if(curl_errno($ch)){
    echo  curl_error($ch);
}
curl_close($ch);
    

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

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


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

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