مرجع API

طلب إلغاء مهمة استنساخ صوت

POST/v1/audio-clone/tasks/{task_id}/cancel

يطلب الإلغاء دون ضمان الإلغاء أو استرداد المبلغ؛ باستخدام المصادقة العادية والمفتاح نفسه.

المصادقة والصلاحيات

استخدم مفتاح GloopAPI الحالي. تعتمد النماذج والإمكانات والصلاحيات المتاحة على دليله ووثائق نقطة النهاية.

Authorization: Bearer $GLOOP_API_KEY

آليات المصادقة: BearerAuth

الطلب

معاملات المسار

task_idstringمطلوب
المعرّف العام لمهمة أُنشئت بالمفتاح نفسه.

الاستجابات والأخطاء

HTTP 200

نجح الطلب.

application/json

النوع: object
الحقول المطلوبة: idcancel_requested

idstringمطلوب
cancel_requestedbooleanمطلوب
القيم المعدودة
[true]

HTTP 401

Key مفقود أو غير صالح أو منتهي أو ملغى.

application/json

النوع: object
الحقول المطلوبة: error

errorobjectمطلوب
الحقول الفرعية لـ error (4)
- codestringاختياري
- messagestringاختياري
- typestringاختياري
- request_idstringاختياري

HTTP 403

صلاحيات IP أو الحساب أو النموذج أو الأداة غير كافية.

application/json

النوع: object
الحقول المطلوبة: error

errorobjectمطلوب
الحقول الفرعية لـ error (4)
- codestringاختياري
- messagestringاختياري
- typestringاختياري
- request_idstringاختياري

HTTP 404

الكائن أو الإمكانية غير متاحين.

application/json

النوع: object
الحقول المطلوبة: error

errorobjectمطلوب
الحقول الفرعية لـ error (3)
- messagestringمطلوب
- typestringمطلوب
  القيم المعدودة
  ["new_api_error"]
- codestringمطلوب
  القيم المعدودة
  ["invalid_request","invalid_reference_audio_url","text_too_long","idempotency_conflict","insufficient_quota","task_not_found","task_not_ready","task_failed","submission_state_unknown","upstream_unavailable","upstream_protocol_error"]

HTTP 409

تعارض في الطلب، أو عدم جاهزية، أو إرسال غير معروف النتيجة. استعلم عن السجل الأصلي أولًا؛ ولا تُعِد الإرسال دون تحقق.

application/json

النوع: object
الحقول المطلوبة: error

errorobjectمطلوب
الحقول الفرعية لـ error (3)
- messagestringمطلوب
- typestringمطلوب
  القيم المعدودة
  ["new_api_error"]
- codestringمطلوب
  القيم المعدودة
  ["invalid_request","invalid_reference_audio_url","text_too_long","idempotency_conflict","insufficient_quota","task_not_found","task_not_ready","task_failed","submission_state_unknown","upstream_unavailable","upstream_protocol_error"]

HTTP 429

حد معدل الطلبات/قائمة الانتظار.

application/json

النوع: object
الحقول المطلوبة: error

errorobjectمطلوب
الحقول الفرعية لـ error (4)
- codestringاختياري
- messagestringاختياري
- typestringاختياري
- request_idstringاختياري

HTTP 500

فشل داخلي في المصادقة أو تخزين البيانات.

application/json

النوع: object
الحقول المطلوبة: error

errorobjectمطلوب
الحقول الفرعية لـ error (4)
- codestringاختياري
- messagestringاختياري
- typestringاختياري
- request_idstringاختياري

HTTP 502

خطأ في استجابة الخدمة.

application/json

النوع: object
الحقول المطلوبة: error

errorobjectمطلوب
الحقول الفرعية لـ error (3)
- messagestringمطلوب
- typestringمطلوب
  القيم المعدودة
  ["new_api_error"]
- codestringمطلوب
  القيم المعدودة
  ["invalid_request","invalid_reference_audio_url","text_too_long","idempotency_conflict","insufficient_quota","task_not_found","task_not_ready","task_failed","submission_state_unknown","upstream_unavailable","upstream_protocol_error"]

HTTP 503

الخدمة أو التخزين أو التسعير غير متاحة مؤقتًا.

application/json

النوع: object
الحقول المطلوبة: error

errorobjectمطلوب
الحقول الفرعية لـ error (3)
- messagestringمطلوب
- typestringمطلوب
  القيم المعدودة
  ["new_api_error"]
- codestringمطلوب
  القيم المعدودة
  ["invalid_request","invalid_reference_audio_url","text_too_long","idempotency_conflict","insufficient_quota","task_not_found","task_not_ready","task_failed","submission_state_unknown","upstream_unavailable","upstream_protocol_error"]