Strumenti AI

Avatar Parlante

Le risorse (immagine, video) generate dalla nostra API sono valide per 7 giorni. Si prega di salvare le risorse pertinenti il prima possibile per evitare la scadenza.

Costruisci anteprima

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

Intestazioni della Richiesta

Parametro	Richiesto	Tipo	Descrizione
Content-Type	true	string	Tipo di Trasmissione Dati: multipart/form-data

Attributi della Richiesta

1. Usa voce preimpostata

Parametro	Richiesto	Tipo	Descrizione
voice_id	true	string	ID della lista delle voci (voice_id è preferito)
text	true	string	Contenuto del testo

2. Usa voce clonata

Parametro	Richiesto	Tipo	Descrizione
lang	true	string	Lingua (la modalità Clone supporta solo Inglese, Cinese Tradizionale, Coreano, Giapponese)
file	false	file	Audio originale caricato (questo campo ha la priorità). Sono supportati due metodi per caricare gli audio.
file_url	false	string	Indirizzo audio originale. Sono supportati due metodi per caricare gli audio.
text	true	string	Contenuto del testo

Attributi della Risposta

Parametro	Tipo	Descrizione
code	int	200
message	string	Osservazioni del task
data	obj	Oggetto del task
data.task_id	string	ID del task

Esempio

Attributi della Richiesta

1. Usa voce preimpostata


                  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. Usa voce clonata


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

Attributi della Risposta

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

Successivamente puoi verificare lo stato del task e ottenere i dati del task tramite l'interfaccia task/detail.

Genera video foto parlante

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

Intestazioni della Richiesta

Parametro	Richiesto	Tipo	Descrizione
Content-Type	true	string	Tipo di Trasmissione Dati: multipart/form-data

Attributi della Richiesta

1. Sintesi audio con voce preimpostata

Parametro	Richiesto	Tipo	Descrizione
voice_id	true	string	ID della lista delle voci (voice_id è preferito)
text	true	string	Contenuto del testo
type	true	int	0:Voce preimpostata
avatar	false	file	Immagine avatar originale caricata (questo campo ha la priorità). Sono supportati due metodi per caricare le immagini degli avatar. Formati supportati: JPG, PNG, JPEG, WebP
avatar_url	false	string	Immagine avatar originale caricata. Sono supportati due metodi per caricare le immagini degli avatar. Formati supportati: JPG, PNG, JPEG, WebP

2. Sintesi audio con voce clonata

Parametro	Richiesto	Tipo	Descrizione
text	true	string	Contenuto del testo
style	false	string	Emozione predefinita normale
lang	true	string	Contenuto del testo
avatar	false	file	Immagine avatar originale caricata (questo campo ha la priorità). Sono supportati due metodi per caricare le immagini degli avatar. Formati supportati: JPG, PNG, JPEG, WebP
avatar_url	false	string	Immagine avatar originale caricata. Sono supportati due metodi per caricare le immagini degli avatar. Formati supportati: JPG, PNG, JPEG, WebP
type	true	int	1:Voce clonata
file	false	file	File audio originale caricato (questo campo ha la priorità). Sono supportati due metodi per caricare i file audio. Formati supportati: WAV, MP3, MP4, AAC, WebM (max 200M)
file_url	false	string	File audio originale caricato. Sono supportati due metodi per caricare i file audio. Formati supportati: WAV, MP3, MP4, AAC, WebM (max 200M).

3. Carica file audio direttamente

Parametro	Richiesto	Tipo	Descrizione
avatar	false	file	Immagine avatar originale caricata (questo campo ha la priorità). Sono supportati due metodi per caricare le immagini degli avatar. Formati supportati: JPG, PNG, JPEG, WebP
avatar_url	false	string	Immagine avatar originale caricata. Sono supportati due metodi per caricare le immagini degli avatar. Formati supportati: JPG, PNG, JPEG, WebP
type	true	int	2:Carica audio
file	false	file	File audio originale caricato (questo campo ha la priorità). Sono supportati due metodi per caricare i file audio. Formati supportati: WAV, MP3, MP4, AAC, WebM (max 200M)
file_url	false	string	File audio originale caricato. Sono supportati due metodi per caricare i file audio. Formati supportati: WAV, MP3, MP4, AAC, WebM (max 200M).

Attributi della Risposta

Parametro	Tipo	Descrizione
code	int	200
message	string	Osservazioni del task
data	obj	Oggetto del task
data.task_id	string	ID del task

Esempio

Attributi della Richiesta

1. Sintesi audio con voce preimpostata


                  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. Sintesi audio con voce clonata


                  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. Carica file audio direttamente


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

Attributi della Risposta

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

Successivamente puoi verificare lo stato del task e ottenere i dati del task tramite l'interfaccia task/detail.

Ottieni lista ufficiale delle voci

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

Attributi della Risposta

Parametro	Tipo	Descrizione
voices	array	Lista delle voci.
voices.voice_id	string	Identificatore unico per la voce.
voices.name	string	Nome della voce.
voices.country_name	string	Nome del paese,
voices.country_icon_url	string	URL per l'icona del paese.
voices.preview_audio_url	string	URL per l'anteprima della voce.
voices.gender	string	Genere associato alla voce: maschile, femminile, sconosciuto.
voices.language	string	Lingua della voce.
voices.style_list	array	Lista delle emozioni disponibili.
voices.words_per_minute	string	ID del task

Esempio

Attributi della Risposta

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

}

Accesso ai dettagli del task

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

Attributi della Richiesta

Parametro	Richiesto	Tipo	Descrizione
id	true	string	ID del task

Attributi della Risposta

Parametro	Tipo	Descrizione
id	int	ID del task
message	int	Informazioni sul task.
status	int	Lo stato attuale del task -1: non eseguito; -2: in esecuzione.
additional_data	json	Genera risultati; vedi i dettagli qui sotto.

Esempio

Attributi della Richiesta


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

Attributi della Risposta

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

1. ai_headshot

Attributi della Risposta

Parametro	Tipo	Descrizione
img_key	string	Chiave del file generato
img_url	string	URL del file generato.

Esempio

{
          "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. Anteprima foto parlante

Attributi della Risposta

Parametro	Tipo	Descrizione
key	int	Dimensione del video generato.
url	float	Durata del video generato.
subtitles	bool	Con sottotitoli o meno
audio_size	string	Dimensione dell'audio generato.
audio_duration	float	Durata dell'audio generato.

Esempio

{
        "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. Genera video

Attributi della Risposta

Parametro	Tipo	Descrizione
key	string	Chiave del video generato.
url	string	URL del video generato.
video_720p	obj	Info video 720p generato, o null se non c'è video di quella definizione.
video_720p.key	string	Chiave info video 720p generato.
video_720p.url	string	URL info video 720p generato.
video_720p.video_size	int	Dimensione video 720p generato.
video_720p.video_duration	float	Durata video 720p generato.
video_size	int	Dimensione info video generato.
video_duration	float	Durata info video generato.

Esempio

{
    "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. testo in immagine

Attributi della Risposta

Parametro	Tipo	Descrizione
images	array	Array di immagini generate.
image_key	string	Chiave immagine generata.
image_url	string	URL immagine generata.
image_size	int	Dimensione immagine generata.

Esempio

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