ShareAI Platform Docs

إنشاء الصوت

تُرجع نقطة نهاية ShareAI نتيجة صوتية بتنسيق JSON محدد.

عرض كـ Markdown
في هذه الصفحة
POST https://api.shareai.now/api/v1/audio/generations

إنشاء الصوت

عنوان URL الأساسي
https://api.shareai.now
المصادقة
مفتاح واجهة برمجة التطبيقات 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 لتحديد عدد الرموز المُنتجة؛ لا تُقدم كلاهما.

قبل أن تبدأ#

المعنى والحدود.

إرسال طلب#

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تفضيلات توجيه المزود الاختيارية. استخدم 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.

رابط إلى وحدات الفوترة

مستندات منصة ShareAI
جميع المستندات

البحث حسب العنوان أو المحتوى.

اسأل عن هذه الصفحة

اختر مساعدًا لاستكشاف هذه الصفحة. يمكنك أيضًا نسخ الصفحة ولصقها في محادثتك.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI