گفتگو با مدل (Chat Completions)
درخواست چت سازگار با OpenAI، با پاسخ عادی یا جریانی (SSE).
POST
scope: ai.chathttps://api.irnoti.com/v1/ai/chat/completionsهر 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
| 400 | validation_error | ورودی نامعتبر یا متن بیش از حد طولانی. |
| 401 | unauthorized | کلید API نامعتبر یا بدون دامنهٔ لازم. |
| 402 | insufficient_credit | اعتبار هوش مصنوعی (و در صورت فعالبودن، کیف پول) کافی نیست. |
| 429 | rate_limited | تعداد درخواست از سقف مجاز بیشتر است. |
اجرای زنده (محیط تست)
باز کردن در کنسول کامل ←این endpoint در محیط تست پشتیبانی نمیشود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.