احصل على 30 نقطة مجاني كل يوم - انشاء فيديو الذكاء الاصطناعي الخاص بك الآن!

×
أدوات الذكاء الاصطناعي

أفاتار التتكلم

الموارد (الصور، الفيديوهات) التي يتم إنشاؤها بواسطة واجهة API الخاصة بنا صالحة لمدة 7 أيام. يُرجى حفظ الموارد ذات الصلة في أسرع وقت ممكن لتجنب انتهاء صلاحيتها.

بناء معاينة 

POST https://devapi.vidnoz.com/v2/task/preview

رؤوس الطلب

المعلمة مطلوب النوع الوصف
Content-Type true string نوع نقل البيانات: multipart/form-data

سمات الطلب

1. استخدام الصوت المحدد مسبقًا

المعلمة مطلوب النوع الوصف
voice_id true string معرف قائمة الأصوات (يفضل voice_id)
text true string محتوى النص

2. استخدام الصوت المستنسخ

المعلمة مطلوب النوع الوصف
lang true string اللغة (يدعم وضع الاستنساخ الإنجليزية، الصينية التقليدية، الكورية، اليابانية فقط)
file false file الصوت الأصلي المرفوع (الأولوية تُعطى لهذا الحقل). هناك طريقتان مدعومتان لرفع الصوت.
file_url false string عنوان الصوت الأصلي. هناك طريقتان مدعومتان لرفع الصوت.
text true string محتوى النص

سمات الاستجابة

المعلمة النوع الوصف
code int 200
message string ملاحظات المهمة
data obj كائن المهمة
data.task_id string معرف المهمة

مثال

سمات الطلب

1. استخدام الصوت المحدد مسبقًا 


                  curl  --request POST \
                  --url https://devapi.vidnoz.com/v2/task/preview \
                  --header "accept: application/json" \
                  --header "content-type: multipart/form-data" \
                  --header "Authorization: Bearer $API_KEY" \
                  --form 'voice_id="YmUxSTFBcVA1V1A3N2Y3L2hxMHhGQT09"' \
                  --form 'text="Input your text here"' \

2. استخدام الصوت المستنسخ 


                  curl  --request POST \
                  --url https://devapi.vidnoz.com/v2/task/preview \
                  --header "accept: application/json" \
                  --header "content-type: multipart/form-data" \
                  --header "Authorization: Bearer $API_KEY" \
                  --form 'lang="en"' \
                  --form 'file="YmUxSTFBcVA1V1A3N2Y3L2hxMHhGQT09"' \
                  --form 'file_url="https://static-alter1.vidnoz.com/system/openapi/sample/audio-Cora.wav"' \
                  --form 'text="Input your text here"' \

سمات الاستجابة 

{
            "code": 200,
            "message": "ok",
            "data": {
                "task_id": "T2hzVGJ5dWhaSUxSSUJqSzZORUdpUT09"
            }
}

بعد ذلك، يمكنك الاستعلام عن حالة المهمة والحصول على بيانات المهمة من خلال واجهة المهمة/التفاصيل.

إنشاء فيديو مع صورة متحدثة 

POST https://devapi.vidnoz.com/v2/task/generate-talking-head

رؤوس الطلب

المعلمة مطلوب النوع الوصف
Content-Type true string نوع نقل البيانات: multipart/form-data

سمات الطلب

1. توليف الصوت باستخدام الصوت المحدد مسبقًا

المعلمة مطلوب النوع الوصف
voice_id true string معرف قائمة الأصوات (يفضل voice_id)
text true string محتوى النص
type true int 0:الصوت المحدد مسبقًا
avatar false file الصورة الأصلية للأفاتار المرفوعة (الأولوية تُعطى لهذا الحقل). هناك طريقتان مدعومتان لرفع صور الأفاتار. التنسيقات المدعومة: JPG، PNG، JPEG، WebP
avatar_url false string الصورة الأصلية للأفاتار المرفوعة. هناك طريقتان مدعومتان لرفع صور الأفاتار. التنسيقات المدعومة: JPG، PNG، JPEG، WebP

2. توليف الصوت باستخدام الصوت المستنسخ

