تولید صوت
نقطه پایانی ShareAI یک نتیجه صوتی JSON محدود را بازمیگرداند.
در این صفحه
https://api.shareai.now/api/v1/audio/generationsتولید صوت
- URL پایه
https://api.shareai.now- احراز هویت
- کلید API Bearer یا توکن دسترسی OAuth تأییدشده
- دامنه مورد نیاز
inferenceormonetization_gateway
نقطه پایانی ShareAI یک نتیجه صوتی JSON محدود را بازمیگرداند. درخواستهای تولید صوت با modalities:["text","audio"] همچنین میتوانید استفاده کنید /api/v1/chat/completions. درخواست شما به عملیات صوتی اعلامشده هدایت میشود. این پاسخ همزمان قبل از بازگشت جمعآوری میشود؛ جریانهای ناقص ارائهدهنده به نتایج موفقیتآمیز و قابلصورتحساب تبدیل نمیشوند. فرمتهای خروجی صوتی شامل mp3، wav، flac، pcm16 یا pcm24 هستند که به مدل بستگی دارد. PCM خام نمیتواند تعرفه مدتزمان را پشتیبانی کند. یا max_tokens یا max_completion_tokens را برای محدود کردن توکنهای تولیدشده تنظیم کنید؛ هر دو را ارائه ندهید.
قبل از شروع#
SHAREAI_API_KEY را روی سرور خود تنظیم کنید و جایگزین مدل را با یک مدل فعال فعلی انجام دهید. هرگز کلید API را در کد مرورگر افشا نکنید. مدل، حساب، اعتبار و ارائهدهنده باید این عملیات را مجاز کنند. تنظیمات اختیاری زیر به پشتیبانی مدل نیاز دارند؛ محدودیتهای ایمنی API تضمین نمیکنند که هر مدل از هر مقدار پشتیبانی کند.
ارسال یک درخواست#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/generations" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_AUDIO_MODEL",
"messages": [
{
"role": "user",
"content": "A short instrumental melody."
}
],
"modalities": [
"text",
"audio"
],
"audio": {
"format": "mp3"
},
"max_completion_tokens": 1024
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_AUDIO_MODEL',
'messages': [{'role': 'user', 'content': 'A short instrumental melody.'}],
'modalities': ['text', 'audio'],
'audio': {'format': 'mp3'},
'max_completion_tokens': 1024}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/generations', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/audio/generations", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_AUDIO_MODEL",
"messages": [
{
"role": "user",
"content": "A short instrumental melody."
}
],
"modalities": [
"text",
"audio"
],
"audio": {
"format": "mp3"
},
"max_completion_tokens": 1024
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);فیلدهای درخواست#
| فیلد | نوع | معنا و محدودیتها |
|---|---|---|
model مورد نیاز | رشته | شناسه دقیق مدل عمومی فعال. باید این عملیات را اعلام کند و توسط اعتبار شما مجاز باشد. |
messages مورد نیاز | آرایه | 1–256 پیامهای مکالمه با نقش/محتوا. فقط از حالتهای محتوایی که توسط مدل صوتی انتخابشده پشتیبانی میشوند استفاده کنید. |
modalities | آرایه | یک یا دو مقدار منحصر به فرد از متن و صوت؛ صوت الزامی است. به طور پیشفرض به صوت تنظیم میشود. این نقطه پایانی همزمان جریان را نمیپذیرد. |
audio | شیء | گزینههای خروجی اختیاری: فقط صدا و فرمت. فرمت شامل mp3، wav، flac، pcm16 یا pcm24 است که به پشتیبانی مدل بستگی دارد. PCM خام با تعرفههای مدتزمان ناسازگار است. |
temperature | عدد | دمای تولید اختیاری که توسط مدل پشتیبانی میشود. |
top_p | عدد | مقدار نمونهگیری هسته اختیاری که توسط مدل پشتیبانی میشود. |
max_tokens | عدد صحیح | محدودیت توکن خروجی اختیاری، 1–262144. با max_completion_tokens ترکیب نکنید. |
max_completion_tokens | عدد صحیح | محدودیت توکن خروجی اختیاری، 1–262144. با max_tokens ترکیب نکنید. |
provider | شیء | تنظیمات اختیاری ترجیحات مسیریابی ارائهدهنده. از provider.only برای برچسبهای ارائهدهنده پذیرفتهشده استفاده کنید، نه یک پیشوند در شناسه مدل. محدودیتهای حساب و اعتبار همچنان اعمال میشوند. |
خواندن نتیجه#
موفقیت با HTTP 200 و JSON بازمیگردد. نقطه پایانی ShareAI یک نتیجه صوتی JSON محدود را بازمیگرداند. درخواستهای تولید صوت با modalities:["text","audio"] همچنین میتوانید استفاده کنید /api/v1/chat/completions. درخواست شما به عملیات صوتی اعلامشده هدایت میشود. این پاسخ همزمان قبل از بازگشت جمعآوری میشود؛ جریانهای ناقص ارائهدهنده به نتایج موفقیتآمیز و قابلصورتحساب تبدیل نمیشوند. فرمتهای خروجی صوتی شامل mp3، wav، flac، pcm16 یا pcm24 هستند که به مدل بستگی دارد. PCM خام نمیتواند تعرفه مدتزمان را پشتیبانی کند. یا max_tokens یا max_completion_tokens را برای محدود کردن توکنهای تولیدشده تنظیم کنید؛ هر دو را ارائه ندهید.
واحدهای صورتحساب#
مدلهای صوتی میتوانند ابعاد جداگانه توکنهای متن و صوت، مدتزمان، آهنگ یا نرخ درخواست را منتشر کنند. مجموع توکنهای فراگیر به شمارندههای جداگانه متن/صوت تقسیم میشوند؛ همان توکنهای صوتی هرگز دوباره به عنوان متن شارژ نمیشوند. استفادههای پشتیبانینشده یا مفقود از بایتهای کدگذاریشده تخمین زده نمیشوند.
مدل فعال مورد نظر را از Console انتخاب کنید. عملیات اعلامشده و قابلیتهای ورودی/خروجی آن باید با این نقطه پایانی مطابقت داشته باشد؛ یک مدل چت متنی نمیتواند جایگزین عملیات دیگری شود. محدودیتهای اعتبارنامه، ارائهدهنده و حساب شما همچنان اعمال میشوند.
قیمتگذاری و استفاده#
نرخها به صورت اعتبارهای AI به یورو برای مدل انتخابشده، ارائهدهنده، واحدها و انواع منتشر میشوند. فقط ابعاد موجود در تعرفه فعال آن شارژ میشوند. یک تخمین اعتبارها را قبل از اجرا رزرو میکند؛ هزینههای نهایی بر اساس استفاده اندازهگیریشده محاسبه میشوند. قیمتها ممکن است به وضوح، فرمت خروجی یا یک باند استفاده بستگی داشته باشند. برای بدهی نهایی ShareAI، Console Usage را بررسی کنید. فیلدهای هزینه بالادستی و بایتهای رسانه به شمارش توکنهای اختراعی تبدیل نمیشوند.
دسترسی و خطاها#
استفاده کنید inference برای استنتاج هزینه شبکه تأییدشده یا monetization_gateway برای افزایش قیمت تأییدشده Builder و شرایط صورتحساب پذیرفتهشده. دسترسی فقط به هویت، مجوز هزینه کردن را نمیدهد. اعتبارسنجی، مجوز مدل، اعتبار ناکافی، محدودیت نرخ و شکستهای اجرا یک ساختار بازگشتی را برمیگردانند. error. پس از یک زمان انتظار یا ارسال نامشخص، Usage یا کار ویدیویی را بررسی کنید قبل از ایجاد درخواست دیگری که ممکن است هزینهبر باشد.
لینک به واحدهای صورتحساب