تولید گفتار
پاسخ موفقیتآمیز به صورت صوت باینری است، نه JSON.
در این صفحه
https://api.shareai.now/api/v1/audio/speechتولید گفتار
- URL پایه
https://api.shareai.now- احراز هویت
- کلید API Bearer یا توکن دسترسی OAuth تأییدشده
- دامنه مورد نیاز
inferenceormonetization_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.mp3Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_SPEECH_MODEL',
'input': 'Hello from ShareAI.',
'response_format': 'mp3'}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/speech', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
with open("speech.mp3", "wb") as output:
output.write(response.read())TypeScript
import { writeFile } from "node:fs/promises";
const response = await fetch("https://api.shareai.now/api/v1/audio/speech", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_SPEECH_MODEL",
"input": "Hello from ShareAI.",
"response_format": "mp3"
}),
});
if (!response.ok) throw new Error(await response.text());
await writeFile("speech.mp3", Buffer.from(await response.arrayBuffer()));فیلدهای درخواست#
| فیلد | نوع | معنا و محدودیتها |
|---|---|---|
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 یا کار ویدیویی را بررسی کنید قبل از ایجاد درخواست دیگری که ممکن است هزینهبر باشد.
لینک به واحدهای صورتحساب