Skip to main content
هذا الواجهة تعتمد على Fish Audio الرسمية Model API ، وتستخدم للبحث المتعدد الصفحات في مكتبة الأصوات العامة لـ Fish أو الأصوات المستنسخة تحت الحساب الحالي. العنوان هو GET https://api.acedata.cloud/fish/model.
لإنشاء صوت، يرجى الرجوع إلى Fish Model Create API؛ للاستعلام عن تفاصيل صوت واحد حسب _id، يرجى الرجوع إلى Fish Model Get API.

عملية التقديم

لاستخدام Fish Model API، يجب أولاً الذهاب إلى لوحة تحكم Ace Data Cloud للحصول على رمز API الخاص بك، احتفظ به للاستخدام لاحقًا. إذا لم تقم بتسجيل الدخول أو التسجيل بعد، سيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، وبعد الانتهاء، سيتم العودة تلقائيًا إلى الصفحة الحالية. رمز API واحد يكفي لاستدعاء جميع خدمات المنصة، ولا حاجة لتقديم طلب منفصل لكل خدمة. عند التقديم لأول مرة، ستحصل على رصيد مجاني لتجربته مجانًا؛ عند نفاد الرصيد، يمكنك إعادة شحن الرصيد العام في لوحة التحكم.
📘 الوثائق الكاملة: Fish Model API →

معلمات الاستعلام

تسمية المعلمات متطابقة تمامًا مع GET https://api.fish.audio/model، راجع الوثائق الرسمية لـ Fish.

المثال 1: التصفح الافتراضي (حسب page_size)

الرد (تم الاختبار، إجمالي المكتبة العامة حوالي 1.8 مليون؛ تم اختصار بعض الحقول الطويلة في المثال أدناه لسهولة القراءة):

المثال 2: البحث غير الدقيق حسب العنوان (title)

الرد (تم الاختبار):
لاحظ أن title هو “مطابقة غير دقيقة عالمية”، ستصيب جميع الأصوات في مكتبة Fish العامة (ليس فقط الخاصة بك).

المثال 3: عرض الأصوات التي أنشأتها فقط (self=true)

الرد (تم الاختبار، الحساب الحالي يحتوي على صوت واحد فقط):
self=true يعادل تحديد author_id == ID المستخدم العلوي الحالي، وهو مدخل شائع لـ “قائمة الأصوات الخاصة بي”.

المثال 4: تصفية حسب اللغة + العلامة

上游对未在标签字典里的 tag 也会返回结果,但匹配相对宽松;如果命中数为 0,建议改用 title 模糊匹配。

响应字段

items[] 中的每一项是一个完整 ModelEntity 对象,常用字段:

计费说明

本接口不计费——分页查询音色列表是免费操作。创建音色(Fish Model Create)同样免费,费用仅在调用 Fish TTS 合成语音时按用量产生。

错误处理

  • 400 token_mismatched:请求参数缺失或不合法。
  • 401 invalid_token:鉴权 token 不存在或无效。
  • 429 too_many_requests:触发账号速率限制。
  • 500 api_error:服务器内部错误。
错误响应示例:

结论

要从 Fish 公共库挑选音色喂给 /fish/ttsreference_id,先用本接口配合 title / tag / language 检索,定位到目标 _id,再用 Fish Model Get 拿样本试听。要列出自己创建的音色,传 self=true 即可。