अवतार निर्माण
यह API गाइड हमारे प्लेटफ़ॉर्म पर अवतार बनाने का अवलोकन प्रदान करता है।
आप सभी डिफ़ॉल्ट अवतारों और व्यक्तिगत अवतारों की सूची देख सकते हैं और उनकी स्थिति देख सकते हैं। प्रगति की निगरानी के लिए अवतार 'id' का उपयोग करें, क्योंकि निर्माण प्रक्रिया में कुछ समय लग सकता है। एक बार तैयार होने के बाद, आप इन अवतारों का उपयोग वीडियो बनाने के लिए कर सकते हैं, व्यक्तिगत अवतार सुविधाओं के साथ अपनी सामग्री को बढ़ा सकते हैं। 🦊
त्वरित आरंभ
आइए गोता लगाएँ और जानें कि हमारे प्लेटफ़ॉर्म पर तत्काल और प्रीमियम अवतार कैसे बनाएं।
तत्काल अवतार बनाएं
एक तत्काल अवतार आपके द्वारा प्रदान की गई तस्वीर से जल्दी से उत्पन्न होता है, जो अवतार बनाने का एक तेज़ तरीका प्रदान करता है। तत्काल अवतार बनाने के लिए, आपको एक तस्वीर प्रदान करनी होगी जो इन दिशानिर्देशों का पालन करती हो, क्योंकि अवतार की गुणवत्ता पूरी तरह से प्रदान की गई तस्वीर पर निर्भर करती है। तत्काल अवतार निर्माण के लिए API से अनुरोध करें। प्रतिक्रिया में, 'id' वह मुख्य तत्व है जिसका उपयोग आप बल्क वीडियो अनुरोध के लिए करेंगे। 'थंबनेल' नए बनाए गए अवतार का पूर्वावलोकन प्रदान करता है, जिससे आप उपयोग करने से पहले इसकी समीक्षा कर सकते हैं। प्रतिक्रिया में 'नाम', 'लिंग', और 'उपयोगकर्ता' जैसे अतिरिक्त विवरण भी शामिल किए जाएँगे। अवतार स्थिति की जाँच करने के लिए अवतार स्थिति api का उपयोग करें।
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'
{
"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
}
प्रीमियम अवतार बनाएँ
एक प्रीमियम अवतार एक वीडियो से बनाया जाता है, जिसके परिणामस्वरूप अधिक यथार्थवादी और विस्तृत प्रतिनिधित्व होता है। हमारे API का उपयोग करके प्रीमियम अवतार बनाने के लिए, इन चरणों का पालन करें:
- पूर्व-हस्ताक्षरित URL का अनुरोध करें:
सबसे पहले, अपलोड किए जाने वाले वीडियो के लिए फ़ाइल एक्सटेंशन (जैसे,
.mp4) निर्दिष्ट करके पूर्व-हस्ताक्षरित URL जनरेशन एंडपॉइंट से पूर्व-हस्ताक्षरित URL और संबंधित वीडियो फ़ाइल नामों का अनुरोध करें। प्रतिक्रिया दो पूर्व-हस्ताक्षरित 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 का उपयोग करके वीडियो अपलोड करें:
प्रीमियम अवतार बनाने के लिए, आपको एक बोलने वाला वीडियो अपलोड करना होगा, जबकि अवतार की गुणवत्ता में सुधार के लिए मूक वीडियो वैकल्पिक है। कृपया सुनिश्चित करें कि दोनों वीडियो दिए गए दिशानिर्देशों का पालन करते हैं। पिछले चरण में आपको जो 'presigned_url' मिलता है, उसके साथ PUT विधि का उपयोग करें, जो 30 मिनट के लिए वैध है। वीडियो फ़ाइलों को इस समय सीमा के भीतर सीधे 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'
```
{
}
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'
{
}
- अवतार निर्माण अनुरोध भेजें:
वीडियो अपलोड करने के बाद, प्रीमियम अवतार बनाने के लिए पूर्व-हस्ताक्षरित URL अनुरोध से प्राप्त 'फ़ाइल_नाम' का उपयोग करें। प्रतिक्रिया में नए बनाए गए प्रीमियम अवतार की 'आईडी' शामिल होगी, जिसका उपयोग बाद के बल्क वीडियो अनुरोध के लिए किया जाएगा। इसके अतिरिक्त, प्रतिक्रिया एक 'थंबनेल' प्रदान करेगी जो अवतार का पूर्वावलोकन है, साथ ही 'जनरेशन समय', 'नाम', 'लिंग', और अन्य प्रासंगिक जानकारी जैसे विवरण भी प्रदान करेगी। अवतार स्थिति की जाँच करने के लिए अवतार स्थिति 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'
```
{
"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
}