التوثيق

مرجع API

تحويل النص إلى كلام

POST/v1/audio/speech

يولّد الكلام ويُرجع بايتات صوت خاصة بالنموذج عند النجاح. يحدد النموذج المختار التنسيق الافتراضي. عند تفعيل أرشفة الملفات، تصف ترويسات الاستجابة مثل X-Gloop-File-Id/X-Gloop-Storage-Status مرحلة الحفظ. لا تتعامل مع الصوت على أنه JSON.

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

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

Authorization: Bearer $GLOOP_API_KEY

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

الطلب

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

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

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

  • modelstringمطلوب
  • inputstringمطلوب

    النص المراد تحويله إلى كلام؛ يعتمد حد الطول على النموذج المختار. لا يوجد حد موحد يبلغ 4096 حرفًا.

  • voicestringمطلوب

    يعتمد الدعم والحدود على النموذج المختارين؛ لا تُضمن قيم افتراضية موحدة.

  • response_formatstringاختياري

    تنسيق الصوت المطلوب للمخرجات؛ تعتمد القيم المدعومة والتنسيق عند الإغفال على النموذج المختارين. لا تعيّن نقطة النهاية العامة بالمنصة mp3 كقيمة افتراضية.

  • speednumberاختياري

    يعتمد الدعم والحدود على النموذج المختارين؛ لا تُضمن قيم افتراضية موحدة.

  • instructionsstringاختياري

    تعليمات كلام خاصة بالنموذج.

  • stream_formatstringاختياري

    تنسيق تدفق خاص بالنموذج؛ لا يُضمن دعم SSE لكل نموذج.

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

HTTP 200

تم توليد الصوت بنجاح

audio/mpeg

النوع
string
التنسيق
binary
الوصف
تدفق بايتات صوت؛ احفظه كملف.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/wav

النوع
string
التنسيق
binary
الوصف
تدفق بايتات صوت؛ احفظه كملف.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/ogg

النوع
string
التنسيق
binary
الوصف
تدفق بايتات صوت؛ احفظه كملف.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/flac

النوع
string
التنسيق
binary
الوصف
تدفق بايتات صوت؛ احفظه كملف.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/aac

النوع
string
التنسيق
binary
الوصف
تدفق بايتات صوت؛ احفظه كملف.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

application/octet-stream

النوع
string
التنسيق
binary
الوصف
تدفق بايتات صوت؛ احفظه كملف.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

HTTP 401

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

application/json

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

HTTP 403

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

application/json

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

HTTP 429

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

application/json

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

HTTP 500

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

application/json

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