الكلام إلى النص
قم بنسخ الصوت من خلال 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 صالحًا |