الرابط الأساسي https://api.echonova.ai

المطورون

قراءة نشاط API الخاص بك

افتح صفحة النشاط في المطورون، واقرأ تبويبات نظرة عامة والاتجاهات والاستكشاف والسجلات، واعرف بالضبط أي الطلبات والرصيد تحسبهما الصفحة.

تعرض صفحة النشاط ما فعلته مفاتيح API الخاصة بك، والرصيد الذي أنفقته. تحسب الصفحة استخدام واجهة المطورين فقط: طلبات /v1 المُرسلة بمفتاح API، والرصيد المخصوم من مفتاح API. وهذا يشمل تحويل النص إلى كلام وتحويل الكلام إلى نص وتنقية الصوت. ترى الرصيد والطلبات والكلام والصوت، مقسّمة حسب مفتاح API والخدمة والصوت. استخدمها لتجد المفتاح الذي ينفق أكثر، واليوم الذي بدأ فيه الارتفاع، والطلبات التي فشلت.

لا تظهر على النشاط صفحات البوابة، مثل ساحة التجربة، ولا الوكلاء. ويشمل ذلك صوت «صدى» ومحادثته، وEchoReader، واستنساخ الصوت، وقاعدة المعرفة، ومنشئ الوكلاء، وأدوات قواعد البيانات. ويظهر رصيدها في سجل الرصيد.

ما تحتاجه

  • حساب في إيكونوڤا ومساحة عمل بها مفتاح API واحد على الأقل. راجع احصل على مفتاح API.
  • صلاحية مالك مساحة العمل، وتشمل الإذن developer_api.view.
  • بعض النشاط. إلى أن يُرسل مفتاح طلبًا، تعرض كل البطاقات 0 وتكون الرسوم البيانية فارغة.

افتح النشاط

افتح المطورون في البوابة، واختر الرابط السريع النشاط حسب المفتاح، أو انتقل إلى /developers/activity. تفتح الصفحة على تبويب نظرة عامة مع الفترة 30 يومًا.

الشريط العلوي

يتحكم الشريط العلوي في كل التبويبات دفعة واحدة. يُحفظ كل اختيار في عنوان الصفحة، فيبقى عرضك بعد إعادة التحميل.

عنصر التحكم ما يفعله
شريحة المنطقة الزمنية ليست زرًا، بل عنوان. تعرض فرق توقيت متصفحك، مثل GMT+4. تُجمَّع الأيام والأسابيع والأشهر في منطقة متصفحك. لا يوجد مفتاح للتبديل إلى UTC.
تصفية يفتح لوحة فيها مفتاح API والخدمة والصوت. كل منها على الكل حتى تختار قيمة. تظهر شريحة لكل تصفية تضبطها.
الفترة 7 أيام، 30 يومًا، 90 يومًا أو سنة واحدة.
تصدير CSV يُنزّل إجماليات يومية لكل مفتاح API والخدمة والصوت كملف CSV باسم echonova-activity-<from>-to-<to>.csv، بالأعمدة date وapi_key وkey_prefix وservice وvoice وrequests وfailed وunits وunit وcredits وusd_at_plan_rate. قيمة unit هي minutes لتحويل الكلام إلى نص وتنقية الصوت، وcharacters لتحويل النص إلى كلام. تقول الرسالة المنبثقة تم تنزيل ملف CSV.
نسخ الرابط ينسخ رابطًا لهذا العرض بالضبط: التبويب والفترة والتصفيات. لا تُضمَّن المنطقة الزمنية في الرابط، فمن يفتحه يرى الأيام في منطقة متصفحه. تقول الرسالة المنبثقة تم نسخ رابط هذا العرض.

اختر مسح الكل في لوحة التصفية لإزالة كل التصفيات، أو اختر شريحة لإزالة تصفية واحدة.

نظرة عامة

