Fish Model Get API توضيح الواجهة

هذه الواجهة تعتمد على واجهة Model API الرسمية من Fish Audio ، وتستخدم للاستعلام عن تفاصيل كاملة لنغمة استنساخ واحدة حسب _id. العنوان هو GET https://api.acedata.cloud/fish/model/{id}.

لإنشاء نغمة، يرجى الرجوع إلى واجهة Fish Model Create API؛ وللاستعلام عن الصفحات، يرجى الرجوع إلى واجهة Fish Model Query API.

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

لاستخدام واجهة Fish Model API، يجب أولاً الذهاب إلى وحدة التحكم في Ace Data Cloud للحصول على رمز API الخاص بك، احتفظ به للاستخدام لاحقًا.

إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل بعد، سيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، وبعد الانتهاء، سيتم العودة تلقائيًا إلى الصفحة الحالية. يمكن استخدام رمز API واحد لاستدعاء جميع خدمات المنصة، ولا حاجة لتقديم طلب منفصل لكل خدمة. عند التقديم لأول مرة، ستحصل على رصيد مجاني لتجربته؛ وعند نفاد الرصيد، يمكنك إعادة شحن الرصيد العام في وحدة التحكم.

📘 الوثائق الكاملة: Fish Model API →

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

المعلمة	إلزامية	الشرح
`id`	نعم	`_id` للنغمة (سلسلة سداسية عشرية مكونة من 32 حرفًا). يمكن الحصول عليه عند إنشاء Fish Model Create أو من خلال Fish Model Query.

لا يوجد جسم طلب، ولا معلمات استعلام.

مثال: سحب تفاصيل كاملة لنغمة إسبانية عامة

curl 'https://api.acedata.cloud/fish/model/8d2c17a9b26d4d83888ea67a1ee565b2' \
  -H 'authorization: Bearer {token}'

الرد (تمت التجربة، وتم حذف سلسلة الاستعلام الموقعة من samples[].audio لتسهيل القراءة):

{
  "_id": "8d2c17a9b26d4d83888ea67a1ee565b2",
  "type": "tts",
  "title": "Valentino Narración Biblica Fer",
  "description": "صوت ذكر ناضج وموثوق به بنغمة هادئة وروحية. إنه مناسب تمامًا للروايات الدينية، والمحتوى التعليمي، وسرد القصص الاحترافية باللغة الإسبانية.",
  "cover_image": "coverimage/8d2c17a9b26d4d83888ea67a1ee565b2",
  "train_mode": "fast",
  "state": "trained",
  "tags": [
    "ذكر", "قديم", "رواية", "هادئ", "جاد",
    "موثوق", "احترافي", "واضح", "إسباني"
  ],
  "samples": [
    {
      "title": "العينة الافتراضية",
      "text": "إخواني، دعونا نتذكر كلمات الرب في هذه الأوقات الصعبة. كما تقول الكتابات، الإيمان ينقل الجبال، ومحبة الله توجهنا في كل خطوة على الطريق. دعونا نتمسك بثقتنا في عنايته الإلهية.",
      "task_id": "59ce7df6935c42249759327ddf70f37b",
      "audio": "https://c97f3361a1c971323738e24f451a0225.r2.cloudflarestorage.com/fish-platform-data/task/59ce7df6935c42249759327ddf70f37b.mp3?X-Amz-...signed..."
    }
  ],
  "created_at": "2025-03-13T08:11:10.326000Z",
  "updated_at": "2026-05-03T09:01:41.437000Z",
  "languages": ["es"],
  "visibility": "public",
  "lock_visibility": false,
  "dmca_taken_down": false,
  "default_text": "إخواني، دعونا نتذكر كلمات الرب...",
  "quality": null,
  "like_count": 4344,
  "mark_count": 4409,
  "shared_count": 590,
  "task_count": 708461,
  "unliked": false,
  "liked": false,
  "marked": false,
  "author": {
    "_id": "1b82fb6a329c4462b67aa9ee0a42046f",
    "nickname": "Fernando Caicedo",
    "avatar": "avatars/1b82fb6a329c4462b67aa9ee0a42046f.jpg"
  }
}

يمكنك استخدام _id الذي حصلت عليه مباشرة في reference_id لـ Fish TTS لتوليد صوت بنفس النغمة:

curl -X POST 'https://api.acedata.cloud/fish/tts' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "text": "إخواني، اليوم هو يوم جيد.",
    "reference_id": "8d2c17a9b26d4d83888ea67a1ee565b2",
    "format": "mp3"
  }'

