استنساخ الصوت

POST /api/open/v1/voices
Authorization: Bearer FISHAUDIO_API_KEY
Content-Type: multipart/form-data

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

https://kittaai.com/api/open/v1/voices

يستخدم إنشاء الصوت الصوت المرجعي وتدفق إنشاء FishAudio. يتجاهل المسار Open API تجاوزات الموفر، لذلك لا تحتاج إلى إرسال حقل provider.

حقول الطلب

المجال	اكتب	مطلوب	الوصف
`name`	سلسلة	نعم	اسم الصوت
`audioFiles`	الملف[]	نعم	واحد أو أكثر من الملفات الصوتية المرجعية
`description`	سلسلة	لا	الوصف الصوتي
`referenceText`	سلسلة	لا	نسخة من الصوت المرجعي
`visibility`	سلسلة	لا	`private` أو `public`. الافتراضي: `private`
`languages`	سلسلة	لا	مصفوفة سلسلة JSON، مثل `'["zh","en"]'`

امتدادات الملفات المدعومة: aac، flac، m4a، mp3، mp4، mpeg، oga، ogg، opus، wav، وwebm. يمكن أن يصل حجم كل ملف إلى 10MB.

لا تقم بتعيين الحدود متعددة الأجزاء يدويًا. عند استخدام curl -F، أو المتصفح FormData، أو SDK، اسمح للعميل بإنشاء Content-Type.

مثال curl

curl -X POST "https://kittaai.com/api/open/v1/voices" \
  -H "Authorization: Bearer FISHAUDIO_API_KEY" \
  -F "name=My cloned voice" \
  -F "description=Chinese narration voice" \
  -F "visibility=private" \
  -F 'languages=["zh"]' \
  -F "audioFiles=@/path/to/sample-1.mp3;type=audio/mpeg" \
  -F "audioFiles=@/path/to/sample-2.wav;type=audio/wav"

إجابة

{
  "voiceId": "voice_abc123",
  "title": "My cloned voice",
  "description": "Chinese narration voice",
  "createdAt": "2026-07-09T00:00:00.000Z"
}

قم بتخزين voiceId الذي تم إرجاعه، ثم قم بتمريره مباشرة عند إنشاء الكلام.

أخطاء

الحالة	معنى
`400`	الحقول المفقودة، أو نوع ملف غير مدعوم، أو ملف كبير الحجم
`401`	مفتاح API مفقود أو غير صالح
`403`	لا يمكن للحساب إنشاء أصوات
`429`	طلبات إنشاء الصوت متكررة جدًا
`500`	فشل إنشاء الصوت على الخادم

إنشاء سجلات صوتية افتح استخدام API ويخضع لحصة API المفتوحة للحساب الحالي وتخصيص الموفر.

استنساخ الصوت

استنساخ الصوت

حقول الطلب

مثال curl

إجابة

أخطاء

في هذه الصفحة