البدء السريع
أرسل أول طلب كلام إلى واجهة VoiceStudio المحلية.
واجهة API المحلية فقط
يستخدم هذا الدليل واجهة API للإصدار 0.5.0 من تطبيق سطح المكتب. لم تُصدر واجهة Cloud API بعد وتعمل بطريقة مختلفة: راجع معاينة Cloud.
1. ابدأ التطبيق
افتح VoiceStudio. تستمع واجهة API على المنفذ 3900 أثناء تشغيل التطبيق.
export VOICESTUDIO_BASE_URL="http://localhost:3900/v1"
export VOICESTUDIO_API_KEY="local"
curl http://localhost:3900/health{
"status": "ok",
"device": "cuda (NVIDIA GeForce RTX 4090)",
"version": "0.5.0"
}على localhost، يمكن أن يكون المفتاح أي سلسلة غير فارغة. لا يُتحقق منه إلا عند تفعيل الوصول عن بُعد.
2. أنشئ الكلام
curl "$VOICESTUDIO_BASE_URL/audio/speech" \
-H "Authorization: Bearer $VOICESTUDIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tts-1",
"voice": "alloy",
"input": "VoiceStudio is ready.",
"response_format": "mp3"
}' \
--output speech.mp33. أو استخدم إحدى حزم SDK من OpenAI
import os
from openai import OpenAI
client = OpenAI(
base_url=os.environ["VOICESTUDIO_BASE_URL"],
api_key=os.environ["VOICESTUDIO_API_KEY"],
)
audio = client.audio.speech.create(
model="tts-1",
voice="alloy",
input="The local VoiceStudio API is ready.",
)
audio.stream_to_file("speech.mp3")بعد ذلك، استبدل alloy بأحد معرّفات ملفاتك الصوتية.