تبدیل گفتار به متن
رونویسی فایل صوتی، سازگار با OpenAI.
POST
scope: ai.stthttps://api.irnoti.com/v1/ai/audio/transcriptionsدرخواست multipart/form-data با فیلد file (mp3، mp4، m4a، mpeg، mpga، wav، webm، ogg، oga، flac؛ حداکثر ۲۵ مگابایت). هزینه بهازای هر مگابایتِ آغازشده است. با response_format=text فقط متن ساده برمیگردد. در پاسخ، هدرهای X-Credits-Charged، X-Credits-Balance و X-Wallet-Rial-Charged مصرف را نشان میدهد و بلوک irnoti همان مقادیر را در بدنه دارد. سقف ۳۰ درخواست در دقیقه.
پارامترها
| نام | محل | نوع | توضیح |
|---|---|---|---|
| file * | بدنه | file | فایل صوتی. |
| model | بدنه | string | کد مدل. |
| language | بدنه | string | کد زبان ISO مثل fa. |
| prompt | بدنه | string | راهنمای متنی (حداکثر ۱۰۰۰ نویسه). |
| response_format | بدنه | string | json (پیشفرض) یا text. |
خطاهای خاص این endpoint
| 401 | unauthorized | کلید API نامعتبر یا منقضی است. |
| 403 | insufficient_scope | کلید API دامنهٔ دسترسی لازم را ندارد. |
| 400 | validation_error | ورودی نامعتبر است (جزئیات در پاسخ). |
| 429 | rate_limited | تعداد درخواست از سقف مجاز بیشتر شد؛ پس از زمان Retry-After دوباره تلاش کنید. |
اجرای زنده (محیط تست)
باز کردن در کنسول کامل ←این endpoint در محیط تست پشتیبانی نمیشود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.