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

تبدیل گفتار به متن

رونویسی فایل صوتی، سازگار با OpenAI.

POSThttps://api.irnoti.com/v1/ai/audio/transcriptions
scope: ai.stt

درخواست 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بدنهstringjson (پیش‌فرض) یا text.

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

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

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

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

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

curl -X POST 'https://api.irnoti.com/v1/ai/audio/transcriptions' \
  -H "Authorization: Bearer $IRNOTI_KEY"
پاسخ نمونه200 OK
{
  "text": "سلام، این یک آزمایش است.",
  "irnoti": {
    "model": "stt-1",
    "credits_balance": "996",
    "credits_charged": "2",
    "wallet_rial_charged": "0"
  },
  "duration": 4.2,
  "language": "fa"
}
تبدیل گفتار به متن — مستندات API | ایران ناتیفیکیشن