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

استنساخ الصوت - إنشاء نموذج

مزامنة الشفاه - إنشاء مهمة

ملف المستخدم

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

توليد صوت عبر REST باستخدام معرف الصوت وخيارات المحرك.

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

نقطة النهاية

POST /api/open/v1/speech/tts

رؤوس الطلب

// معلمات الطلب
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY  // مفتاح API

// معلمات الطلب
Content-Type: application/msgpack
Authorization: Bearer YOUR_API_KEY  // مفتاح API

معلمات الطلب

معلمات طلب مثال

الخيارات المتاحة:

  • • تحويل النص إلى كلام (HTTP): v1, v2, s1
  • • تحويل النص إلى كلام (HTTP v2): v3-turbo, v3-hd
  • • اختياري: توليد الكلام باستخدام معرف صوت وإعدادات محرك اختيارية.

بيانات الاستجابة

// بيانات الاستجابة (cache=false) - 200
Content-Type: audio/mpeg
<تنسيقات متعددة>

// بيانات الاستجابة (cache=true) - 200
Content-Type: application/json
{
  "success": boolean,        // بيانات الاستجابة
  "audio_url": string,       // تحويل الكلام إلى نص
  "format": string,          // تنسيقات متعددة
  "characters_used": number, // معلمات الطلب
  "quota_remaining": number  // اعرض رصيد API المتبقي ومعلومات الحساب الأساسية.
}

// فشل الاستعلام
{
  "error": string     // فشل الاستعلام
}

مثال CURL

# معلمات الطلب - اختياري
curl -X POST https://fishaudio.org/api/open/v1/speech/tts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "voiceId": "your_voice_id",
    "modelId": "fishaudio-s21pro-flash",
    "text": "تحويل الكلام إلى نص",
    "speed": 1.0,
    "volume": 0,
    "format": "mp3",
    "cache": false
  }' \
  --output output.mp3

# معلمات الطلب - الخيارات المتاحة:
curl -X POST https://fishaudio.org/api/open/v1/speech/tts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "voiceId": "your_voice_id",
    "modelId": "minimax-2.8-hd",
    "text": "تحويل الكلام إلى نص",
    "speed": 1.0,
    "volume": 0,
    "emotion": "calm",
    "language": "zh",
    "format": "mp3",
    "cache": false
  }' \
  --output output.mp3

# معلمات الطلب (undefined)

تصحيح عبر الإنترنت

أكواد الحالة

200: Success
400: Bad Request
401: Unauthorized
403: Forbidden
404: Not Found
429: Too Many Requests
500: Internal Server Error