إنشاء الصوت
تُرجع نقطة نهاية ShareAI نتيجة صوتية بتنسيق JSON محدد.
في هذه الصفحة
https://api.shareai.now/api/v1/audio/generationsإنشاء الصوت
- عنوان URL الأساسي
https://api.shareai.now- المصادقة
- مفتاح واجهة برمجة التطبيقات Bearer أو رمز وصول OAuth المعتمد
- النطاق المطلوب
inferenceormonetization_gateway
تُعيد نقطة النهاية ShareAI نتيجة صوتية بصيغة JSON محدودة. الطلبات التي تُنتج الصوت مع modalities:["text","audio"] يمكن أيضًا استخدام /api/v1/chat/completions. يتم توجيه طلبك إلى عملية الصوت المُعلنة. يتم جمع هذا الرد المتزامن قبل الإرجاع؛ التدفقات غير المكتملة من المزود لا تُعتبر نتائج مفوترة ناجحة. تنسيقات إخراج الصوت هي mp3، wav، flac، pcm16 أو pcm24، حسب النموذج. لا يمكن للصوت الخام بصيغة PCM دعم تعريفة المدة. قم بتعيين إما max_tokens أو max_completion_tokens لتحديد عدد الرموز المُنتجة؛ لا تُقدم كلاهما.
قبل أن تبدأ#
المعنى والحدود.
إرسال طلب#
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 | تفضيلات توجيه المزود الاختيارية. استخدم provider.only للعلامات المقبولة للمزود، وليس بادئة في معرف النموذج. لا تزال قيود الحساب والبيانات الاعتمادية سارية. | خيارات الإخراج الاختيارية: الصوت والتنسيق فقط. التنسيق هو mp3، wav، flac، pcm16 أو pcm24، حسب دعم النموذج. الصوت الخام بصيغة PCM غير متوافق مع تعريفات المدة. |
temperature | رقم | درجة حرارة التوليد المدعومة من النموذج (اختياري). |
top_p | رقم | قيمة أخذ العينات النووية المدعومة من النموذج (اختياري). |
max_tokens | عدد النتائج الاختياري من 1 إلى عدد المستندات. تشير المؤشرات المرجعة إلى مصفوفة المستندات الأصلية. | حد الرموز الناتجة الاختياري، 1–262144. لا تجمع مع max_completion_tokens. |
max_completion_tokens | عدد النتائج الاختياري من 1 إلى عدد المستندات. تشير المؤشرات المرجعة إلى مصفوفة المستندات الأصلية. | حد الرموز الناتجة الاختياري، 1–262144. لا تجمع مع max_tokens. |
provider | تفضيلات توجيه المزود الاختيارية. استخدم provider.only للعلامات المقبولة للمزود، وليس بادئة في معرف النموذج. لا تزال قيود الحساب والبيانات الاعتمادية سارية. | النجاح يعيد HTTP 200 مع JSON. قدم استعلامًا و1–1000 مستند. كل مستند هو نص،. |
قراءة النتيجة#
النجاح يُعيد 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 credits للنموذج المحدد، المزود، الوحدات والمتغيرات. يتم فرض الرسوم فقط على الأبعاد في التعريفة النشطة. يحتفظ التقدير بالاعتمادات قبل التنفيذ؛ تستخدم الرسوم النهائية الاستخدام المقاس. يمكن أن تعتمد الأسعار على الدقة، تنسيق الإخراج أو نطاق الاستخدام. تحقق من Console Usage للحصول على الخصم النهائي من ShareAI. لا يتم تحويل حقول التكلفة الأولية والوسائط إلى عدد رموز مُخترع.
التسعير والاستخدام#
لتوجيه تكلفة الشبكة المعتمدة أو.
الوصول والأخطاء#
استخدم inference لزيادة معتمدة من Builder وشروط الفوترة المقبولة. الوصول بالهوية فقط لا يصرح بالإنفاق. التحقق، تفويض النموذج، الاعتمادات غير الكافية، حدود المعدل وفشل التنفيذ تعيد هيكلًا monetization_gateway . بعد انتهاء المهلة أو تقديم غير مؤكد، تحقق من الاستخدام أو مهمة الفيديو قبل إنشاء طلب آخر قد يكون مدفوعًا. error. آخر تحديث نوفمبر 3, 2026.
رابط إلى وحدات الفوترة