المطورون / الوكلاء

عرض الأصوات التي يستطيع الوكيل استخدامها

GET https://api.echonova.ai/v1/agent-voices

تعرض أصوات إيكونوڤا النشطة والأصوات المستنسخة لمساحة العمل هذه، وتُقسَّم الصفحات بـ `offset` و`limit`. مرّر المعرّف كـ `voiceId` في `voices` عند إنشاء الوكيل أو تحديثه. يحتاج المفتاح إلى النطاق `agents:read`.

Headers

Authorization string مطلوب

كلمة ⁦Bearer⁩ ثم مسافة ثم مفتاح ⁦API⁩ الذي يبدأ بـ ⁦ek_⁩. أنشئ المفاتيح في البوابة من المطورون، ثم مفاتيح واجهة برمجة التطبيقات.

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

offset integer اختياري

عدد العناصر التي تُتخطّى.

من 0 إلى 10000الافتراضي 0
limit integer اختياري

عدد العناصر التي تُعاد.

من 1 إلى 50الافتراضي 20
dialect string اختياري

الأصوات من هذه اللهجة فقط.

حتى 50 حرفًا
gender string اختياري

الأصوات من هذا الجنس فقط، مثل `female` أو `male`.

حتى 20 حرفًا
q string اختياري

الأصوات التي يحتوي اسمها على هذا النص فقط.

حتى 100 حرفًا

الاستجابة

200 application/json كل استجابة تستخدم هذا الغلاف.

data object

النتيجة.

success boolean

قيمته ⁦true⁩ عند نجاح الطلب.

statusCode integer

يكرر رمز حالة ⁦HTTP⁩.

errorMessage string or null

قيمته ⁦null⁩ عند النجاح.

الأخطاء

الغلاف نفسه، مع ⁦success⁩ بقيمة ⁦false⁩ و ⁦data⁩ بقيمة ⁦null⁩. كل الأخطاء

GET /v1/agent-voices

curl "https://api.echonova.ai/v1/agent-voices" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "items": [
      {
        "id": "6640a1b2c3d4e5f6a7b8c9d0",
        "name": "huda",
        "displayName": {
          "en": "Huda",
          "ar": "هدى"
        },
        "dialect": "emirati",
        "gender": "female",
        "language": "ar",
        "type": "public"
      }
    ],
    "total": 1
  },
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}