OpenAI-متوافق مع TTS

استخدم نقطة النهاية هذه عندما يتوقع العميل عقد OpenAI POST /v1/audio/speech. إنه مخصص لعمليات التكامل مثل موفر Tavo Custom OpenAI Protocol TTS.

للحصول على تكامل Fish Audio الأصلي مع عقد الطلب الكامل، استخدم Sync HTTP.

نقطة النهاية

POST /v1/audio/speech
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

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

https://fishaudio.org/v1/audio/speech

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

طلب

{
  "model": "fishaudio-s21pro-flash",
  "input": "Hello from Fish Audio.",
  "voice": "00a1b221-6137-4b73-ad62-b0cbce134167",
  "response_format": "mp3",
  "speed": 1
}

احصل على معرفات صوتية من GET /api/open/v1/voices. لإجراء اختبار اتصال سريع، استخدم صوت النظام العام 00a1b221-6137-4b73-ad62-b0cbce134167. استخدم معرف طراز Fish Audio TTS مدعومًا؛ أسماء نماذج OpenAI مثل tts-1 ليست أسماء مستعارة لنماذج Fish Audio.

يكتشف بعض عملاء الجهات الخارجية الأصوات من خلال قائمة صوتية متوافقة مع OpenAI. يمكنهم الاتصال بـ:

GET /v1/audio/voices
Authorization: Bearer YOUR_API_KEY

استخدم قيمة voices[].id التي تم إرجاعها كقيمة voice في طلب الكلام.

إجابة

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

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

<binary audio data>

يجب على العميل حفظ الاستجابة أو تشغيلها وفقًا لـ Content-Type. الأخطاء هي استجابات JSON وتستخدم نفس سلوك المصادقة والحصة والتوليد كنقطة نهاية المزامنة الأصلية.

مثال curl

curl -X POST "https://fishaudio.org/v1/audio/speech" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fishaudio-s21pro-flash",
    "input": "Hello from Fish Audio.",
    "voice": "00a1b221-6137-4b73-ad62-b0cbce134167",
    "response_format": "mp3",
    "speed": 1
  }' \
  --output speech.mp3

ربط تافو

بالنسبة لمفتاح API، وعنوان URL الأساسي، والنموذج، والصوت، وإعداد ربط الأحرف، اتبع Fish Audio TTS لدليل Tavo المخصص.

أخطاء