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

يُحافظ على V2 للعملاء الحاليين فقط. تستخدم التكاملات الجديدة v3.

Endpoint

POST /api/open/v2/speech/tts

العنوان الكامل:

https://fishaudio.org/api/open/v2/speech/tts

المصادقة وترويسات الطلب

Authorization: Bearer FISHAUDIO_API_KEY
Content-Type: application/json
X-Request-Id: YOUR_STABLE_REQUEST_ID

حقول الطلب

field	type	required	constraints
`text`	string	yes	1–10,000
`voiceId`	string	yes	must support `modelId`
`modelId`	string	no	public model ID
`format`	string	no	`mp3`, `wav`, `ogg`; default `mp3`
`speed`	number	no	0.5–2; default 1
`volume`	number	no	-20–20; default 0
`pitch`	number	no	-12–12
`stability`	number	no	0.5–1.5
`similarity`	number	no	0.5–1.5
`language`	string	no	1–64 characters in v3
`emotion`	string	no	1–64 characters in v3
`instruction`	string	no	up to 1,600 characters
`textNormalization`	boolean	no	structured-text normalization

V2 also accepts legacy engineModelId, version, qwenModel, and minimaxEmotion fields. Do not use them in new clients.

curl

curl "https://fishaudio.org/api/open/v2/speech/tts" \
  -H "Authorization: Bearer $FISHAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Request-Id: legacy-tts-001" \
  -d '{"text":"Hello","voiceId":"00a1b221-6137-4b73-ad62-b0cbce134167","modelId":"fishaudio-s21pro-flash","format":"mp3"}' --output speech.mp3

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

تعيد الاستجابة الناجحة بيانات صوتية ثنائية. افحص حالة HTTP ثم Content-Type؛ الأخطاء بصيغة JSON.

الأخطاء وإعادة المحاولة

400 طلب غير صالح؛ 401 مفتاح غير صالح؛ 402 حصة غير كافية؛ 404 غير موجود؛ 409 تعارض؛ 413 كبير؛ 429 حد المعدل؛ 500 فشل.

Migration

يظل عملاء v1/v2 متوافقين. تستخدم التكاملات الجديدة v3. Migration guide.