تقریر تخلیق کریں
کامیاب جواب بائنری آڈیو ہوتا ہے، JSON نہیں۔.
اس صفحے پر
https://api.shareai.now/api/v1/audio/speechتقریر تخلیق کریں
- بیس URL
https://api.shareai.now- تصدیق
- Bearer API کلید یا منظور شدہ OAuth ایکسیس ٹوکن
- مطلوبہ اسکوپ
inferenceormonetization_gateway
کامیاب جواب بائنری آڈیو ہوتا ہے، JSON نہیں۔ اسے محفوظ کریں curl --output speech.mp3 یا اپنے SDK میں جواب کے بائٹس پڑھیں۔ ایک سپورٹ شدہ ماڈل کی آواز اور آؤٹ پٹ فارمیٹ منتخب کریں؛ رفتار 0.25 سے 4 کے درمیان محدود ہے۔ ان پٹ حد 256 KiB ہے اور ہم وقت ساز جواب کی حد 2 MiB ہے۔.
شروع کرنے سے پہلے#
اپنے سرور پر 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 KiB UTF-8۔ کریکٹر ٹیرف یونیکوڈ کریکٹرز کو گنتے ہیں، انکوڈ شدہ بائٹس کو نہیں۔. |
voice | سٹرنگ | منتخب شدہ تقریری ماڈل کے ذریعے سپورٹ شدہ اختیاری آواز، زیادہ سے زیادہ 100 کریکٹرز۔. |
response_format | سٹرنگ | اختیاری سپورٹ شدہ آڈیو انکوڈنگ جیسے mp3۔ کامیاب جواب بائنری ہوتا ہے، JSON نہیں۔ دورانیہ پر مبنی راستوں کو خود وضاحتی MP3، WAV یا FLAC کی ضرورت ہوتی ہے۔. |
speed | نمبر | اختیاری تقریری رفتار 0.25 سے 4؛ ماڈل تنگ حدود عائد کر سکتا ہے۔. |
provider | آبجیکٹ | اختیاری پرووائیڈر روٹنگ ترجیحات۔ قبول شدہ پرووائیڈر ٹیگز کے لیے provider.only استعمال کریں، ماڈل ID میں کسی پیشوند کے طور پر نہیں۔ اکاؤنٹ اور اسناد کی پابندیاں اب بھی لاگو ہوتی ہیں۔. |
نتیجہ پڑھیں#
کامیابی HTTP 200 کے ساتھ بائنری آڈیو واپس کرتی ہے۔ کامیاب جواب بائنری آڈیو ہوتا ہے، JSON نہیں۔ اسے محفوظ کریں curl --output speech.mp3 یا اپنے SDK میں جواب کے بائٹس پڑھیں۔ ایک سپورٹ شدہ ماڈل کی آواز اور آؤٹ پٹ فارمیٹ منتخب کریں؛ رفتار 0.25 سے 4 کے درمیان محدود ہے۔ ان پٹ حد 256 KiB ہے اور ہم وقت ساز جواب کی حد 2 MiB ہے۔.
بلنگ یونٹس#
تقریر کو ان پٹ کریکٹر، پرووائیڈر کی رپورٹ کردہ ٹوکن یا پیدا شدہ سیکنڈ کے حساب سے قیمت دی جا سکتی ہے، ماڈل پر منحصر ہے۔ کریکٹر گنتی یونیکوڈ کریکٹرز استعمال کرتی ہے۔ دورانیہ کی قیمت کے لیے ایک سپورٹ شدہ خود وضاحتی MP3، WAV یا FLAC نتیجہ درکار ہوتا ہے۔ ایک خام PCM نتیجے میں کوئی اندازہ شدہ سیمپل ریٹ نہیں ہوتا۔ ٹوکن پر مبنی راستوں کو ایک قابل اعتماد استعمال رسید کی ضرورت ہوتی ہے۔.
کنسول سے درست فعال ماڈل شناخت کنندہ منتخب کریں۔ اس کا اعلان کردہ آپریشن اور ان پٹ/آؤٹ پٹ صلاحیتیں اس اینڈپوائنٹ سے مطابقت رکھنی چاہئیں؛ ایک ٹیکسٹ چیٹ ماڈل کو کسی دوسرے آپریشن کے لیے تبدیل نہیں کیا جا سکتا۔ آپ کی اسناد، پرووائیڈر اور اکاؤنٹ کی پابندیاں اب بھی لاگو ہوتی ہیں۔.
قیمتیں اور استعمال#
شرحیں منتخب ماڈل، پرووائیڈر، یونٹس اور ویریئنٹس کے لیے EUR AI کریڈٹس میں شائع کی جاتی ہیں۔ صرف اس کے فعال ٹیرف میں موجود ڈائمینشنز چارج کی جاتی ہیں۔ ایک تخمینہ عمل درآمد سے پہلے کریڈٹس محفوظ کرتا ہے؛ حتمی چارجز ماپی گئی استعمال پر مبنی ہوتے ہیں۔ قیمتیں ریزولوشن، آؤٹ پٹ فارمیٹ یا استعمال کے بینڈ پر منحصر ہو سکتی ہیں۔ حتمی ShareAI ڈیبٹ کے لیے کنسول استعمال چیک کریں۔ اپ اسٹریم لاگت کے فیلڈز اور میڈیا بائٹس کو ایجاد کردہ ٹوکین گنتی میں تبدیل نہیں کیا جاتا۔.
رسائی اور غلطیاں#
استعمال کریں inference منظور شدہ نیٹ ورک-لاگت انفرنس کے لیے یا monetization_gateway منظور شدہ بلڈر مارک اپ اور قبول شدہ بلنگ شرائط کے لیے۔ صرف شناختی رسائی خرچ کی اجازت نہیں دیتی۔ توثیق، ماڈل کی اجازت، ناکافی کریڈٹس، شرح کی حدود اور عمل درآمد کی ناکامیوں کے نتیجے میں ایک ساختہ error. ٹائم آؤٹ یا غیر یقینی جمع کرانے کے بعد، ایک اور ممکنہ طور پر ادا شدہ درخواست بنانے سے پہلے استعمال یا ویڈیو جاب کا معائنہ کریں۔.
آخری بار اپ ڈیٹ کیا گیا نومبر 3, 2026