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

گفتگو با مدل (Chat Completions)

درخواست چت سازگار با OpenAI، با پاسخ عادی یا جریانی (SSE).

POSThttps://api.irnoti.com/v1/ai/chat/completions
scope: ai.chat

هر SDK سازگار با OpenAI را فقط با تغییر base_url به https://api.irnoti.com/v1/ai و کلید irn_… به‌کار بگیرید. با stream: true پاسخ به‌صورت server-sent events می‌رسد و با data: [DONE] پایان می‌یابد. هزینه از اعتبار هوش مصنوعی کاربر کسر می‌شود و در هدرهای X-Credits-Charged، X-Credits-Balance و X-Wallet-Rial-Charged و بلاک irnoti پاسخ آمده است. تصویر هنوز پشتیبانی نمی‌شود؛ content رشته یا فهرست بخش‌های {type:"text"} است. حداکثر ۲۰۰ پیام و ۴۰۰٬۰۰۰ نویسه؛ سقف ۱۲۰ درخواست در دقیقه.

پارامترها

ناممحلنوعتوضیح
model *بدنهstringکد مدل از GET /ai/models (حداکثر ۶۰ نویسه).
messages *بدنه{role, content}[]پیام‌ها؛ role یکی از system، user، assistant.
max_tokensبدنهintegerسقف توکن خروجی (۱ تا ۲۰۰٬۰۰۰).
temperatureبدنهnumberخلاقیت، ۰ تا ۲.
top_pبدنهnumberنمونه‌گیری هستهٔ احتمال، بیشتر از ۰ و حداکثر ۱.
stopبدنهstring | string[]تا ۴ رشتهٔ توقف.
streamبدنهbooleanپاسخ جریانی SSE.

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

400validation_errorورودی نامعتبر یا متن بیش از حد طولانی.
401unauthorizedکلید API نامعتبر یا بدون دامنهٔ لازم.
402insufficient_creditاعتبار هوش مصنوعی (و در صورت فعال‌بودن، کیف پول) کافی نیست.
429rate_limitedتعداد درخواست از سقف مجاز بیشتر است.

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

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

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

curl -X POST 'https://api.irnoti.com/v1/ai/chat/completions' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "gpt-fast",
  "messages": [
    {
      "role": "system",
      "content": "به فارسی کوتاه پاسخ بده."
    },
    {
      "role": "user",
      "content": "سلام!"
    }
  ],
  "max_tokens": 200
}'
پاسخ نمونه200 OK
{
  "id": "chatcmpl-5521",
  "model": "gpt-fast",
  "usage": {
    "total_tokens": 33,
    "prompt_tokens": 24,
    "completion_tokens": 9
  },
  "irnoti": {
    "credits_balance": "119967",
    "credits_charged": "33",
    "wallet_rial_charged": "0"
  },
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "سلام! چطور کمکتان کنم؟"
      },
      "finish_reason": "stop"
    }
  ],
  "created": 1767000000
}
گفتگو با مدل (Chat Completions) — مستندات API | ایران ناتیفیکیشن