يجيب تبويب نظرة عامة عن المكان الذي ذهب إليه الرصيد في الفترة.

  • خمس بطاقات: الرصيد المستخدم والطلبات والكلام المُولَّد والصوت المعالَج ونسبة النجاح. تُقارَن كل بطاقة بالفترة السابقة بالطول نفسه. وتعرض الرصيد المستخدم التكلفة أيضًا بصيغة ≈ $x بسعر باقة {plan}، مثل ≈ $12.40 بسعر باقة Growth، أو ≈ $x بسعر فترتك التجريبية في الفترة التجريبية. ولا يظهر السطر إذا لم يكن هناك سعر.
  • تحسب الصوت المعالَج الصوت المُرسل إلى تحويل الكلام إلى نص وتنقية الصوت. أما الكلام المُولَّد فيُحسب بالأحرف لا بالصوت. وما دون الدقيقة يظهر بالثواني، مثل 9 ث.
  • رسم أعمدة للبطاقة المختارة يومًا بيوم. استخدم تجميع حسب لتقسيمه حسب الخدمة أو مفتاح API أو الصوت. مرّر المؤشر على عمود لرؤية التفاصيل. اختر عمودًا لفتح ذلك اليوم في تبويب السجلات.
  • أكثر مفاتيح API استخدامًا وأكثر الأصوات استخدامًا، مرتبة حسب الرصيد. اختر مفتاحًا لتصفية كل التبويبات. والمفتاح الذي خُزِّنت آخر 4 محارف منه يظهر كـ ek_… مع هذه المحارف الأربعة، مثلًا ek_…c21d. أما المفتاح الذي لم تُخزَّن له هذه المحارف فيظهر بادئته.
  • الطلبات الفاشلة، حسب مفتاح API، مع المفتاح الذي له أعلى معدل فشل. لا تُحتسب الطلبات الفاشلة أبدًا.
  • رصيد الباقة في هذه الدورة. يعرض سطر الباقة الباقة كاملة: الرصيد الممنوح، والرصيد الذي استخدمته كل المنتجات، ونهاية الفترة الحالية. تشترك كل المنتجات في الباقة، لذلك تشمل هذه البطاقة استخدام البوابة والوكلاء، بينما كل رقم آخر في الصفحة استخدام API فقط. ويظهر السطر فقط عندما تكون لمساحة العمل باقة. ويظهر استخدام كل مفتاح لحد رصيده الخاص عندما يكون لذلك المفتاح حد. ويعرض المفتاح الذي بلغ 80% من حده أو أكثر عبارة قريب من الحد.

يقارن تبويب الاتجاهات هذه الفترة بالفترة التي قبلها، يومًا بيوم.

  1. اختر مقياسًا: الرصيد أو الطلبات أو الأحرف أو الدقائق.
  2. اقرأ الرسم الخطي. هذه الفترة والفترة السابقة تشتركان في محور واحد.
  3. اقرأ أكبر التغييرات، وهي المفاتيح أو الخدمات أو الأصوات التي تغيّرت أكثر. استخدم عرض للتبديل بين الكل ومفاتيح API والخدمات والأصوات. اختر صفًا لتصفية نظرة عامة.

يظهر جديد لكل مفتاح أو خدمة أو صوت لا نشاط له في الفترة السابقة.

استكشاف

يبني تبويب استكشاف رسمًا خاصًا بك. اضبط عناصر التحكم التالية:

عنصر التحكم الخيارات
المقياس الرصيد، الإنفاق ($)، الطلبات، الأحرف، دقائق الصوت، الأخطاء
تجميع حسب مفتاح API أو الخدمة أو الصوت أو بدون. يضيف ثم حسب تقسيمًا ثانيًا.
لكل يوم أو أسبوع أو شهر أو بدون (ترتيب)
عرض أعلى 3 أو أعلى 5 أو أعلى 8؛ والباقي يُجمع تحت أخرى
نوع الرسم أعمدة أو خطوط أو نقاط

فعّل إجمالي تراكمي لخط تراكمي. تضبط إعدادات جرّب:، مثل الإنفاق لكل مفتاح، أسبوعيًا، عناصر التحكم نيابةً عنك. يعرض جدول البيانات أسفل الرسم الأرقام نفسها.

