الانتقال إلى المحتوى الرئيسي
تعتمد هذه الواجهة على واجهة Model API الرسمية لـ Fish Audio، وتُستخدم لإنشاء نموذج صوت مستنسخ قابل لإعادة الاستخدام على المدى الطويل استنادًا إلى عينة صوتية. العنوان هو POST https://api.acedata.cloud/fish/model.
عند الحاجة إلى استخدام صوت مرجعي مؤقتًا فقط، لا حاجة إلى إنشاء نموذج، ويمكن استخدام الاستنساخ الفوري لمرة واحدة عبر references في واجهة Fish TTS API مباشرةً. لاسترجاع الأصوات الموجودة عبر صفحات، يرجى الرجوع إلى واجهة Fish Model Query API؛ وللاستعلام عن تفاصيل صوت واحد حسب _id، يرجى الرجوع إلى واجهة Fish Model Get API.

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

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

حقول نص الطلب

لمزيد من المعلومات حول نماذج الأصوات، يمكن الرجوع إلى وثائق Fish الرسمية.
سيتم حفظ الصوت الذي تم إنشاؤه علنًا على المدى الطويل، وقد يبحث عنه مستخدمون آخرون ويستخدمونه. لا حاجة إلى تمرير visibility؛ حتى عند تمرير private أو unlist، لن تغيّر الواجهة الحالية نطاق النشر بناءً على ذلك.

مثال: إنشاء صوت مستنسخ عام

ملاحظة: يجب أن يكون voices سلسلة نصية (عنوان URL لصوت واحد)، وليس مصفوفة. سيرفض المصدر تمريره بصيغة ["..."]. يُنصح باستخدام رابط مباشر قابل للتنزيل علنًا ينتهي باللاحقة .mp3 أو .wav.
يعيد الرد الناجح مباشرةً كائن ModelEntity الخاص بمنصة Fish (المثال التالي هو أدنى صوت صالح اختبرناه فعليًا، وقد حُذفت بعض الحقول الطويلة لتسهيل القراءة):
يمكن استخدام _id كقيمة الحقل reference_id في واجهة Fish TTS API اللاحقة، لاستخدام هذا الصوت المستنسخ في تركيب الكلام: سيتم حفظ الصوت الذي أُنشئ بنجاح علنًا، ويمكن الاستعلام عن الأصوات التي أنشأها المستخدم المستدعي الحالي عبر هذه المنصة باستخدام self=true في واجهة Fish Model Query API. لا يقيّد self=true سوى القائمة، ولا يقيّد استخدام مستخدمين آخرين لهذا الصوت.

متطلبات العينات

القيم التجريبية (متوافقة مع المصدر، ويمكن الرجوع إلى وثائق Fish الرسمية):
  • يُوصى بأن تكون المدة 30 ثانية أو أكثر، وتكون النتيجة أفضل خلال 5 دقائق؛ ولا تكون الفائدة الهامشية كبيرة عند تجاوز 10 دقائق.
  • معدل أخذ العينات 16 kHz أو أعلى، ويمكن أن يكون أحادي القناة أو ستيريو.
  • اجعل المحتوى نظيفًا قدر الإمكان: دون موسيقى خلفية أو صدى أو ضوضاء بيئية واضحة؛ ومن المتحدث نفسه.
  • الصيغ الموصى بها هي mp3 / wav.
إذا لم تكن واثقًا من جودة العينة، يمكنك أيضًا تمرير enhance_audio_quality: true للسماح للمصدر بإجراء تحسين جودة الصوت أولًا.

تعليمات الفوترة

إنشاء نموذج استنساخ صوتي (POST /fish/model) مجاني ولا يترتب عليه أي رسوم؛ كما أن واجهات الاستعلام عن الأصوات (Fish Model Query، Fish Model Get) لا تُحتسب عليها رسوم أيضًا. لا تنشأ التكلفة إلا عند استدعاء Fish TTS لاحقًا لتركيب الصوت حسب الاستخدام.

معالجة الأخطاء

  • 400 token_mismatched: معلمات الطلب مفقودة أو غير صالحة (الأكثر شيوعًا أن voices ليس عنوان URL، أو تم تمريره كمصفوفة).
  • 400: عند تعذر تنزيل الصوت المرجعي، أو كان قصيرًا جدًا، أو تعذر التعرف على تنسيقه، يرجى التحقق من عنوان URL للصوت وتنسيق الملف.
  • 401 invalid_token: رمز المصادقة token غير موجود أو غير صالح.
  • 429 too_many_requests: تم تفعيل حد معدل الطلبات للحساب.
  • 500 api_error: خطأ داخلي في الخادم.
مثال على استجابة خطأ:

الخلاصة

لاستدعاء هذه الواجهة، تحتاج فقط إلى إعداد عنوان URL لعينة صوتية يمكن الوصول إليها علنًا، ووضعه في حقل voices للحصول على _id، ثم تمريره إلى reference_id الخاص بـ /fish/tts لإكمال عملية «الاستنساخ ← التركيب» من البداية إلى النهاية. من الأخطاء الشائعة أن voices يجب أن يكون سلسلة نصية، ولا يمكن أن يكون مصفوفة.

إنشاء الأصوات وإعادة استخدامها عبر MCP

استدعِ في Fish MCP: fish_create_model(title="صوتي", voices="https://example.com/authorized-voice.wav")。 voices هو عنوان URL صوتي واحد عبر HTTP(S)؛ ويمكن أيضًا تمرير description وcover_image وtags و texts وenhance_audio_quality وgenerate_sample. ستحفظ هذه الأداة الأصوات العامة لفترة طويلة، وقد يكتشفها مستخدمون آخرون ويستخدمونها؛ لذا يُرجى استخدام المواد الصوتية المصرح بمعالجتها ونشرها فقط. لا تحتوي الأداة على خيار خاص أو غير معلن. يُستخدم _id الذي يتم إرجاعه عند نجاح الإنشاء في reference_id الخاص بـ fish_generate_audio، ويمكن لـ fish_list_models(self=true) الاستعلام عن الأصوات التي حفظتها بنفسك. عند الحاجة إلى صوت مرجعي لمرة واحدة فقط، استخدم references الخاص بـ fish_generate_audio، ولا حاجة لإنشاء صوت طويل الأمد.