Profitez chaque jour d'une création vidéo IA de 1 minutes, entièrement gratuite.

 Foncez vite !
×
Outils IA

Avatar parlant

Les ressources (image, vidéo) générées par notre API sont valides pendant 7 jours. Veuillez enregistrer les ressources pertinentes dès que possible pour éviter leur expiration.

Construire l'aperçu 

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

En-têtes de la requête

Paramètre Requis Type Description
Content-Type true string Type de transmission des données : multipart/form-data

Attributs de la requête

1. Utiliser la voix prédéfinie

Paramètre Requis Type Description
voice_id true string ID de la liste des voix (le voice_id est préféré)
text true string Contenu du texte

2. Utiliser la voix clonée

Paramètre Requis Type Description
lang true string Langue (le mode de clonage ne prend en charge que l'anglais, le chinois traditionnel, le coréen et le japonais)
file false file Audio original téléchargé (la priorité est donnée à ce champ). Deux méthodes sont prises en charge pour télécharger des audios.
file_url false string Adresse de l'audio original. Deux méthodes sont prises en charge pour télécharger des audios.
text true string Contenu du texte

Attributs de la réponse

Paramètre Type Description
code int 200
message string Remarque sur la tâche
data obj Objet de la tâche
data.task_id string ID de la tâche

Exemple

Attributs de la requête

1. Utiliser la voix prédéfinie 


                  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. Utiliser la voix clonée 


                  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"' \

Attributs de la réponse 

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

Ensuite, vous pouvez interroger le statut de la tâche et obtenir les données de la tâche via l'interface task/detail.

Générer une vidéo de photo parlante 

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

En-têtes de la requête

Paramètre Requis Type Description
Content-Type true string Type de transmission des données : multipart/form-data

Attributs de la requête

1. Synthétiser l'audio avec la voix prédéfinie

Paramètre Requis Type Description
voice_id true string ID de la liste des voix (le voice_id est préféré)
text true string Contenu du texte
type true int 0:Voix prédéfinie
avatar false file Image de l'avatar original téléchargée (la priorité est donnée à ce champ). Deux méthodes sont prises en charge pour télécharger des images d'avatar. Formats pris en charge : JPG, PNG, JPEG, WebP
avatar_url false string Image de l'avatar original téléchargée. Deux méthodes sont prises en charge pour télécharger des images d'avatar. Formats pris en charge : JPG, PNG, JPEG, WebP

2. Synthétiser l'audio avec la voix clonée

Paramètre Requis Type Description
text true string Contenu du texte
style false string Émotion par défaut normale
lang true string Contenu du texte
avatar false file Image de l'avatar original téléchargée (la priorité est donnée à ce champ). Deux méthodes sont prises en charge pour télécharger des images d'avatar. Formats pris en charge : JPG, PNG, JPEG, WebP
avatar_url false string Image de l'avatar original téléchargée. Deux méthodes sont prises en charge pour télécharger des images d'avatar. Formats pris en charge : JPG, PNG, JPEG, WebP
type true int 1:Voix clonée
file false file Fichier audio original téléchargé (la priorité est donnée à ce champ). Deux méthodes sont prises en charge pour télécharger des fichiers audio. Formats pris en charge : WAV, MP3, MP4, AAC, WebM Maximum 200M
file_url false string Fichier audio original téléchargé. Deux méthodes sont prises en charge pour télécharger des fichiers audio. Formats pris en charge : WAV, MP3, MP4, AAC, WebM (Maximum 200M).

3. Télécharger des fichiers audio directement

Paramètre Requis Type Description
avatar false file Image de l'avatar original téléchargée (la priorité est donnée à ce champ). Deux méthodes sont prises en charge pour télécharger des images d'avatar. Formats pris en charge : JPG, PNG, JPEG, WebP
avatar_url false string Image de l'avatar original téléchargée. Deux méthodes sont prises en charge pour télécharger des images d'avatar. Formats pris en charge : JPG, PNG, JPEG, WebP
type true int 2:Télécharger l'audio
file false file Fichier audio original téléchargé (la priorité est donnée à ce champ). Deux méthodes sont prises en charge pour télécharger des fichiers audio. Formats pris en charge : WAV, MP3, MP4, AAC, WebM Maximum 200M
file_url false string Fichier audio original téléchargé. Deux méthodes sont prises en charge pour télécharger des fichiers audio. Formats pris en charge : WAV, MP3, MP4, AAC, WebM (Maximum 200M).

Attributs de la réponse

Paramètre Type Description
code int 200
message string Remarque sur la tâche
data obj Objet de la tâche
data.task_id string ID de la tâche

Exemple

Attributs de la requête

1. Synthétiser l'audio avec la voix prédéfinie 


                  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. Synthétiser l'audio avec la voix clonée 


                  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. Télécharger des fichiers audio directement 


                  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"' \

Attributs de la réponse 

{
            "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
    }
}

Ensuite, vous pouvez interroger le statut de la tâche et obtenir les données de la tâche via l'interface task/detail.

Obtenir la liste officielle des voix 

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

Attributs de la réponse

Paramètre Type Description
voices array Liste des voix.
voices.voice_id string Identifiant unique de la voix.
voices.name string Nom de la voix.
voices.country_name string Nom du pays,
voices.country_icon_url string URL de l'icône du pays.
voices.preview_audio_url string URL de l'aperçu de la voix.
voices.gender string Genre associé à la voix : masculin, féminin, inconnu.
voices.language string Langue de la voix.
voices.style_list array Liste des émotions disponibles.
voices.words_per_minute string ID de la tâche

Exemple

Attributs de la réponse 

{
            "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"
                    }
                  ]
            }

}

Accéder aux détails de la tâche 

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

Attributs de la requête

Paramètre Requis Type Description
id true string ID de la tâche

Attributs de la réponse

Paramètre Type Description
id int ID de la tâche
message int Informations sur la tâche.
status int Le statut actuel de la tâche -1 : non exécutée ; -2 : en cours d'exécution.
additional_data json Résultats générés ; voir les détails ci-dessous.

Exemple

Attributs de la requête 


                  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"' \

Attributs de la réponse 

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

1. Portrait IA

Attributs de la réponse

Paramètre Type Description
img_key string Clé du fichier généré
img_url string URL du fichier généré.

Exemple 

{
          "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. Aperçu de la photo parlante

Attributs de la réponse

Paramètre Type Description
key int Taille de la vidéo générée.
url float Durée de la vidéo générée.
subtitles bool Sous-titrée ou non
audio_size string Taille de l'audio généré.
audio_duration float Durée de l'audio généré.

Exemple 

{
        "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. Générer des vidéos

Attributs de la réponse

Paramètre Type Description
key string Clé de la vidéo générée.
url string URL de la vidéo générée.
video_720p obj Informations sur la vidéo générée en 720p, ou null s'il n'y a pas de vidéo de cette définition.
video_720p.key string Clé des informations vidéo générées en 720p.
video_720p.url string URL des informations vidéo générées en 720p.
video_720p.video_size int Taille des informations vidéo générées en 720p.
video_720p.video_duration float Durée des informations vidéo générées en 720p.
video_size int Taille des informations vidéo générées.
video_duration float Durée des informations vidéo générées.

Exemple 

{
    "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. Texte en image

Attributs de la réponse

Paramètre Type Description
images array Tableau des images générées.
image_key string Clé de l'image générée.
image_url string URL de l'image générée.
image_size int Taille de l'image générée.

Exemple 

{
    "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
        }
      ]
}
}