مرجع API

الاستعلام عن حالة استنساخ الصوت

GET/v1/audio-clone/tasks/{task_id}/status

استعلم بالحساب والمفتاح نفسيهما؛ يظل TokenAuth العادي وقيود نموذج audio-clone-v1 ساريين.

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

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

Authorization: Bearer $GLOOP_API_KEY

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

الطلب

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

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

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

HTTP 200

نجح الطلب.

application/json

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

idstringمطلوب
statusstringمطلوب
القيم المعدودة
["queued","processing","succeeded","failed","cancelled"]

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"]