السجلات

يعرض تبويب السجلات الطلبات وراء الأرقام، 25 صفًا في كل صفحة، مع السابق والتالي. يتبع تصفيات الشريط العلوي والفترة. اختر عمود يوم في نظرة عامة لترى ذلك اليوم فقط. فعّل الفاشلة فقط لإخفاء الطلبات الناجحة. اختر بلا صوت في تصفية الصوت لترى الطلبات التي لم تستخدم صوتًا فقط. الصق قيمة X-Request-Id في ابحث بمعرّف الطلب لترى ذلك الاستدعاء من آخر 365 يومًا، مهما كانت الفترة والتصفيات. امسح الحقل لتعود. يعرض السطر فوق القائمة عدد الطلبات، مثل 12 طلب، وينتهي بـ · تُحفظ السجلات 365 يومًا فقط عندما تكون الفترة سنة واحدة.

العمود ما يعرضه
الوقت التاريخ والوقت اللذان سُجِّل فيهما الطلب.
مفتاح API اسم المفتاح.
نقطة الوصول الأسلوب والمسار، مثل POST /v1/text-to-speech/sync.
الحالة الحالة التي تلقاها عميلك. يعرض الاستدعاء الناجح 200، وكذلك المهمة غير المتزامنة المقبولة. ويعرض الطلب الفاشل حالته الدقيقة.
الرصيد الرصيد الذي خُصم عن الطلب.
المدة المدة التي استغرقتها API للرد.

اختر صفًا لتوسيعه:

الحقل ما يعرضه
معرّف الطلب قيمة header X-Request-Id في الاستجابة. اذكرها عند التواصل مع الدعم.
الخدمة تحويل النص إلى كلام، أو تحويل الكلام إلى نص، أو تنقية الصوت.
الصوت الصوت المستخدم، أو بلا صوت.
المحتسب الأحرف أو الدقائق، والرصيد.
errorMessage للطلب الفاشل، الرسالة التي تلقاها عميلك. تليها عبارة لم يُحتسب أي رصيد.

تحمل كل استجابة من API header X-Request-Id. سجّلها عندك، وابحث عنها هنا.

ما الذي يُحسب طلبًا

يحسب النشاط كل طلب إلى /v1 يُرسل بمفتاح API معروف، أيًا كان أسلوبه وأيًا كانت الإجابة. ويشمل ذلك طلبات GET وDELETE، مثل استطلاع المهمة أو عرض المهام والأصوات. لا تخصم طلبات GET أي رصيد.

  • كل طلب إلى /v1 بمفتاح معروف: 200 و402 و403 لفحص النطاق أو الخطة، و404 و415 و422، وأول 429 خاص بالمفتاح في كل نافذة للحد، و4xx أو 5xx بعد قبول المفتاح.
  • الرصيد المخصوم من مفتاح API، لتحويل النص إلى كلام وتحويل الكلام إلى نص وتنقية الصوت.

عمليات تشغيل البوابة واستخدام الوكلاء ليست طلبات، ولا تملك صفوفًا. تظهر الأرصدة التي تنفقها في سجل الرصيد، لا هنا.

قد تعرض الصفوف الأقدم 201 لطلب POST ناجح حتى تنتهي بعد 365 يومًا.

يسجّل الصف الحالة التي تلقاها عميلك. يعرض الاستدعاء الناجح 200، وتعرض المهمة غير المتزامنة المقبولة 200 أيضًا.

يُعاد الرصيد لاستدعاء متزامن يفشل في الساعة نفسها، فيتساوى الخصم والاسترداد. ويُعاد الرصيد أيضًا لمهمة غير متزامنة تفشل لاحقًا، لكن صف سجلها يحتفظ بـ 200، وهي الحالة التي تلقاها عميلك حين قُبلت المهمة.