المعلمة مطلوب النوع الوصف
text true string محتوى النص
style false string العاطفة الافتراضية طبيعية
lang true string محتوى النص
avatar false file الصورة الأصلية للأفاتار المرفوعة (الأولوية تُعطى لهذا الحقل). هناك طريقتان مدعومتان لرفع صور الأفاتار. التنسيقات المدعومة: JPG، PNG، JPEG، WebP
avatar_url false string الصورة الأصلية للأفاتار المرفوعة. هناك طريقتان مدعومتان لرفع صور الأفاتار. التنسيقات المدعومة: JPG، PNG، JPEG، WebP
type true int 1:الصوت المستنسخ
file false file ملف الصوت الأصلي المرفوع (الأولوية تُعطى لهذا الحقل). هناك طريقتان مدعومتان لرفع ملفات الصوت. التنسيقات المدعومة: WAV، MP3، MP4، AAC، WebM (بحد أقصى 200 ميجابايت)
file_url false string ملف الصوت الأصلي المرفوع. هناك طريقتان مدعومتان لرفع ملفات الصوت. التنسيقات المدعومة: WAV، MP3، MP4، AAC، WebM (بحد أقصى 200 ميجابايت)

3. رفع ملفات الصوت مباشرة

المعلمة مطلوب النوع الوصف
avatar false file الصورة الأصلية للأفاتار المرفوعة (الأولوية تُعطى لهذا الحقل). هناك طريقتان مدعومتان لرفع صور الأفاتار. التنسيقات المدعومة: JPG، PNG، JPEG، WebP
avatar_url false string الصورة الأصلية للأفاتار المرفوعة. هناك طريقتان مدعومتان لرفع صور الأفاتار. التنسيقات المدعومة: JPG، PNG، JPEG، WebP
type true int 2:رفع الصوت
file false file ملف الصوت الأصلي المرفوع (الأولوية تُعطى لهذا الحقل). هناك طريقتان مدعومتان لرفع ملفات الصوت. التنسيقات المدعومة: WAV، MP3، MP4، AAC، WebM (بحد أقصى 200 ميجابايت)
file_url false string ملف الصوت الأصلي المرفوع. هناك طريقتان مدعومتان لرفع ملفات الصوت. التنسيقات المدعومة: WAV، MP3، MP4، AAC، WebM (بحد أقصى 200 ميجابايت)

سمات الاستجابة

المعلمة النوع الوصف
code int 200
message string ملاحظات المهمة
data obj كائن المهمة
data.task_id string معرف المهمة

مثال

سمات الطلب

1. توليف الصوت باستخدام الصوت المحدد مسبقًا 


                  curl  --request POST \
                  --url https://devapi.vidnoz.com/v2/task/generate-talking-head \
                  --header "accept: application/json" \
                  --header "content-type: multipart/form-data" \
                  --header "Authorization: Bearer $API_KEY" \
                  --form 'voice_id="YmUxSTFBcVA1V1A3N2Y3L2hxMHhGQT09"' \
                  --form 'text="Input your text here"' \
                  --form 'avatar="YmUxSTFBcVA1V1A3N2Y3L2hxMHhGQT09"' \
                  --form 'avatar_url="https://static-alter1.vidnoz.com/system/openapi/sample/talking-photo.jpg"' \

2. توليف الصوت باستخدام الصوت المستنسخ 


                  curl  --request POST \
                  --url https://devapi.vidnoz.com/v2/task/generate-talking-head \
                  --header "accept: application/json" \
                  --header "content-type: multipart/form-data" \
                  --header "Authorization: Bearer $API_KEY" \
                  --form 'text="Input your text here"' \
                  --form 'lang="en"' \
                  --form 'avatar="YmUxSTFBcVA1V1A3N2Y3L2hxMHhGQT09"' \
                  --form 'avatar_url="https://static-alter1.vidnoz.com/system/openapi/sample/talking-photo.jpg"' \
                  --form 'type="Input your text here"' \
                  --form 'file="YmUxSTFBcVA1V1A3N2Y3L2hxMHhGQT09"' \
                  --form 'file_url="https://static-alter1.vidnoz.com/system/openapi/sample/audio-Cora.wav"' \

