تولید تصویر با AI
ساخت تصویر از متن با یک درخواست سازگار با OpenAI
مستندات
شروع سریع
با یک درخواست ساده، تصاویر باکیفیت بسازید:
curl https://api-ai.hibanacloud.ir/v1/images/generations \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "nano-banana-pro", "prompt": "a calm mountain lake at sunrise, photorealistic", "size": "1:1" }' | grep -o '"url":"[^"]*"' # لینک پس از ۶۰ دقیقه از کار میافتد؛ فوراً دانلود کنید.# curl -o image.png "<url>"یک متن انگلیسی توصیفی میفرستید و یک نشانی تصویر میگیرید. قالب درخواست همان images/generations سازگار با OpenAI است، پس اگر قبلاً با آن کار کردهاید فقط آدرس پایه و کلید عوض میشود. برای فرستادن تصویر به مدل (مثلاً برای توصیف یک عکس) به ورودی تصویر بروید.
پاسخ و دانلود تصویر
پاسخ خودِ فایل تصویر نیست؛ یک نشانی موقت است که باید آن را دانلود کنید:
| فیلد | نوع | توضیح |
|---|---|---|
| data[0].url | string | نشانی تصویر تولیدشده. تنها چیزی است که برای گرفتن فایل لازم دارید، و ۶۰ دقیقه بیشتر معتبر نیست. |
نکته مهم
لینکهای تصاویر پس از ۶۰ دقیقه منقضی میشوند.
آدرس API
POST https://api-ai.hibanacloud.ir/v1/images/generationsپارامترهای درخواست
| پارامتر | الزامی | نوع | پیشفرض | توضیحات |
|---|---|---|---|---|
| prompt | بله | string | - | توضیح تصویر مورد نظر |
| model | بله | string | - | مدل AI مورد استفاده (توصیه: nano-banana-pro) |
| size | خیر | string | 1:1 | نسبت ابعاد تصویر |
مدلهای موجود
nano-banana-pro
نسبت ابعاد (Aspect Ratios)
| گروه | نسبت | ابعاد | کاربرد |
|---|---|---|---|
| مربع (Square) | 1:1 | 1024×1024 | شبکههای اجتماعی |
| عمودی (Portrait) | 2:3 | 832×1248 | پوستر |
| عمودی (Portrait) | 3:4 | 864×1184 | عکاسی |
| عمودی (Portrait) | 4:5 | 896×1152 | اینستاگرام |
| عمودی (Portrait) | 9:16 | 768×1344 | استوری، موبایل |
| افقی (Landscape) | 3:2 | 1248×832 | عکاسی |
| افقی (Landscape) | 4:3 | 1184×864 | پرزنتیشن |
| افقی (Landscape) | 16:9 | 1344×768 | والپیپر، یوتیوب |
| افقی (Landscape) | 21:9 | 1536×672 | سینمایی، بنر |
| استاندارد | 5:4 | 1152×896 | چاپ هنری |
نوشتن Prompt های موثر
دقیق (شما تصمیم میگیرید):
"A photorealistic portrait of a golden retriever puppy sitting in a flower garden at sunset, soft lighting"
مبهم (مدل تصمیم میگیرد):
"dog"
مدلهای تصویر قطعی (deterministic) نیستند؛ اجرای دوبارهٔ همین promptها تصویری مشابه میدهد، نه دقیقاً همین تصویر.
موارد قابل ذکر:
- موضوع (چه/چه کسی)
- محیط (کجا)
- نورپردازی (زمان روز، حال و هوا)
- سبک (واقعگرا، کارتونی، نقاشی رنگ روغن)
- رنگها (گرم، پر رنگ، پاستلی)
prompt را به انگلیسی بنویسید، نمونههای بالا و مدلهای تصویر با آن بهتر کار میکنند. اگر درخواست شما خطا برگرداند، معنی کدها در مدیریت خطاها و علتهای رایج در حل مشکلات آمدهاند.