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

پایش محتوا (Moderation)

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

POSThttps://api.irnoti.com/v1/ai/moderations
scope: ai.moderate

input رشته یا آرایه‌ای تا ۳۲ رشته. نتیجه عیناً از مدل می‌آید. هزینه به‌ازای هر درخواست است. در پاسخ، هدرهای X-Credits-Charged، X-Credits-Balance و X-Wallet-Rial-Charged مصرف را نشان می‌دهد و بلوک irnoti همان مقادیر را در بدنه دارد. سقف ۱۲۰ درخواست در دقیقه.

پارامترها

ناممحلنوعتوضیح
input *بدنهstring | string[]متن(ها).
modelبدنهstringکد مدل.

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

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

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

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

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

curl -X POST 'https://api.irnoti.com/v1/ai/moderations' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "input": "متن نمونه"
}'
پاسخ نمونه200 OK
{
  "id": "modr-77",
  "model": "mod-1",
  "irnoti": {
    "credits_balance": "998",
    "credits_charged": "1",
    "wallet_rial_charged": "0"
  },
  "results": [
    {
      "flagged": false,
      "categories": {},
      "category_scores": {}
    }
  ]
}
پایش محتوا (Moderation) — مستندات API | ایران ناتیفیکیشن