ایران ناتیفیکیشن

ساخت تصویر

ساخت تصویر از متن، سازگار با OpenAI.

POSThttps://api.irnoti.com/v1/ai/images/generations
scope: ai.image

تصویرها همیشه به‌صورت base64 در data[].b64_json برمی‌گردند (نه لینک). تا ۴ تصویر در هر درخواست. اندازه‌های مجاز: 256x256، 512x512، 1024x1024، 1024x1536، 1536x1024، 1024x1792، 1792x1024؛ اگر مدل اندازه را نپذیرد خطا می‌گیرید. هزینه به اعتبار هوش مصنوعی و به‌ازای هر تصویر است. در پاسخ، هدرهای X-Credits-Charged، X-Credits-Balance و X-Wallet-Rial-Charged مصرف را نشان می‌دهد و بلوک irnoti همان مقادیر را در بدنه دارد. سقف ۳۰ درخواست در دقیقه.

پارامترها

ناممحلنوعتوضیح
prompt *بدنهstringتوضیح تصویر (حداکثر ۴۰۰۰ نویسه).
modelبدنهstringکد مدل (فقط اگر گروه شما اجازهٔ انتخاب دارد).
nبدنهintegerتعداد تصویر (۱ تا ۴، پیش‌فرض ۱).
sizeبدنهstringاندازه؛ پیش‌فرض 1024x1024.

خطاهای خاص این endpoint

401unauthorizedکلید API نامعتبر یا منقضی است.
403insufficient_scopeکلید API دامنهٔ دسترسی لازم را ندارد.
400validation_errorورودی نامعتبر است (جزئیات در پاسخ).
402insufficient_creditاعتبار هوش مصنوعی کافی نیست.
429rate_limitedتعداد درخواست از سقف مجاز بیشتر شد؛ پس از زمان Retry-After دوباره تلاش کنید.

اجرای زنده (محیط تست)

باز کردن در کنسول کامل ←

این endpoint در محیط تست پشتیبانی نمی‌شود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.

curl -X POST 'https://api.irnoti.com/v1/ai/images/generations' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "n": 1,
  "size": "1024x1024",
  "prompt": "گربه‌ای فضانورد روی ماه"
}'
پاسخ نمونه200 OK
{
  "data": [
    {
      "b64_json": "iVBORw0KGgo…"
    }
  ],
  "irnoti": {
    "model": "img-1",
    "credits_balance": "960",
    "credits_charged": "40",
    "wallet_rial_charged": "0"
  },
  "created": 1790000000
}
ساخت تصویر — مستندات API | ایران ناتیفیکیشن