ما الذي لا يُحسب

  • أي 401: header Authorization مفقود أو مشوّه، أو مفتاح غير معروف أو معطّل أو محذوف، أو مساحة عمل مغلقة. لا تستطيع إيكونوڤا معرفة مساحة العمل التي ينتمي إليها.
  • 429 لكل عنوان IP يُطلق قبل معرفة المفتاح.
  • أي 429 خاص بالمفتاح يأتي بعد الأول في نافذة الحد نفسها.
  • جسم رُفض قبل فحص المفتاح: 413 لجسم JSON أكبر من 100 كيلوبايت، و400 لجسم ليس JSON صالحًا.
  • عمليات تشغيل البوابة، مثل ساحة التجربة، واستخدام الوكلاء: صوت «صدى» ومحادثته، وEchoReader، واستنساخ الصوت، وقاعدة المعرفة، ومنشئ الوكلاء، وأدوات قواعد البيانات. ليس لها صفوف، ولا تُضيف أي رصيد إلى الصفحة. راجع سجل الرصيد.

رصيد أي فترة يساوي الخصومات المحسوبة على مفاتيح API في سجل الرصيد، مطروحًا منها الاستردادات في تلك الفترة. بطاقة الباقة هي الاستثناء، فهي تعرض الباقة كاملة.

الحدود

الحد القيمة ينطبق على
بداية السجل يوم إطلاق هذه الصفحة. لا يُستكمل النشاط السابق له. الرسوم والإجماليات
الإجماليات اليومية المحفوظة 800 يوم نظرة عامة، الاتجاهات، استكشاف
صفوف سجل الطلبات 365 يومًا تبويب السجلات
الصفوف في كل صفحة 25 تبويب السجلات
الفترات 7 أيام، 30 يومًا، 90 يومًا، سنة واحدة الشريط العلوي
المسجَّل لكل صف الأسلوب، والمسار، والحالة، والمدة، والمفتاح، والخدمة، والصوت، والوحدات المحتسبة، ورسالة الخطأ كل صف في السجل
غير المسجَّل متن الطلب، والنص، والمقطع الصوتي، والـ headers، ونص الاستعلام، وعنوان IP للعميل كل صف في السجل

الأسئلة الشائعة

لماذا يقل إجماليي عمّا توقعت؟

يبدأ السجل في يوم إطلاق هذه الصفحة، ولا تظهر الأرصدة السابقة له. تحقق أيضًا من شرائح تصفية تحت الشريط العلوي. يُحسب كل طلب، لكن الطلبات المخصومة وحدها تضيف رصيدًا، فالسكربت الذي يكتفي بالاستطلاع يضيف طلبات بلا رصيد.

لماذا تعرض مهمة فاشلة حالة نجاح؟

قبلت API المهمة وأجابت بالحالة 200، لذا يحتفظ الصف بتلك الحالة. وعندما تفشل المهمة لاحقًا يُعاد رصيدها وتتساوى الإجماليات، لكن الصف لا يتغير.

أين طلبات 401 الخاصة بي؟

لا تُحسب. تعني 401 أن المفتاح مفقود أو مشوّه أو غير معروف أو معطّل أو محذوف، أو أن مساحة العمل مغلقة، فلا توجد مساحة عمل تظهر فيها.

هل تشمل الصفحة البوابة أو الوكلاء؟

لا. يعرض النشاط استخدام مفاتيح API فقط. لا تظهر صفحات البوابة، مثل ساحة التجربة، ولا الوكلاء هنا. ويظهر رصيدها في سجل الرصيد. وتظل بطاقة رصيد الباقة تعرض الباقة كاملة، لأن كل المنتجات تشترك فيها.

أي منطقة زمنية تستخدم الصفحة؟

منطقة متصفحك. تعرض الشريحة بجوار تصفية فرقها، مثل GMT+4، وتُجمَّع الأيام في تلك المنطقة. لا يوجد مفتاح للتبديل إلى UTC، ولا تدخل المنطقة في الرابط المنسوخ.

من يستطيع رؤية النشاط؟

مالك مساحة العمل، الذي يملك دوره الإذن developer_api.view.