ShareAI Platform Docs

تولید گفتار

پاسخ موفقیت‌آمیز به صورت صوت باینری است، نه JSON.

مشاهده به‌صورت Markdown
در این صفحه
POST https://api.shareai.now/api/v1/audio/speech

تولید گفتار

URL پایه
https://api.shareai.now
احراز هویت
کلید API Bearer یا توکن دسترسی OAuth تأیید‌شده
دامنه مورد نیاز
inference or monetization_gateway

پاسخ موفقیت‌آمیز به صورت صوت باینری است، نه JSON. آن را ذخیره کنید با استفاده از curl --output speech.mp3 یا بایت‌های پاسخ را در SDK خود بخوانید. یک صدای مدل پشتیبانی‌شده و فرمت خروجی را انتخاب کنید؛ سرعت بین 0.25 تا 4 محدود شده است. محدودیت ورودی 256 کیلوبایت و محدودیت پاسخ همزمان 2 مگابایت است.

قبل از شروع#

SHAREAI_API_KEY را روی سرور خود تنظیم کنید و جایگزین مدل را با یک مدل فعال فعلی انجام دهید. هرگز کلید API را در کد مرورگر افشا نکنید. مدل، حساب، اعتبار و ارائه‌دهنده باید این عملیات را مجاز کنند. تنظیمات اختیاری زیر به پشتیبانی مدل نیاز دارند؛ محدودیت‌های ایمنی API تضمین نمی‌کنند که هر مدل از هر مقدار پشتیبانی کند.

ارسال یک درخواست#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/speech" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_SPEECH_MODEL",
  "input": "Hello from ShareAI.",
  "response_format": "mp3"
}' --output speech.mp3

فیلدهای درخواست#

فیلدنوعمعنا و محدودیت‌ها
model مورد نیازرشتهشناسه دقیق مدل عمومی فعال. باید این عملیات را اعلام کند و توسط اعتبار شما مجاز باشد.
input مورد نیازرشتهمتن گفتار غیرخالی مورد نیاز، حداکثر 256 کیلوبایت UTF-8. تعرفه‌های کاراکتر بر اساس کاراکترهای یونیکد محاسبه می‌شوند، نه بایت‌های کدگذاری‌شده.
voiceرشتهصدای اختیاری که توسط مدل گفتار انتخاب‌شده پشتیبانی می‌شود، حداکثر 100 کاراکتر.
response_formatرشتهکدگذاری صوتی اختیاری پشتیبانی‌شده مانند mp3. پاسخ موفقیت‌آمیز به صورت باینری است، نه JSON. مسیرهای قیمت‌گذاری بر اساس مدت زمان نیاز به MP3، WAV یا FLAC خودتوصیف دارند.
speedعددسرعت گفتار اختیاری از 0.25 تا 4؛ مدل ممکن است محدودیت‌های باریک‌تری اعمال کند.
providerشیءتنظیمات اختیاری ترجیحات مسیریابی ارائه‌دهنده. از provider.only برای برچسب‌های ارائه‌دهنده پذیرفته‌شده استفاده کنید، نه یک پیشوند در شناسه مدل. محدودیت‌های حساب و اعتبار همچنان اعمال می‌شوند.

خواندن نتیجه#

موفقیت با HTTP 200 و صوت باینری بازمی‌گردد. پاسخ موفقیت‌آمیز به صورت صوت باینری است، نه JSON. آن را ذخیره کنید با استفاده از curl --output speech.mp3 یا بایت‌های پاسخ را در SDK خود بخوانید. یک صدای مدل پشتیبانی‌شده و فرمت خروجی را انتخاب کنید؛ سرعت بین 0.25 تا 4 محدود شده است. محدودیت ورودی 256 کیلوبایت و محدودیت پاسخ همزمان 2 مگابایت است.

واحدهای صورتحساب#

گفتار می‌تواند بر اساس کاراکتر ورودی، توکن گزارش‌شده توسط ارائه‌دهنده یا ثانیه تولیدشده قیمت‌گذاری شود، بسته به مدل. شمارش کاراکترها از کاراکترهای یونیکد استفاده می‌کند. قیمت‌گذاری بر اساس مدت زمان نیاز به نتیجه MP3، WAV یا FLAC خودتوصیف دارد. نتیجه PCM خام نرخ نمونه‌برداری حدس‌زده ندارد. مسیرهای قیمت‌گذاری بر اساس توکن نیاز به رسید استفاده معتبر دارند.

مدل فعال مورد نظر را از Console انتخاب کنید. عملیات اعلام‌شده و قابلیت‌های ورودی/خروجی آن باید با این نقطه پایانی مطابقت داشته باشد؛ یک مدل چت متنی نمی‌تواند جایگزین عملیات دیگری شود. محدودیت‌های اعتبارنامه، ارائه‌دهنده و حساب شما همچنان اعمال می‌شوند.

قیمت‌گذاری و استفاده#

نرخ‌ها به صورت اعتبارهای AI به یورو برای مدل انتخاب‌شده، ارائه‌دهنده، واحدها و انواع منتشر می‌شوند. فقط ابعاد موجود در تعرفه فعال آن شارژ می‌شوند. یک تخمین اعتبارها را قبل از اجرا رزرو می‌کند؛ هزینه‌های نهایی بر اساس استفاده اندازه‌گیری‌شده محاسبه می‌شوند. قیمت‌ها ممکن است به وضوح، فرمت خروجی یا یک باند استفاده بستگی داشته باشند. برای بدهی نهایی ShareAI، Console Usage را بررسی کنید. فیلدهای هزینه بالادستی و بایت‌های رسانه به شمارش توکن‌های اختراعی تبدیل نمی‌شوند.

دسترسی و خطاها#

استفاده کنید inference برای استنتاج هزینه شبکه تأیید‌شده یا monetization_gateway برای افزایش قیمت تأیید‌شده Builder و شرایط صورتحساب پذیرفته‌شده. دسترسی فقط به هویت، مجوز هزینه کردن را نمی‌دهد. اعتبارسنجی، مجوز مدل، اعتبار ناکافی، محدودیت نرخ و شکست‌های اجرا یک ساختار بازگشتی را برمی‌گردانند. error. پس از یک زمان انتظار یا ارسال نامشخص، Usage یا کار ویدیویی را بررسی کنید قبل از ایجاد درخواست دیگری که ممکن است هزینه‌بر باشد.

لینک به واحدهای صورتحساب

مستندات پلتفرم ShareAI
تمام مستندات

جستجو بر اساس عنوان یا محتوا.

درباره این صفحه بپرسید

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

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI