المطورون / تنقية الصوت

عرض مهام تنقية الصوت

GET https://api.echonova.ai/v1/sound-cleaning/jobs

تعرض مهام API في مساحة عمل هذا المفتاح، مقسّمة إلى صفحات باستخدام `offset` و`limit`. يحتاج المفتاح إلى وصول إلى تنقية الصوت.

Headers

Authorization string مطلوب

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

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

offset integer اختياري

عدد المهام التي تُتخطّى.

0 أو أكثرالافتراضي 0
limit integer اختياري

عدد المهام التي تُعاد.

من 1 إلى 100الافتراضي 20

الاستجابة

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

data object

النتيجة.

success boolean

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

statusCode integer

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

errorMessage string or null

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

الأخطاء

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

GET /v1/sound-cleaning/jobs

curl "https://api.echonova.ai/v1/sound-cleaning/jobs" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "items": [
      {
        "id": "66e3f2a1c9d4b8a1f0e12345",
        "status": "completed",
        "fileName": "noisy.wav",
        "outputUrl": "https://storage.example.com/cleaned/66e3f2a1c9d4b8a1f0e12345.wav?signature=abc",
        "durationSeconds": 12,
        "creditsConsumed": 207,
        "options": {
          "cutoffFreq": 90,
          "qFactor": 0.707,
          "targetLufs": -16,
          "truePeakDbfs": -1,
          "compThreshDb": -3.8,
          "compRatio": 4,
          "compAttackMs": 5,
          "compReleaseMs": 50
        },
        "metrics": {
          "sampleRate": 48000,
          "integratedLufs": -16.1,
          "truePeakDbfs": -1
        },
        "error": "The audio could not be cleaned.",
        "createdAt": "2026-10-11T10:21:04.512Z"
      }
    ],
    "total": 1
  },
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}