إنشاء الكلام
الاستجابة الناجحة هي صوت ثنائي، وليس JSON.
في هذه الصفحة
https://api.shareai.now/api/v1/audio/speechإنشاء الكلام
- عنوان URL الأساسي
https://api.shareai.now- المصادقة
- مفتاح واجهة برمجة التطبيقات Bearer أو رمز وصول OAuth المعتمد
- النطاق المطلوب
inferenceormonetization_gateway
الاستجابة الناجحة هي صوت ثنائي، وليس JSON. احفظه باستخدام curl --output speech.mp3 أو اقرأ بايتات الاستجابة في SDK الخاص بك. اختر صوت نموذج مدعومًا وصيغة إخراج؛ السرعة محدودة بين 0.25 و 4. الحد الأقصى للإدخال هو 256 KiB وحد الاستجابة المتزامنة هو 2 MiB.
قبل أن تبدأ#
المعنى والحدود.
إرسال طلب#
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. يتم احتساب التعريفات بناءً على أحرف Unicode، وليس البايتات المشفرة. |
voice | معرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك. | صوت اختياري مدعوم من نموذج الكلام المحدد، بحد أقصى 100 حرف. |
response_format | معرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك. | ترميز صوتي اختياري مدعوم مثل mp3. الاستجابة الناجحة هي ثنائية، وليست JSON. المسارات المسعرة حسب المدة تحتاج إلى MP3 أو WAV أو FLAC ذات وصف ذاتي. |
speed | رقم | سرعة الكلام الاختيارية من 0.25 إلى 4؛ قد يفرض النموذج حدودًا أضيق. |
provider | تفضيلات توجيه المزود الاختيارية. استخدم provider.only للعلامات المقبولة للمزود، وليس بادئة في معرف النموذج. لا تزال قيود الحساب والبيانات الاعتمادية سارية. | النجاح يعيد HTTP 200 مع JSON. قدم استعلامًا و1–1000 مستند. كل مستند هو نص،. |
قراءة النتيجة#
النجاح يعيد HTTP 200 مع صوت ثنائي. الاستجابة الناجحة هي صوت ثنائي، وليس JSON. احفظه باستخدام curl --output speech.mp3 أو اقرأ بايتات الاستجابة في SDK الخاص بك. اختر صوت نموذج مدعومًا وصيغة إخراج؛ السرعة محدودة بين 0.25 و 4. الحد الأقصى للإدخال هو 256 KiB وحد الاستجابة المتزامنة هو 2 MiB.
وحدات الفوترة#
يمكن تسعير الكلام حسب عدد الأحرف المدخلة، أو الرموز المبلغ عنها من قبل المزود، أو الثانية المولدة، حسب النموذج. يتم احتساب عدد الأحرف باستخدام أحرف Unicode. تسعير المدة يتطلب نتيجة MP3 أو WAV أو FLAC ذات وصف ذاتي مدعومة. نتيجة PCM الخام ليس لها معدل عينة مُخمن. المسارات المسعرة حسب الرموز تحتاج إلى إيصال استخدام موثوق.
يتم نشر الأسعار بعملة EUR AI credits للنموذج المحدد، المزود، الوحدات والمتغيرات. يتم فرض الرسوم فقط على الأبعاد في التعريفة النشطة. يحتفظ التقدير بالاعتمادات قبل التنفيذ؛ تستخدم الرسوم النهائية الاستخدام المقاس. يمكن أن تعتمد الأسعار على الدقة، تنسيق الإخراج أو نطاق الاستخدام. تحقق من Console Usage للحصول على الخصم النهائي من ShareAI. لا يتم تحويل حقول التكلفة الأولية والوسائط إلى عدد رموز مُخترع.
التسعير والاستخدام#
لتوجيه تكلفة الشبكة المعتمدة أو.
الوصول والأخطاء#
استخدم inference لزيادة معتمدة من Builder وشروط الفوترة المقبولة. الوصول بالهوية فقط لا يصرح بالإنفاق. التحقق، تفويض النموذج، الاعتمادات غير الكافية، حدود المعدل وفشل التنفيذ تعيد هيكلًا monetization_gateway . بعد انتهاء المهلة أو تقديم غير مؤكد، تحقق من الاستخدام أو مهمة الفيديو قبل إنشاء طلب آخر قد يكون مدفوعًا. error. آخر تحديث نوفمبر 3, 2026.
رابط إلى وحدات الفوترة