3. رفع ملفات الصوت مباشرة 


                  curl  --request POST \
                  --url https://devapi.vidnoz.com/v2/task/generate-talking-head \
                  --header "accept: application/json" \
                  --header "content-type: multipart/form-data" \
                  --header "Authorization: Bearer $API_KEY" \
                  --form 'text="Input your text here"' \
                  --form 'lang="en"' \
                  --form 'avatar="YmUxSTFBcVA1V1A3N2Y3L2hxMHhGQT09"' \
                  --form 'avatar_url="https://static-alter1.vidnoz.com/system/openapi/sample/talking-photo.jpg"' \
                  --form 'type="YmUxSTFBcVA1V1A3N2Y3L2hxMHhGQT09"' \
                  --form 'file="YmUxSTFBcVA1V1A3N2Y3L2hxMHhGQT09"' \
                  --form 'file_url="https://static-alter1.vidnoz.com/system/openapi/sample/audio-Cora.wav"' \

سمات الاستجابة 

{
            "code": 200,
            "message": "",
            "data": {
                "id": 200080893,
                "message": "",
                "status": 0,
                "additional_data": {
                    "key": "1328/asset/202412/204867612a0e51e4b2.55156474.mp4",
                    "url": "",
                    "video_720p": {
                        "key": "1328/asset/202412/204867612a0e51e4b2.55156474.mp4",
                        "url": "",
                        "video_size": 1072200,
                        "video_duration": 13.6
                    },
                "video_size": 1072200,
                "video_duration": 13.6
            },
            "user_id": 1328
    }
}

بعد ذلك، يمكنك الاستعلام عن حالة المهمة والحصول على بيانات المهمة من خلال واجهة المهمة/التفاصيل.

الحصول على قائمة الأصوات الرسمية 

GET https://devapi.vidnoz.com/v2/voice/list

سمات الاستجابة

المعلمة النوع الوصف
voices array قائمة الأصوات.
voices.voice_id string المعرف الفريد للصوت.
voices.name string اسم الصوت.
voices.country_name string اسم الدولة.
voices.country_icon_url string عنوان الرابط لأيقونة الدولة.
voices.preview_audio_url string عنوان الرابط لمعاينة الصوت.
voices.gender string الجنس المرتبط بالصوت: ذكر، أنثى، غير معروف.
voices.language string لغة الصوت.
voices.style_list array قائمة المشاعر المتاحة.
voices.words_per_minute string معرف المهمة

مثال

سمات الاستجابة 

{
            "code": 200,
            "message": "ok",
            "data": {
                "voices": [
                    {
                        "voice_id": "M084TEhqTlFkdE8wRUxvRXFoVWlRdz09",
                        "name": "es-ES-Neural2-A",
                        "country_name": "Spanish(ES)",
                        "country_icon_url": "https://static-alter1.vidnoz.com/system/asset/202309/65040c1b9027e.png",
                        "preview_audio_url": "https://static-alter1.vidnoz.com/designer/asset/202407/9519669f4ae45e1639.54065252.mp3",
                        "gender": "female",
                        "language": "es",
                        "style_list": [
                        "normal",
                        "cheerful",
                        "chat"
                        ]
                       "words_per_minute": null
                    },
                    {
                        "voice_id": "Rm5wL2NLWjY4SGlqSVFMLzF5WXFJUT09",
                        "name": "Celeste",
                        "country_name": "French(FR)",
                        "country_icon_url": "https://static-alter1.vidnoz.com/system/asset/202308/64d9fcf847f1c.png",
                        "preview_audio_url": "https://static-alter1.vidnoz.com/designer/asset/202312/9469658d2b7f223131.32142677.wav",
                        "gender": "female",
                        "language": "fr",
                        "style_list": [
                        "normal"
                        ],
                        "words_per_minute": "155"
                    }
                  ]
            }

}

الوصول إلى تفاصيل المهمة 

POST https://devapi.vidnoz.com/v2/task/detail

سمات الطلب

المعلمة مطلوب النوع الوصف
id true string معرف المهمة

سمات الاستجابة

