الأصوات والاستنساخ
اعرض الملفات الصوتية وإعدادات المحركات ودعم الاستنساخ.
يربط GET /v1/audio/voices مكتبة أصوات VoiceStudio بالعملاء المتوافقين مع OpenAI.
curl "$VOICESTUDIO_BASE_URL/audio/voices" \
-H "Authorization: Bearer $VOICESTUDIO_API_KEY"تحتوي الاستجابة على قائمتين:
voices: أسماء OpenAI المستعارة وملفاتك المحفوظة.engines: محركات TTS المثبتة، مع دعم الاستنساخ وتوجيه الأجهزة وإرشادات الإعداد.
اعرض ملفاتك فقط:
curl -s "$VOICESTUDIO_BASE_URL/audio/voices" \
-H "Authorization: Bearer $VOICESTUDIO_API_KEY" \
| jq '.voices[] | select(.type == "profile") | {voice_id, name, language}'مرّر voice_id مباشرة إلى إنشاء الكلام:
{
"model": "tts-1",
"voice": "demo0001",
"input": "This line uses a saved VoiceStudio profile."
}القيم التي يقبلها voice
| القيمة | النتيجة |
|---|---|
default | الصوت الافتراضي للمحرك المحدد |
alloy, echo, fable, nova, onyx, shimmer | مقبولة للتوافق؛ تُربط بالصوت الافتراضي للمحرك |
| معرّف ملف شخصي | صوت المرجع والنص والأسلوب والقيمة الأولية المحفوظة |
| إعداد محرك مسبق | يُمرر إلى المحركات التي توفر أصواتًا مسماة |
أنشئ الملفات وأقفلها واستوردها وصدّرها وأدر الموافقة عبر المسارين /profiles/* و/personas/* الموثقين في مرجع API.
المعرّفات المحلية
معرّفات الملفات هنا تخص تطبيق سطح المكتب. يستخدم عقد Cloud غير الصادر موارد Voice مملوكة للمستأجر؛ ولا ينتقل معرّف الملف المحلي أو متن الطلب كما هو دون تغيير.