آڈیو تخلیق کریں
ShareAI اینڈ پوائنٹ ایک محدود JSON آڈیو نتیجہ واپس کرتا ہے۔.
اس صفحے پر
https://api.shareai.now/api/v1/audio/generationsآڈیو تخلیق کریں
- بیس URL
https://api.shareai.now- تصدیق
- Bearer API کلید یا منظور شدہ 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 استعمال کریں، ماڈل ID میں کسی پیشوند کے طور پر نہیں۔ اکاؤنٹ اور اسناد کی پابندیاں اب بھی لاگو ہوتی ہیں۔. |
نتیجہ پڑھیں#
کامیابی HTTP 200 کے ساتھ JSON واپس کرتی ہے۔ ShareAI کا اینڈپوائنٹ ایک محدود JSON آڈیو نتیجہ واپس کرتا ہے۔ آڈیو پیدا کرنے والی درخواستیں modalities:["text","audio"] بھی استعمال کر سکتے ہیں /api/v1/chat/completions. ۔ آپ کی درخواست کو اعلان کردہ آڈیو آپریشن کی طرف بھیجا جاتا ہے۔ یہ ہم وقت ساز جواب واپسی سے پہلے جمع کیا جاتا ہے؛ نامکمل پرووائیڈر اسٹریمز کامیاب بل شدہ نتائج نہیں بنتے۔ آڈیو آؤٹ پٹ فارمیٹس mp3، wav، flac، pcm16 یا pcm24 ہیں، جو ماڈل پر منحصر ہیں۔ خام PCM دورانیہ ٹیرف کی حمایت نہیں کر سکتا۔ پیدا شدہ ٹوکنز کو محدود کرنے کے لیے یا تو max_tokens یا max_completion_tokens سیٹ کریں؛ دونوں فراہم نہ کریں۔.
بلنگ یونٹس#
آڈیو ماڈلز علیحدہ ٹیکسٹ ٹوکن اور آڈیو ٹوکن کے ابعاد، دورانیہ، گانے یا درخواست کی شرحیں شائع کر سکتے ہیں۔ شامل ٹوکن کے کل کو غیر مشترکہ ٹیکسٹ/آڈیو کاؤنٹرز میں تقسیم کیا جاتا ہے؛ وہی آڈیو ٹوکن کبھی بھی دوبارہ ٹیکسٹ کے طور پر چارج نہیں کیے جاتے۔ غیر سپورٹ شدہ یا غائب استعمال کو انکوڈ شدہ بائٹس سے اندازہ نہیں لگایا جاتا۔.
کنسول سے درست فعال ماڈل شناخت کنندہ منتخب کریں۔ اس کا اعلان کردہ آپریشن اور ان پٹ/آؤٹ پٹ صلاحیتیں اس اینڈپوائنٹ سے مطابقت رکھنی چاہئیں؛ ایک ٹیکسٹ چیٹ ماڈل کو کسی دوسرے آپریشن کے لیے تبدیل نہیں کیا جا سکتا۔ آپ کی اسناد، پرووائیڈر اور اکاؤنٹ کی پابندیاں اب بھی لاگو ہوتی ہیں۔.
قیمتیں اور استعمال#
شرحیں منتخب ماڈل، پرووائیڈر، یونٹس اور ویریئنٹس کے لیے EUR AI کریڈٹس میں شائع کی جاتی ہیں۔ صرف اس کے فعال ٹیرف میں موجود ڈائمینشنز چارج کی جاتی ہیں۔ ایک تخمینہ عمل درآمد سے پہلے کریڈٹس محفوظ کرتا ہے؛ حتمی چارجز ماپی گئی استعمال پر مبنی ہوتے ہیں۔ قیمتیں ریزولوشن، آؤٹ پٹ فارمیٹ یا استعمال کے بینڈ پر منحصر ہو سکتی ہیں۔ حتمی ShareAI ڈیبٹ کے لیے کنسول استعمال چیک کریں۔ اپ اسٹریم لاگت کے فیلڈز اور میڈیا بائٹس کو ایجاد کردہ ٹوکین گنتی میں تبدیل نہیں کیا جاتا۔.
رسائی اور غلطیاں#
استعمال کریں inference منظور شدہ نیٹ ورک-لاگت انفرنس کے لیے یا monetization_gateway منظور شدہ بلڈر مارک اپ اور قبول شدہ بلنگ شرائط کے لیے۔ صرف شناختی رسائی خرچ کی اجازت نہیں دیتی۔ توثیق، ماڈل کی اجازت، ناکافی کریڈٹس، شرح کی حدود اور عمل درآمد کی ناکامیوں کے نتیجے میں ایک ساختہ error. ٹائم آؤٹ یا غیر یقینی جمع کرانے کے بعد، ایک اور ممکنہ طور پر ادا شدہ درخواست بنانے سے پہلے استعمال یا ویڈیو جاب کا معائنہ کریں۔.
آخری بار اپ ڈیٹ کیا گیا نومبر 3, 2026