المعلمة النوع الوصف
id int معرف المهمة
message int معلومات المهمة.
status int الحالة الحالية للمهمة -1: لم تُنفذ؛ -2: قيد التنفيذ.
additional_data json إنشاء النتائج؛ انظر التفاصيل أدناه.

مثال

سمات الطلب 


                  curl  --request POST \
                  --url https://devapi.vidnoz.com/v2/task/detail \
                  --header "accept: application/json" \
                  --header "content-type: multipart/form-data" \
                  --header "Authorization: Bearer $API_KEY" \
                  --form 'id="YmUxSTFBcVA1V1A3N2Y3L2hxMHhGQT09"' \

سمات الاستجابة 

{
            "code": 200,
            "message": "ok",
            "data": {
                "id": 106927142,
                "message": "",
                "status": 0,
                "additional_data": {}
            }
}

1.ai_headshot

سمات الاستجابة

المعلمة النوع الوصف
img_key string مفتاح الملف المُنشأ
img_url string عنوان الرابط للملف المُنشأ.

مثال 

{
          "additional_data": [
                {
                    "img_key": "temporary/20241217/1328/1734417109904-a9c51522-05d1-afbf-20ab-a2b14489075c.png",
                    "img_url": ""
                },
                {
                    "img_key": "temporary/20241217/1328/1734417112762-1ed846fb-5984-b695-a32b-454e74034a5a.png",
                    "img_url": ""
                }
              ]
            }
}

2.معاينة الصورة التتكلم

سمات الاستجابة

المعلمة النوع الوصف
key int حجم الفيديو المُنشأ.
url float طول الفيديو المُنشأ.
subtitles bool ممع الترجمات أم بدون
audio_size string حجم الصوت المُنشأ.
audio_duration float مدة الصوت المُنشأ.

مثال 

{
        "additional_data": {
            "key": "1328/asset/202412/778367614047027e53.54679129.wav",
            "url": "",
            "subtitles": null,
            "audio_size": 1177662,
            "audio_duration": 13.351519
        }
            }
}

3.إنشاء الفيديوهات

سمات الاستجابة

المعلمة النوع الوصف
key string مفتاح الفيديو المُنشأ.
url string عنوان الرابط للفيديو المُنشأ.
video_720p obj تم إنشاء معلومات الفيديو بدقة 720 بكسل، أو لا شيء إذا لم يكن هناك فيديو بهذا التعريف.
video_720p.key string مفتاح معلومات الفيديو المُنشأ بدقة 720p.
video_720p.url string عنوان الرابط لمعلومات الفيديو المُنشأ بدقة 720p.
video_720p.video_size int حجم معلومات الفيديو المُنشأ بدقة 720p.
video_720p.video_duration float مدة معلومات الفيديو المُنشأ بدقة 720p.
video_size int حجم معلومات الفيديو المُنشأ.
video_duration float مدة معلومات الفيديو المُنشأ.

مثال 

{
    "additional_data":{
      "key": "1328/asset/202412/945567613c44999c14.58089446.mp4",
      "url": "",
      "video_720p": {
        "key": "1328/asset/202412/945567613c44999c14.58089446.mp4",
        "url": "",
        "video_size": 1146957,
        "video_duration": 15.84
      },
      "video_size": 1146957,
      "video_duration": 15.84
}
}

4.تحويل النص الى الصورة

سمات الاستجابة

المعلمة النوع الوصف
images array مجموعة الصور المُنشأة.
image_key string مفتاح الصورة المُنشأة.
image_url string عنوان الرابط للصورة المُنشأة.
image_size int حجم الصورة المُنشأة.

مثال 

{
    "additional_data":{
       "images": [
        {
          "image_key": "2828/asset/202412/200081156_image_0.jpg",
          "image_url": "",
          "image_size": 26724
        },
        {
          "image_key": "2828/asset/202412/200081156_image_1.jpg",
          "image_url": "",
          "image_size": 26724
        },
        {
          "image_key": "2828/asset/202412/200081156_image_2.jpg",
          "image_url": "",
          "image_size": 26831
        },
        {
          "image_key": "2828/asset/202412/200081156_image_3.jpg",
          "image_url": "",
          "image_size": 26831
        }
      ]
}
}