وظائف غير متزامنة

استخدم مهام TTS غير المتزامنة للنص الطويل وإنشاء الدُفعات وسير العمل بنمط خطاف الويب وتدفقات واجهة المستخدم حيث يمكن للمستخدمين مغادرة الصفحة بينما لا يزال الصوت قيد المعالجة.

إنشاء وظيفة

POST /api/open/v1/speech/tts/jobs
Authorization: Bearer FISHAUDIO_API_KEY
Content-Type: application/json

طلب

{
  "text": "Hello from Fish Audio.",
  "voiceId": "00a1b221-6137-4b73-ad62-b0cbce134167",
  "modelId": "fishaudio-s2pro",
  "format": "mp3"
}

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

يستخدم المثال اختبار النظام العام الصوتي 00a1b221-6137-4b73-ad62-b0cbce134167. استبدله بالمعرف الصوتي المفضل لديك بعد التحقق من الاتصال.

curl https://fishaudio.org/api/open/v1/speech/tts/jobs \
  -H "Authorization: Bearer FISHAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello from Fish Audio.","voiceId":"00a1b221-6137-4b73-ad62-b0cbce134167","modelId":"fishaudio-s2pro","format":"mp3"}'

إجابة

تقوم نقطة نهاية الإنشاء بإرجاع 202 Accepted مع كائن مهمة. يمكن أن تتطور حقول المهمة المحددة، ولكن يجب على العملاء على الأقل تخزين المعرف والحالة.

{
  "id": "task_123",
  "status": "queued"
}

احصل على وظيفة

GET /api/open/v1/speech/tts/jobs/{taskId}
Authorization: Bearer FISHAUDIO_API_KEY

تتضمن المهام الناجحة audioUrl عندما يمكن إنشاء عنوان URL صوتي قصير العمر. تتضمن المهام الفاشلة رمز خطأ أو رسالة. تعامل مع queued وprocessing كحالات غير طرفية واستقصاء مع التراجع.

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

قد تقوم المهام غير المتزامنة بحجز الأرصدة أو استهلاكها أثناء إنشاء المهمة أو إكمالها وفقًا للنموذج الممكّن. لا تقم بإنشاء مهام مكررة كإستراتيجية إعادة المحاولة ما لم يطلب المستخدم صراحةً إخراجًا ثانيًا. تخزين معرف المهمة والاسترداد منه.

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

أخطاء