ShareAI Platform Docs

تولید صوت

نقطه پایانی ShareAI یک نتیجه صوتی JSON محدود را بازمی‌گرداند.

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

تولید صوت

URL پایه
https://api.shareai.now
احراز هویت
کلید API Bearer یا توکن دسترسی OAuth تأیید‌شده
دامنه مورد نیاز
inference or monetization_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
}'

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

فیلدنوعمعنا و محدودیت‌ها
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 یا کار ویدیویی را بررسی کنید قبل از ایجاد درخواست دیگری که ممکن است هزینه‌بر باشد.

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

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

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

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

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

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI