Kitta Audio Docs
مرجع APIالكلام إلى النص
Back to site

الكلام إلى النص

قم بنسخ الصوت من خلال Open API.

الكلام إلى النص

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

POST /api/open/v1/speech/transcriptions
Authorization: Bearer KITTA_API_KEY
Content-Type: application/json

طلب

{
  "audioUrl": "https://example.com/audio.mp3",
  "language": "en"
}

يجب أن يكون من الممكن الوصول إلى audioUrl عن طريق خدمة API. إذا كانت ملفاتك خاصة، فقم بإنشاء عنوان URL موقع قصير الأمد ويظل صالحًا لفترة كافية للمعالجة. language اختياري. استخدم تلميح لغة مثل en أو zh أو ru عندما تعرف اللغة المصدر.

curl https://kittaai.com/api/open/v1/speech/transcriptions \
  -H "Authorization: Bearer KITTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"audioUrl":"https://example.com/audio.mp3","language":"en"}'

إجابة

{
  "text": "This is the transcription result.",
  "duration": 12.4,
  "segments": [],
  "credits_used": 13,
  "quota_remaining": 987987
}

يمكن أن يختلف شكل المقطع حسب الطراز وقدرة الحساب. يجب أن يتعامل المحلل اللغوي مع بيانات تعريف المقطع على أنها اختيارية ويستخدم text كنتيجة أولية.

الفواتير والائتمانات

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

عندما يفشل الطلب قبل بدء معالجة الصوت، لا ينبغي معاملة الاعتمادات مثل النسخ المكتمل. استخدم حقول الاستجابة وفحوصات الملف الشخصي للتسوية التشغيلية.

أخطاء

الحالةمعنىالعمل
400عنوان URL غير صالح، أو صوت غير مدعوم، أو JSONإصلاح الطلب
401مفتاح API مفقود أو غير صالحتحديث بيانات الاعتماد
402الاعتمادات أو الحصص غير كافيةوقف الدفعة
422كان من الممكن الوصول إلى الصوت ولكن تعذرت معالجتهاطلب من المستخدم ملفًا مختلفًا
500فشلت خدمة النسخأعد المحاولة مع التراجع إذا ظل عنوان URL صالحًا