قم بإدراج الأصوات العامة والشخصية المتاحة لمفتاح API الحالي.

قائمة الأصوات

GET /api/open/v1/voices

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

https://fishaudio.org/api/open/v1/voices

الرؤوس

Authorization: Bearer FISHAUDIO_API_KEY

قائمة الأصوات للقراءة فقط. لا يقوم بإنشاء المهام أو استهلاك الاعتمادات.

خيارات الاستعلام

تقرأ نقطة النهاية عوامل التصفية الاختيارية من معلمات استعلام URL. إذا قمت بحذفها، تقوم API بإرجاع الصفحة الأولى من الأصوات العامة.

المجال	اكتب	مطلوب	الوصف
`page`	عدد صحيح	لا	رقم الصفحة. الافتراضي: `1`
`pageSize`	عدد صحيح	لا	العناصر لكل صفحة. الافتراضي: `20`، الحد الأقصى: `100`
`modelType`	سلسلة	لا	`public` أو `personal` أو `all`
`includePersonal`	منطقية	لا	عند `true`، يصبح نوع النموذج الافتراضي `all`

إجابة

{
  "total": 1,
  "page": 1,
  "pageSize": 20,
  "totalPages": 1,
  "items": [
    {
      "voiceId": "voice_123",
      "title": "Clara",
      "description": "",
      "created_at": "2026-07-09T00:00:00.000Z",
      "updated_at": "2026-07-09T00:00:00.000Z",
      "isPersonal": false
    }
  ]
}

استخدم items[].voiceId في طلبات TTS.

اختبار سريع للصوت

لاختبار TTS قبل اختيار صوت من الاستجابة، استخدم هذا المعرف الصوتي للنظام العام:

00a1b221-6137-4b73-ad62-b0cbce134167

استبدلها بقيمة items[].voiceId عندما تكون مستعدًا لتحديد صوت الإنتاج.

مثال curl

curl "https://fishaudio.org/api/open/v1/voices?page=1&pageSize=20&modelType=public" \
  -H "Authorization: Bearer FISHAUDIO_API_KEY"

أخطاء

الحالة	معنى
`401`	مفتاح API مفقود أو غير صالح
`403`	لا يمكن للحساب إدراج الأصوات
`500`	فشل الاستعلام عن الكتالوج الصوتي

قائمة الأصوات

قائمة الأصوات

الرؤوس

خيارات الاستعلام

إجابة

اختبار سريع للصوت

مثال curl

أخطاء

في هذه الصفحة