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

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

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

ملف المستخدم

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

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

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

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

Endpoint

POST /api/open/v2/speech/tts

رؤوس الطلب

Content-Type
stringheaderمطلوب
application/json
Authorization
stringheaderمطلوب
Bearer <token> (مفتاح API)

معلمات الطلب

application/json
voiceId
stringمطلوب
استنساخ الصوت - قائمة النماذج
modelId
stringاختيارياختياري: engine
استنساخ الصوت - إنشاء نموذج
الخيارات المتاحة:fishaudio-s2profishaudio-s1minimax-2.8-turbominimax-2.8-hdminimax-2.6-turbominimax-2.6-hdqwen3-tts-flash
text
stringمطلوب
تحويل الكلام إلى نص
format
stringاختيارياختياري: mp3
تنسيقات متعددة
الخيارات المتاحة:mp3wavogg
speed
numberاختيارياختياري: 1
توليد سريع
volume
numberاختيارياختياري: 0
الخيارات المتاحة:
stability
numberاختياري
تزامن الصوت والصورة
similarity
numberاختياري
استنساخ الصوت - إنشاء نموذج
pitch
numberاختياري
الخيارات المتاحة:
language
stringاختياري
الخيارات المتاحة:
emotion
stringاختياري
إبداع بلا حدود
الخيارات المتاحة:happysadangryfearfuldisgustedsurprisedcalm
token
string // Optional if Authorization: Bearer is set
اعرض رصيد API المتبقي ومعلومات الحساب الأساسية.

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

// بيانات الاستجابة - 200
Content-Type: audio/mpeg (or audio/wav / audio/ogg depending on format)
<تنسيقات متعددة>

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

// فشل الاستعلام
{
  "code": string,
  "message": string,
  "requestId"?: string
}

مثال CURL

curl -X POST https://fishspeech.vercel.app/api/open/v2/speech/tts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "voiceId": "00a1b221-6137-4b73-ad62-b0cbce134167",
    "modelId": "fishaudio-s2pro",
    "text": "Hello, world.",
    "format": "wav",
    "speed": 1,
    "volume": 0
  }' \
  --output output.wav

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

أكواد الحالة

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