TTS المتوافق مع Fish Audio

استخدم نقطة النهاية هذه عندما يقوم العميل بترميز شكل طلب Fish.audio POST /v1/tts. يقوم بتعيين الحمولة في خط أنابيب Fish Audio Open TTS مع الاحتفاظ بمصادقة مفتاح API والحصة والفواتير في حساب Fish Audio الخاص بك.

للحصول على تكامل Open API الأصلي، تفضل Sync HTTP. بالنسبة لعملاء OpenAI POST /v1/audio/speech، استخدم OpenAI-Compatible TTS.

نقطة النهاية

POST /v1/tts
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
model: s2.1-pro

عنوان URL الكامل:

https://fishaudio.org/v1/tts

إذا طلب تطبيق الجهة الخارجية قاعدة Fish Audio API مثل https://api.fish.audio، فاضبطها على https://fishaudio.org واترك المسار كـ /v1/tts.

احتفظ بمفتاح API في حقل بيانات الاعتماد المحمي الخاص بالعميل. قم بإنشاء مفتاح مخصص لكل تطبيق حتى تتمكن من مراقبته أو إبطاله بشكل مستقل.

طلب

{
  "text": "Hello from Fish Audio.",
  "reference_id": "00a1b221-6137-4b73-ad62-b0cbce134167",
  "format": "mp3",
  "temperature": 0.7,
  "top_p": 0.7,
  "normalize": true,
  "prosody": {
    "speed": 1
  }
}

تعيين رأس النموذج

يتم تجاهل قيم الرأس غير المعروفة ويتم تطبيق المحرك الافتراضي للخادم. يمكنك أيضًا إرسال معرف المحرك الأصلي مثل fishaudio-s21pro-flash في الرأس.

احصل على معرفات صوتية من GET /api/open/v1/voices. لإجراء اختبار اتصال سريع، استخدم صوت النظام العام 00a1b221-6137-4b73-ad62-b0cbce134167.

إجابة

يقوم الطلب الناجح بإرجاع الصوت الثنائي:

HTTP/1.1 200 OK
Content-Type: audio/mpeg
X-OpenAPI-Quota-Remaining: 987988
X-OpenAPI-Credits-Used: 12

<binary audio data>

الأخطاء هي JSON وتتعلق بمصادقة المشاركة والحصة وسلوك الإنشاء مع Sync HTTP.

مثال curl

curl -X POST "https://fishaudio.org/v1/tts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "model: s2.1-pro" \
  -d '{
    "text": "Hello from Fish Audio.",
    "reference_id": "00a1b221-6137-4b73-ad62-b0cbce134167",
    "format": "mp3",
    "prosody": { "speed": 1 }
  }' \
  --output speech.mp3

قم بتوصيل RikkaHub

بالنسبة لمفتاح API وعنوان URL الأساسي والطراز وإعداد الصوت في RikkaHub، اتبع [دليل إعداد RikkaHub] المخصص (/ar/docs/integration-guides/third-party/rikkahub).

أخطاء