التوثيق

مرجع API

إنشاء مهمة استنساخ صوت

POST/v1/audio-clone/tasks

يستخدم TokenAuth العادي؛ قد تُرفض الاستعلامات عند نفاد الحصة بخلاف مصادقة الصور/الفيديو الدائمة. الإنشاء افتراضيًا audio-clone-v1 والاستعلام في الخلفية. لا تكرر الإرسال المجهول عشوائيًا.

حدود استعادة مهام الاستنساخ

يستخدم إنشاء الاستنساخ والاستعلام اللاحق المصادقة العادية. احتفظ بحصة كافية وبـ Key الأصلي. لا تفترض أن الاستنساخ يسمح بمفتاح نفدت حصته لمجرد أن استعلام الصور أو الفيديو يسمح بذلك.

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

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

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

Authorization: Bearer $GLOOP_API_KEY

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

الطلب

ترويسات الطلب

  • Idempotency-Keystringاختياري
    الحد الأقصى للطول
    191
    النمط
    "^[\\x20-\\x7E]{0,191}$"

جسم الطلب · application/json

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

جسم الطلب مطلوب

  • modelstringاختياري

    معرّف نموذج عام من دليل المفتاح الحالي.

    القيمة الافتراضية
    "audio-clone-v1"
    القيم المعدودة
    ["audio-clone-v1"]
  • textstringمطلوب

    النص المراد تحويله إلى كلام.

    الحد الأدنى للطول
    1
    الحد الأقصى للطول
    5000
  • reference_audio_urlstringمطلوب

    رابط HTTPS عام للصوت المرجعي، دون معلومات مستخدم ويخضع لفحص SSRF.

  • reference_textstringمطلوب

    النص المقابل للصوت المرجعي.

    الحد الأدنى للطول
    1
    الحد الأقصى للطول
    5000
  • remove_silencebooleanاختيارييسمح بـ null

    هل يُحذف الصمت؛ القيمة الافتراضية true عند الإغفال.

    القيمة الافتراضية
    true

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

HTTP 202

قُبلت المهمة ولا يعني ذلك اكتمالها.

application/json

النوع
object
الحقول المطلوبة
idstatuscreated_at
  • idstringمطلوب
  • statusstringمطلوب
    القيم المعدودة
    ["queued"]
  • created_atintegerمطلوب
    التنسيق
    "int64"

HTTP 400

معاملات الطلب غير صالحة.

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 401

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

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 402

الحصة المتاحة للحساب أو المفتاح غير كافية.

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 403

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

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

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)

HTTP 500

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

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

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