إنشاء الصورة الرمزية
يوفر دليل واجهة برمجة التطبيقات هذا نظرة عامة حول إنشاء الصور الرمزية على منصتنا.
يمكنك عرض قائمة بجميع الصور الرمزية الافتراضية والصور الرمزية المخصصة والتحقق من حالتها. استخدم الصورة الرمزية 'id' لمراقبة التقدم، حيث قد تستغرق عملية الإنشاء بعض الوقت. بمجرد أن تصبح جاهزة، يمكنك استخدام هذه الصور الرمزية لإنشاء مقاطع فيديو، مما يعزز المحتوى الخاص بك بميزات الصورة الرمزية المخصصة. 🦊
البدء
السريع دعنا نتعمق ونستكشف كيفية إنشاء صور رمزية فورية ومميزة على منصتنا.
إنشاء صورة
رمزية فورية يتم إنشاء صورة رمزية فورية بسرعة من صورة تقدمها، مما يوفر طريقة سريعة لإنشاء صورة رمزية. لإنشاء صورة رمزية فورية، يجب عليك تقديم صورة تلتزم بهذه الإرشادات، حيث تعتمد جودة الصورة الرمزية كليًا على الصورة المقدمة. قدم طلبًا إلى واجهة برمجة التطبيقات لإنشاء صورة رمزية فورية. تتضمن تنسيقات الصور المقبولة 'png' و 'jpeg'. أرسل الملف والبيانات الأخرى بتنسيق multipart/form-data مع المفاتيح المُعطاة في نموذج الطلب. في الرد، يُعدّ المعرّف (id) هو العنصر الرئيسي الذي ستستخدمه لطلب bulk video request. يُتيح لك المصغر (thumbnail) معاينة الصورة الرمزية المُنشأة حديثًا، مما يسمح لك بمراجعتها قبل الاستخدام. سيتم أيضًا تضمين تفاصيل إضافية مثل الاسم والجنس والمستخدم في الرد. استخدم حالة الصورة الرمزية (api)(avatar_listing.md) للتحقق من حالة الصورة الرمزية.
curl --request POST \
--url '<https://api.immersive-fox.com/v1/avatar_generation/create_instant_avatar/>' \
--header 'X-Api-Key: <your-api-key>' \
--header 'Content-Type: multipart/form-data' \
-F 'file=@my_image.png' \
-F 'name=John' \
-F 'gender=Male' \
-F 'remove_background=false'
javascript
{
"id": 839,
"thumbnail": "https://storage.googleapis.com/my_bucket_name/avatar_thumbnail/my_thumbnail.png",
"name": "Smith",
"gender": "Male",
"user": 31,
"remove_background": false,
"based_on": "Photo",
"has_hand_wave": false
"generation_time": 20
}
إنشاء صورة
رمزية مميزة. يتم إنشاء صورة رمزية مميزة من فيديو، مما ينتج عنه تمثيل أكثر واقعية وتفصيلاً. لإنشاء صورة رمزية مميزة باستخدام واجهة برمجة التطبيقات الخاصة بنا، اتبع الخطوات التالية:
- طلب عناوين URL مُوقّعة مسبقًا:
أولاً، اطلب عناوين URL المُوقّعة مسبقًا وأسماء ملفات الفيديو المقابلة من نقطة نهاية إنشاء عناوين URL المُوقّعة مسبقًا، وذلك بتحديد امتدادات الملفات (مثل .mp4) للفيديوهات المراد تحميلها. سيوفر الرد عنواني URL مُوقّعين مسبقًا - أحدهما للفيديو الصامت والآخر للفيديو المُتحدث - مما يسمح بالتحميل المباشر. بالإضافة إلى ذلك، سيتضمن الرد أسماء ملفات الفيديوين، والتي يجب إرسالها في الخطوة التالية لإنشاء الصورة الرمزية المميزة.
```bash
curl --request POST \
--url 'https://api.immersive-fox.com/v1/avatar_generation/premium_avatar_presigned_urls/' \
--header 'X-Api-Key: <your-api-key>' \
--header 'Content-Type: application/json' \
--header 'Content-Type: multipart/form-data' \
-F 'speaking_video_extention=.mp4' \
-F 'silent_video_extention=.mp4'
```
```json
{
"silent_video_data": {
"presigned_url": "https://premium-avatar-videos.s3.amazonaws.com/silent_videos/31_6f72a1900fd64969ab9f8df465f9e92c.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA6E6ARAOX65ONAQYP%2F20241002%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20241002T221000Z&X-Amz-Expires=1800&X-Amz-SignedHeaders=host&X-Amz-Signature=72058a2c206ba63726eeda2e88266575c046fa0625f9af1c366b4b9bf921b3ef",
"file_name": "31_6f72a1900fd64969ab9f8df465f9e92c.mp4"
},
"speaking_video_data": {
"presigned_url": "https://premium-avatar-videos.s3.amazonaws.com/speaking_videos/31_1e4eb799a3b84639a11c929a6729a1be.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA6E6ARAOX65ONAQYP%2F20241002%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20241002T221000Z&X-Amz-Expires=1800&X-Amz-SignedHeaders=host&X-Amz-Signature=58e84ccd7d702b64b3400479f27b417f551317ca96afce3e923ac18d9db28bce",
"file_name": "31_1e4eb799a3b84639a11c929a6729a1be.mp4"
}
}
```
- رفع الفيديوهات باستخدام عناوين URL مُوقّعة مسبقًا:
لإنشاء صورة رمزية مميزة، يجب عليك رفع فيديو ناطق، بينما يُعدّ الفيديو الصامت اختياريًا لتحسين جودة الصورة الرمزية. يُرجى التأكد من أن كلا الفيديوين يتبعان guidelines المُقدّمة. استخدم طريقة PUT مع 'presigned_url' التي حصلت عليها في الخطوة السابقة، وهي صالحة لمدة ٣٠ دقيقة. يجب رفع ملفات الفيديو كبيانات ثنائية مباشرةً إلى عناوين URL خلال هذه الفترة الزمنية.
```bash
curl --request PUT \
--url 'https://premium-avatar-videos.s3.amazonaws.com/speaking_videos/{file_name}?<presigned_url_parameters>' \
--header 'X-Api-Key: <your-api-key>' \
--header 'Content-Type: video/mp4' \
--data-binary '@speaking_video.mp4'
```
```json
{
}
```
```bash
curl --request PUT \
--url 'https://premium-avatar-videos.s3.amazonaws.com/silent_videos/{file_name}?<presigned_url_parameters>' \
--header 'X-Api-Key: <your-api-key>' \
--header 'Content-Type: video/mp4' \
--data-binary '@silent_video.mp4'
```
```json
{
}
```
- إرسال طلب إنشاء صورة رمزية:
بعد تحميل الفيديوهات، استخدم 'file_name' الذي تم الحصول عليه من طلب عنوان URL المُوقّع مسبقًا لإنشاء الصورة الرمزية المميزة. ستتضمن الاستجابة 'id' للصورة الرمزية المميزة المُنشأة حديثًا، والتي ستُستخدم في bulk video request اللاحقة. بالإضافة إلى ذلك، ستُقدّم الاستجابة 'thumbnail' وهي معاينة للصورة الرمزية، بالإضافة إلى تفاصيل مثل 'وقت الإنشاء'، 'الاسم'، 'الجنس'، ومعلومات أخرى ذات صلة. استخدم حالة الصورة الرمزية api للتحقق من حالة الصورة الرمزية.
```bash
curl --request POST \
--url 'https://api.immersive-fox.com/v1/avatar_generation/create_premium_avatar/' \
--header 'X-Api-Key: <your-api-key>' \
--header 'Content-Type: application/json' \
--header 'Content-Type: form-data' \
-F 'avatar_name=John' \
-F 'gender=Male' \
-F 'remove_background=false' \
-F 'silent_video_name=31_6f72a1900fd64969ab9f8df465f9e92c.mp4' \
-F 'speaking_video_name=31_1e4eb799a3b84639a11c929a6729a1be.mp4'
```
```bash
{
"id": 840,
"thumbnail": "https://storage.googleapis.com/my_bucket_name/avatar_thumbnail/my_thumbnail.png",
"name": "John",
"gender": "Male",
"user": 31,
"remove_background": true,
"based_on": "Video",
"has_hand_wave": false
"generation_time": 24
}
```