الاختلافات مع واجهة القائمة

الحقل	`GET /fish/model` (قائمة)	`GET /fish/model/{id}` (تفاصيل)
`samples[].audio`	رابط R2 مؤقت	رابط مباشر موقّع من R2 (بما في ذلك توقيع الاستعلام)
`unliked` / `liked` / `marked` / `dmca_taken_down`	موجودة أيضًا	موجودة أيضًا
`default_text` / `lock_visibility`	موجودة أيضًا	موجودة أيضًا

إذا كنت ترغب فقط في الاستماع، فإن samples[].audio في واجهة القائمة كافية؛ للحصول على رابط تنزيل أكثر استقرارًا، يُنصح باستخدام هذه الواجهة.

حقول الاستجابة (مقتطفات)

الحقل	النوع	الشرح
`_id`	string	معرف النغمة (يستخدم في `reference_id` لـ `/fish/tts`).
`type`	string	نوع النموذج، عادةً ما يكون `tts`.
`title`	string	اسم النغمة.
`description`	string	وصف طويل.
`state`	string	حالة التدريب: `trained` تعني متاحة، `training` تعني لا تزال قيد التدريب.
`tags`	string[]	علامات المكتبة العامة.
`samples`	object[]	عينات مسبقة، تحتوي على `title`، `text`، `task_id`، `audio` رابط مباشر.
`languages`	string[]	رموز اللغات التي تتقنها النغمة.
`visibility`	string	`public` أو `private`.
`like_count`	integer	عدد الإعجابات في المكتبة العامة.
`task_count`	integer	عدد مرات التوليد التاريخية (يمكن استخدامها كمرجع لترتيب الشعبية).
`author`	object	معلومات المؤلف: `_id` / `nickname` / `avatar`.
`created_at`	string	وقت الإنشاء بصيغة ISO 8601.
`updated_at`	string	آخر وقت تحديث بصيغة ISO 8601.

توضيح الفوترة

هذه الواجهة لا تتطلب رسوم - الاستعلام عن تفاصيل نغمة واحدة حسب ID هو عملية مجانية. إنشاء نغمة (Fish Model Create) أيضًا مجاني، وتُفرض الرسوم فقط عند استدعاء Fish TTS لتوليد الصوت حسب الاستخدام.

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

400 token_mismatched：المعرف في المسار ليس بتنسيق قانوني، أو تم الإبلاغ من قبل المصدر “النموذج غير موجود”.
401 invalid_token：رمز المصادقة غير موجود أو غير صالح.
404 not_found：المعرف المحدد _id غير مرئي في Fish (تم حذف الصوت، أو خاص، أو ينتمي إلى حساب آخر).
429 too_many_requests：تم تفعيل حد معدل الحساب.
500 api_error：خطأ داخلي في الخادم.

عند الطلب فعليًا لمعرف غير موجود، سيقوم المصدر بإرجاع 400 Model not found مباشرةً (تم الاختبار):

curl 'https://api.acedata.cloud/fish/model/test123' \
  -H 'authorization: Bearer {token}'

الإرجاع:

{ "status": 400, "message": "Model not found" }

مثال على استجابة الخطأ:

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

الاستنتاج

عند معرفة الصوت _id، استخدم هذا الواجهة للحصول على ModelEntity كاملة، وأشهر الاستخدامات هي: (1) الاستماع إلى samples[].audio، (2) إطعام _id إلى reference_id في /fish/tts لإكمال التركيب. إذا كان لديك فقط عنوان أو علامات، يرجى استخدام استعلام نموذج Fish للبحث.

البداية

دردشة الذكاء الاصطناعي

صورة الذكاء الاصطناعي

فيديو الذكاء الاصطناعي

الصوت الذكي

الويب والبيانات

CAPTCHA

الهوية

وكيل

متقدم

Coding

Fish Model Get API توضيح الواجهة

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

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

مثال: سحب تفاصيل كاملة لنغمة إسبانية عامة

الاختلافات مع واجهة القائمة

حقول الاستجابة (مقتطفات)

توضيح الفوترة

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

الاستنتاج

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

​معلمات المسار

​مثال: سحب تفاصيل كاملة لنغمة إسبانية عامة

​الاختلافات مع واجهة القائمة

​حقول الاستجابة (مقتطفات)

​توضيح الفوترة

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

​الاستنتاج

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

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

مثال: سحب تفاصيل كاملة لنغمة إسبانية عامة

الاختلافات مع واجهة القائمة

حقول الاستجابة (مقتطفات)

توضيح الفوترة

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

الاستنتاج