دليل الهجرة
الانتقال من مسارات API القديمة المفتوحة إلى فتح API v1.
دليل الهجرة
يجب أن تستدعي عمليات التكامل الجديدة /api/open/v1. تظل المسارات القديمة متاحة أثناء نافذة التوافق، لكن لا ينبغي استخدامها في العمل الجديد.
رسم خرائط المسار
| المسار القديم | افتح مسار API v1 |
|---|---|
POST /api/open/create-model | POST /api/open/v1/voices |
POST /api/open/delete-model | DELETE /api/open/v1/voices/{voiceId} |
POST /api/open/list-models | GET /api/open/v1/voices |
POST /api/open/lip-sync/create | POST /api/open/v1/media/lip-sync/jobs |
GET /api/open/lip-sync/list | GET /api/open/v1/media/lip-sync/jobs |
GET /api/open/lip-sync/query | GET /api/open/v1/media/lip-sync/jobs/{jobId} |
قم بتأكيد أشكال الطلب والاستجابة النهائية باستخدام:
GET /api/openapi.jsonالطلب الموصى به
- قم بتبديل المكالمات للقراءة فقط أولاً، مثل ملف التعريف وقائمة الصوت وحالة الوظيفة.
- انقل نقاط نهاية الإنشاء بعد أن تتم تغطية تحليل الطلب والاستجابة بواسطة الاختبارات.
- استمر في تسجيل كل من نقطة النهاية القديمة ونقطة النهاية الجديدة أثناء الطرح.
- قم بإزالة مسارات العميل القديمة فقط بعد أن لم تعد حركة الإنتاج تعتمد عليها.
طلب التغييرات
استخدم مصادقة الحامل لكل طلب v1.
Authorization: Bearer KITTA_API_KEYاستخدم معرّفات ثابتة في نص الطلب. بالنسبة إلى TTS، أرسل معرّف الصوت في voiceId ومعرّف نموذج محرك TTS في modelId. يبقى reference_id فقط اسماً مستعاراً قديماً لمعرّف الصوت.
استخدم صوت النظام العام 00a1b221-6137-4b73-ad62-b0cbce134167 لاختبار دخان الهجرة الصغير، ثم قم بالتبديل إلى معرف الصوت الإنتاجي المحدد بواسطة التطبيق الخاص بك.
تغييرات الاستجابة
تم تصميم نقاط النهاية V1 حول موارد واضحة: الأصوات والمهام والوظائف وسجلات الملفات الشخصية. قم بتحديث العميل الخاص بك لتحليل حقول الاستجابة الخاصة بنقطة النهاية بدلاً من الاعتماد على شكل مجمّع عام واحد.
بالنسبة لعمليات الوسائط غير المتزامنة، استمر في الوظيفة التي تم إرجاعها أو معرف المهمة على الفور. يجب أن يستخدم الاستقصاء وإعادة المحاولة وتحقيقات الدعم هذا المعرف.
الفواتير والائتمانات
لا يؤدي الترحيل بحد ذاته إلى تغيير رصيد الحساب، لكن نقاط النهاية الجديدة قد تكشف عن أرصدة وحقول حصص أكثر وضوحًا. أثناء الطرح، قارن مسارات التعليمات البرمجية القديمة والجديدة في المهام الصغيرة قبل نقل حركة المرور ذات الحجم الكبير.
إذا فشل الطلب أثناء الترحيل، فقم بتسجيل المسار القديم والمسار الجديد ورمز الحالة API requestId ومعرف الوظيفة الداخلي الخاص بك. يوفر ذلك الدعم سياقًا كافيًا دون الكشف عن مفاتيح API لحاملها أو عناوين URL للوسائط الخاصة.