مرجع API

الحصول على نتائج استنساخ الصوت

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

استعلم بعد اكتمال المعالجة في الخلفية. حالة أرشفة النتيجة مستقلة عن النجاح. يُرجع الفشل 422؛ وتُرجع الحالة غير الجاهزة أو غير المعروفة 409.

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

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

Authorization: Bearer $GLOOP_API_KEY

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

الطلب

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

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

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

HTTP 200

نجح الطلب.

application/json

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

idstringمطلوب
statusstringمطلوب
القيم المعدودة
["succeeded"]
resultobjectمطلوب
الحقول الفرعية لـ result (6)
- file_idstringاختياري
  المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.
- storage_statusstringاختياري
  حالة أرشفة الملف؛ لا تُضمن التنزيلات المُدارة إلا بعد ready.
- audio_urlstringمطلوب
  رابط الوصول إلى الصوت المولّد؛ عند إدارته، توفر طبقة التخزين رابطًا موقّعًا.
- content_typestringاختياري
  نوع MIME للنتيجة.
- file_namestringاختياري
  اسم الملف العام للتنزيل.
- file_sizeintegerاختياري
  حجم ملف النتيجة بالبايت.
usageobjectمطلوب
الحقول الفرعية لـ usage (1)
- charactersintegerمطلوب
  الحد الأدنى
  0

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 422

فشل التوليد.

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