انتقل إلى المحتوى

قائمة الأصوات

يقدم دليل واجهة برمجة التطبيقات هذا نظرة عامة حول كيفية إدراج الأصوات المتاحة على منصتنا.


باستخدام هذه الواجهة، ستتمكن من استرجاع قائمة كاملة بجميع الأصوات المتاحة، بما في ذلك الخيارات الافتراضية والمخصصة. لإنشاء طلبات فيديو جماعية، ستحتاج إلى 'id' و'voice_service_name' المقابل لمعالجة وإدارة طلبات متعددة بكفاءة عبر منصتنا. 🎧🎬

بدء

سريع: لنستكشف كيفية الحصول على تفاصيل الصوت، حتى تتمكن من الوصول إليها واستخدامها بسهولة في مقاطع الفيديو الخاصة بك. 🎧✨

إدراج الأصوات الافتراضية:

توفر هذه الواجهة قائمة بالأصوات الافتراضية. اختر صوتًا من القائمة وسجّل 'id' و'voice_service_name' الخاص به، وهما مطلوبان للاستخدام في إنشاء القوالب أو إنشاء الطلبات الجماعية.

curl --request GET \
     --url 'https://api.immersive-fox.com/v1/voice/default_voices/'  \
     --header 'X-Api-Key: <your-api-key>' \
     --header 'Content-Type: application/json'
[
    {
        "id": 2,
        "language": "Afrikaans",
        "label": "󰑠 Afrikaans - Informative",
        "gender": "Female",
        "language_code": "af-ZA",
        "voice_service_name": "google_audio"
    }
]

قائمة الأصوات المخصصة:

توفر هذه الواجهة البرمجية قائمة بالأصوات المخصصة. اختر صوتًا من القائمة وسجّل 'id' و'voice_service_name'، وهما مطلوبان للاستخدام في إنشاء القوالب أو إنشاء الطلبات المجمعة.

curl --request GET  \
     --url 'https://api.immersive-fox.com/v1/voice/personalized_voices/' \
     --header 'X-Api-Key: <your-api-key>' \
     --header 'Content-Type: application/json'
[
    {
        "id": 2,
        "language": "Afrikaans",
        "supported_languages": [
            {
                "name": "Greek",
                "language_code": "el-GR"
            },
            {
                "name": "Russian",
                "language_code": "ru-RU"
            }
        ],
        "label": "👤 My voice",
        "default_language": "en-US",
        "gender": "Male",
        "audio_id": "QqH3AY53vGZpD1HCthXE",
        "user": 31,
        "voice_service_name": "resemble_audio"
    }
]

التحقق من حالة الصوت المُخصَّص:

للتحقق من حالة الصوت المُخصَّص المُولَّد، يُرجى إدخال المعرف في طلبك. سيتم تضمين حالة عملية توليد الصوت في الرد أسفل حقل الحالة. استخدم هذه المعلومات لمراقبة التقدم وتحديد حالة اكتمال صوتك المُخصَّص.

curl --request GET \
    --url 'https://api.immersive-fox.com/v1/voice/status/<voice_id>' \
    --header 'X-Api-Key: <your-api-key>' \
    --header 'Content-Type: application/json'
{
    "id": 2,
    "language": "Afrikaans",
    "supported_languages": [
        {
            "name": "Greek",
            "language_code": "el-GR"
        },
        {
            "name": "Russian",
            "language_code": "ru-RU"
        }
    ],
    "label": "👤 My voice",
    "default_language": "en-US",
    "gender": "Female",
    "audio_id": "QqH3AY53vGZpD1HCthXE",
    "user": 31,
    "status": "Completed",
    "voice_service_name": "resemble_audio"
}