راهنمای اتصال به API

تحلیل صدا با API؛ خلاصه و پاسخ فارسی از روی فایل صوتی

گاهی متن کامل یک صدا را نمی‌خواهید، فقط می‌خواهید بدانید در آن چه گذشته است: خلاصه‌ی جلسه، موضوع تماس با پشتیبانی، یا پاسخ یک پرسش مشخص. مدل‌های Qwen 3.8 Omni Flash و MiMo v2.6 Flash در وان ای آی (1ai) ورودی صوتی می‌گیرند و از همان مسیر POST /v1/chat/completions صدا زده می‌شوند. در آزمون ما هر دو مدل صدای فارسی یک گفتگوی دونفره را فهمیدند، تعداد گوینده‌ها را درست گفتند و خلاصه‌ی فارسی نوشتند. اگر متن کلمه‌به‌کلمه لازم دارید، API تبدیل گفتار به متن مناسب‌تر است.

چرا با 1ai

خود صدا را می‌شنود

نیازی به تبدیل صدا به متن نیست؛ فایل مستقیم به مدل می‌رسد و لحن و تعداد گوینده‌ها هم در پاسخ اثر دارد.

پاسخ فارسی

پرسش را فارسی بنویسید تا خلاصه و پاسخ هم فارسی باشد. صدای فارسی را هم می‌فهمد.

مسیر آشنای چت

همان مسیر چت و همان SDK؛ فقط یک بخش input_audio به پیام اضافه می‌شود.

کم‌هزینه برای حجم بالا

این دو مدل از نسخه‌های کم‌هزینه‌اند و برای بررسی تعداد زیادی فایل مناسب‌اند.

در چند قدم

  1. ۱

    فایل را آماده کنید

    فایل را به base64 تبدیل کنید. کل بدنه‌ی درخواست باید زیر ۲۵ مگابایت بماند.

  2. ۲

    پرسش را بنویسید

    دقیق بگویید چه می‌خواهید: خلاصه، فهرست کارها یا پاسخ یک پرسش مشخص.

  3. ۳

    پیام را بفرستید

    متن پرسش و فایل صوتی را دو بخش از یک پیام بگذارید.

  4. ۴

    نتیجه را بازبینی کنید

    برای کار حساس، نتیجه را با خود صدا مقایسه کنید.

مدل‌های پیشنهادی برای تحلیل صدا

همه‌ی مدل‌ها
گفتگو

صدا، تصویر و فیلم را می‌فهمد و کم‌هزینه است

با اشتراک
API

MiMo v2.6 Flash

شیائومی
گفتگو

سریع و کم‌هزینه با ورودی صدا و تصویر

با اشتراک
API

نمونه درخواست با Python

python
import base64
from openai import OpenAI

client = OpenAI(base_url="https://1ai.ir/v1", api_key="sk-1ai-...")
audio = base64.b64encode(open("meeting.mp3", "rb").read()).decode()

reply = client.chat.completions.create(
    model="qwen/qwen3.8-omni-flash",
    max_tokens=1500,
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "این صدای یک جلسه است. چند نفر صحبت می‌کنند؟ در سه جمله خلاصه کن."},
            {"type": "input_audio", "input_audio": {"data": audio, "format": "mp3"}},
        ],
    }],
)
print(reply.choices[0].message.content)

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

نیازراه مناسب
خلاصه، موضوع، پاسخ به یک پرسشتحلیل صدا در همین صفحه
متن کامل و کلمه‌به‌کلمهتبدیل گفتار به متن
متن جلسه با نام گویندهمدل جداسازی گوینده

اگر فایل طولانی است و پرسش‌های زیادی دارید، اول متن را بگیرید و بعد آن متن را به یک مدل چت بدهید؛ معمولاً کم‌هزینه‌تر است.

چند کاربرد رایج

  • پشتیبانی: موضوع تماس و رضایت مشتری را از روی صدا بنویسد.
  • جلسه: تصمیم‌ها و کارهای هر نفر را فهرست کند.
  • پیام صوتی: خلاصه‌ی یک خطی پیام‌های دریافتی را بسازد.
  • محتوا: عنوان و خلاصه برای پادکست پیشنهاد دهد.

پیش از پردازش صدای دیگران، رضایت آن‌ها و قانون‌های حریم خصوصی را در نظر بگیرید.

سوالات متداول

صدای فارسی را می‌فهمد؟

بله. در آزمون ما روی یک گفتگوی فارسی دونفره، هر دو مدل گوینده‌ها را درست شمردند و خلاصه‌ی درست نوشتند. این یک نمونه است؛ با صدای پرنویز یا لهجه‌ی خاص خودتان هم امتحان کنید.

چه قالب صوتی را می‌پذیرد؟

نمونه‌های ما MP3 بوده‌اند و قالب فایل را در فیلد format می‌نویسید. بدنه‌ی هر درخواست حداکثر ۲۵ مگابایت است و base64 حجم را حدود یک‌سوم بیشتر می‌کند.

هزینه چطور حساب می‌شود؟

به ازای توکن، مثل بقیه‌ی پیام‌های چت؛ صدا هم به توکن ورودی تبدیل می‌شود. قیمت‌ها در جدول مدل‌ها است و هزینه‌ی هر درخواست در هدر x-1ai-credits برمی‌گردد.

این مدل‌ها در چت 1ai هم هستند؟

این مدل‌ها فعلاً فقط از API در دسترس‌اند.

مطالب مرتبط

استفاده از API سازگار با OpenAI در 1ai: راهنمای عملی با Python، Node.js و cURL
توسعه‌دهندگان

استفاده از API سازگار با OpenAI در 1ai: راهنمای عملی با Python، Node.js و cURL

چطور پروژه‌ای را که با کتابخانه‌ی OpenAI نوشته شده، فقط با تغییر آدرس پایه و کلید به 1ai وصل کنید؛ با نمونه کد Python، Node.js و cURL، استریم، فهرست مدل‌ها و مدیریت خطا.

۴ دقیقه مطالعه
کلید API در 1ai: امنیت، محدودیت‌ها و کنترل هزینه
توسعه‌دهندگان

کلید API در 1ai: امنیت، محدودیت‌ها و کنترل هزینه

چطور کلیدهای API را امن نگه دارید و هزینه را مهار کنید: مدل‌های مجاز، سقف اعتبار ماهانه، محدودیت نرخ، تاریخ انقضا، کلیدهای تیمی و گزارش مصرف.

۴ دقیقه مطالعه
همه‌ی امکانات

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

فایل صوتی را بفرستید و متن فارسی بگیرید. با مدل جداسازی گوینده هر بخش از متن زمان و گوینده‌ی خودش را دارد، برای صورت‌جلسه و مصاحبه.

API ارزان هوش مصنوعی

برای طبقه‌بندی، خلاصه‌سازی و کارهای پرحجم به مدل گران نیاز ندارید. مدل‌های این صفحه کم‌هزینه و سریع‌اند و با همان SDK کار می‌کنند.

OpenAI SDK

کتابخانه‌ی رسمی openai را در Python و Node.js با تغییر آدرس پایه به 1ai وصل کنید و چت، فراخوانی ابزار، بردار متن، تصویر و صدا را از یک کلید بگیرید.

تحلیل صدا با API؛ خلاصه و پاسخ فارسی از روی فایل صوتی

فایل صوتی را همراه پرسش به مسیر چت بفرستید. مدل خود صدا را می‌شنود و به فارسی خلاصه می‌کند، به پرسش جواب می‌دهد یا نکته‌ها را بیرون می‌کشد.

ساخت کلید API