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

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

الموارد (الصور، الفيديوهات) التي يتم إنشاؤها بواسطة واجهة 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.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.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.vidnoz.com/system/openapi/sample/talking-photo.jpg"' \
                  --form 'type="Input your text here"' \
                  --form 'file="YmUxSTFBcVA1V1A3N2Y3L2hxMHhGQT09"' \
                  --form 'file_url="https://static.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.vidnoz.com/system/openapi/sample/talking-photo.jpg"' \
                  --form 'type="YmUxSTFBcVA1V1A3N2Y3L2hxMHhGQT09"' \
                  --form 'file="YmUxSTFBcVA1V1A3N2Y3L2hxMHhGQT09"' \
                  --form 'file_url="https://static.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": "https://r2-aivid-002-test.214dcedd27630abef236dcb67de0ce92.r2.cloudflarestorage.com/1328/asset/202412/204867612a0e51e4b2.55156474.mp4?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=91ac9d3ee865be05c575d38c9bdd1275%2F20241217%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20241217T073646Z&X-Amz-SignedHeaders=host&X-Amz-Expires=259200&X-Amz-Signature=c8e0bc699c4a3532052322d6994e6de3558ff4de994bf971d37ca3bd1a14c119",
                    "video_720p": {
                        "key": "1328/asset/202412/204867612a0e51e4b2.55156474.mp4",
                        "url": "https://r2-aivid-002-test.214dcedd27630abef236dcb67de0ce92.r2.cloudflarestorage.com/1328/asset/202412/204867612a0e51e4b2.55156474.mp4?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=91ac9d3ee865be05c575d38c9bdd1275%2F20241217%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20241217T073646Z&X-Amz-SignedHeaders=host&X-Amz-Expires=259200&X-Amz-Signature=c8e0bc699c4a3532052322d6994e6de3558ff4de994bf971d37ca3bd1a14c119",
                        "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.vidnoz.com/system/asset/202309/65040c1b9027e.png",
                        "preview_audio_url": "https://static.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.vidnoz.com/system/asset/202308/64d9fcf847f1c.png",
                        "preview_audio_url": "https://static.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": "https://r2-aiautodelete-000-test.214dcedd27630abef236dcb67de0ce92.r2.cloudflarestorage.com/temporary/20241217/1328/1734417109904-a9c51522-05d1-afbf-20ab-a2b14489075c.png?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=91ac9d3ee865be05c575d38c9bdd1275%2F20241217%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20241217T063150Z&X-Amz-SignedHeaders=host&X-Amz-Expires=259200&X-Amz-Signature=1c26423fa21b17c9b537aafe054907c6f860f2bc82b8164c713522de8577f7a3"
                },
                {
                    "img_key": "temporary/20241217/1328/1734417112762-1ed846fb-5984-b695-a32b-454e74034a5a.png",
                    "img_url": "https://r2-aiautodelete-000-test.214dcedd27630abef236dcb67de0ce92.r2.cloudflarestorage.com/temporary/20241217/1328/1734417112762-1ed846fb-5984-b695-a32b-454e74034a5a.png?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=91ac9d3ee865be05c575d38c9bdd1275%2F20241217%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20241217T063152Z&X-Amz-SignedHeaders=host&X-Amz-Expires=259200&X-Amz-Signature=867d38fb6beea6eb515bfc4009abeae72558c740c921885f06025b244303352c"
                }
              ]
            }
}

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

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

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

مثال

{
        "additional_data": {
            "key": "1328/asset/202412/778367614047027e53.54679129.wav",
            "url": "https://r2-aivid-002-test.214dcedd27630abef236dcb67de0ce92.r2.cloudflarestorage.com/1328/asset/202412/778367614047027e53.54679129.wav?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=91ac9d3ee865be05c575d38c9bdd1275%2F20241217%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20241217T091135Z&X-Amz-SignedHeaders=host&X-Amz-Expires=259200&X-Amz-Signature=9c5b9ad894ff5f9f6d01e198a4ad151a8f0ad280268c2002841b0fa899f68524",
            "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": "https://r2-aivid-002-test.214dcedd27630abef236dcb67de0ce92.r2.cloudflarestorage.com/1328/asset/202412/945567613c44999c14.58089446.mp4?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=91ac9d3ee865be05c575d38c9bdd1275%2F20241217%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20241217T085428Z&X-Amz-SignedHeaders=host&X-Amz-Expires=259200&X-Amz-Signature=169384474e25a0a7eac1ac953c30d3279e54cfbe29cb0d142ce4b124e7a676c7",
      "video_720p": {
        "key": "1328/asset/202412/945567613c44999c14.58089446.mp4",
        "url": "https://r2-aivid-002-test.214dcedd27630abef236dcb67de0ce92.r2.cloudflarestorage.com/1328/asset/202412/945567613c44999c14.58089446.mp4?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=91ac9d3ee865be05c575d38c9bdd1275%2F20241217%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20241217T085428Z&X-Amz-SignedHeaders=host&X-Amz-Expires=259200&X-Amz-Signature=169384474e25a0a7eac1ac953c30d3279e54cfbe29cb0d142ce4b124e7a676c7",
        "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": "https://r2-aiautodelete-000-test.214dcedd27630abef236dcb67de0ce92.r2.cloudflarestorage.com/2828/asset/202412/200081156_image_0.jpg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=91ac9d3ee865be05c575d38c9bdd1275%2F20241217%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20241217T104051Z&X-Amz-SignedHeaders=host&X-Amz-Expires=259200&X-Amz-Signature=59a2c35fea0bf13aba0b646392cd16065928eb92c28f8bd8f2fa83335ac54996",
          "image_size": 26724
        },
        {
          "image_key": "2828/asset/202412/200081156_image_1.jpg",
          "image_url": "https://r2-aiautodelete-000-test.214dcedd27630abef236dcb67de0ce92.r2.cloudflarestorage.com/2828/asset/202412/200081156_image_1.jpg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=91ac9d3ee865be05c575d38c9bdd1275%2F20241217%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20241217T104053Z&X-Amz-SignedHeaders=host&X-Amz-Expires=259200&X-Amz-Signature=39a6ff498b6369f38dc257b0d1e5d6bdeb6442040125107f20c651133feb3d10",
          "image_size": 26724
        },
        {
          "image_key": "2828/asset/202412/200081156_image_2.jpg",
          "image_url": "https://r2-aiautodelete-000-test.214dcedd27630abef236dcb67de0ce92.r2.cloudflarestorage.com/2828/asset/202412/200081156_image_2.jpg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=91ac9d3ee865be05c575d38c9bdd1275%2F20241217%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20241217T104055Z&X-Amz-SignedHeaders=host&X-Amz-Expires=259200&X-Amz-Signature=77bf81c922bbc00c71a75bc6100e4a459ccf5da51d4ab50134457b8d67293ebb",
          "image_size": 26831
        },
        {
          "image_key": "2828/asset/202412/200081156_image_3.jpg",
          "image_url": "https://r2-aiautodelete-000-test.214dcedd27630abef236dcb67de0ce92.r2.cloudflarestorage.com/2828/asset/202412/200081156_image_3.jpg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=91ac9d3ee865be05c575d38c9bdd1275%2F20241217%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20241217T104057Z&X-Amz-SignedHeaders=host&X-Amz-Expires=259200&X-Amz-Signature=4bf4692e19d4d1ad9a7ad6022eafabece2cc302559dbe2a28a73bd6356da2a17",
          "image_size": 26831
        }
      ]
}
}