Ferramentas IA

Avatar Falante

Os recursos (imagem, vídeo) gerados pela nossa API são válidos por 7 dias. Salve os recursos relevantes o mais rápido possível para evitar a expiração.

Prévia da Construção

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

Cabeçalhos de Solicitação

Parâmetro	Obrigatório	Tipo	Descrição
Content-Type	true	string	Tipo de transmissão de dados: multipart/form-data

Atributos de solicitação

1. Usar Voz Predefinida

Parâmetro	Obrigatório	Tipo	Descrição
voice_id	true	string	ID da lista de vozes (voice_id é o preferido)
text	true	string	Conteúdo de texto

2. Usar Voz Clonada

Parâmetro	Obrigatório	Tipo	Descrição
lang	true	string	Idioma (o modo clone suporta apenas inglês, chinês tradicional, coreano e japonês)
file	false	file	Áudio original carregado (prioridade é dada a este campo). Há dois métodos suportados para carregar áudios.
file_url	false	string	Endereço de áudio original. Há dois métodos suportados para carregar áudios.
text	true	string	Conteúdo de texto

Atributos de Resposta

Parâmetro	Tipo	Descrição
code	int	200
message	string	Observação da Tarefa
data	obj	Objeto da Tarefa
data.task_id	string	ID da Tarefa

Exemplo

Atributos de solicitação

1. Usar Voz Predefinida


                  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. Usar Voz Clonada


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

Atributos de Resposta

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

Em seguida, você pode consultar o status da tarefa e obter os dados da tarefa por meio da interface tarefa/detalhes.

Gerar Vídeo de Avatar Falante

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

Cabeçalhos de Solicitação

Parâmetro	Obrigatório	Tipo	Descrição
Content-Type	true	string	Tipo de transmissão de dados: multipart/form-data

Atributos de solicitação

1. Sintetizando Áudio com Voz Predefinida

Parâmetro	Obrigatório	Tipo	Descrição
voice_id	true	string	ID da lista de vozes (voice_id é o preferido)
text	true	string	Conteúdo de texto
type	true	int	0:Voz Predefinida
avatar	false	file	Imagem de avatar original carregada (prioridade é dada a este campo). Há dois métodos suportados para carregar imagens de avatar. Formato suportado: JPG, PNG, JPEG, WebP
avatar_url	false	string	Imagem de avatar original carregada. Há dois métodos suportados para carregar a imagem de avatar. Formato suportado: JPG, PNG, JPEG, WebP

2. Sintetizando Áudio com Voz Clonada

Parâmetro	Obrigatório	Tipo	Descrição
text	true	string	Conteúdo de texto
style	false	string	Emoção normal por padrão
lang	true	string	Conteúdo de texto
avatar	false	file	Imagem de avatar original carregada (prioridade é dada a este campo). Há dois métodos suportados para carregar imagens de avatar. Formato suportado: JPG, PNG, JPEG, WebP
avatar_url	false	string	Imagem de avatar original carregada. Há dois métodos suportados para carregar a imagem de avatar. Formato suportado: JPG, PNG, JPEG, WebP
type	true	int	1:Voz clonada
file	false	file	Arquivo de áudio original carregado (prioridade é dada a este campo). Há dois métodos suportados para carregar arquivos de áudio. Formato suportado: WAV,MP3,MP4,AAC,WebM Máximo 200M
file_url	false	string	Arquivo de áudio original carregado. Há dois métodos suportados para carregar arquivos de áudio. Formato suportado: WAV, MP3, MP4, AAC, WebM (máximo de 200M).

3. Carregar Arquivos de Áudio Diretamente

Parâmetro	Obrigatório	Tipo	Descrição
avatar	false	file	Imagem de avatar original carregada (prioridade é dada a este campo). Há dois métodos suportados para carregar imagens de avatar. Formato suportado: JPG, PNG, JPEG, WebP
avatar_url	false	string	Imagem de avatar original carregada. Há dois métodos suportados para carregar a imagem de avatar. Formato suportado: JPG, PNG, JPEG, WebP
type	true	int	2:Carregar áudio
file	false	file	Arquivo de áudio original carregado (prioridade é dada a este campo). Há dois métodos suportados para carregar arquivos de áudio. Formato suportado: WAV,MP3,MP4,AAC,WebM Máximo 200M
file_url	false	string	Arquivo de áudio original carregado. Há dois métodos suportados para carregar arquivos de áudio. Formato suportado: WAV, MP3, MP4, AAC, WebM (máximo de 200M).

Atributos de Resposta

Parâmetro	Tipo	Descrição
code	int	200
message	string	Observação da Tarefa
data	obj	Objeto da Tarefa
data.task_id	string	ID da Tarefa

Exemplo

Atributos de solicitação

1. Sintetizando Áudio com Voz Predefinida


                  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. Sintetizando Áudio com Voz Clonada


                  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. Carregar Arquivos de Áudio Diretamente


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

Atributos de Resposta

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

Em seguida, você pode consultar o status da tarefa e obter os dados da tarefa por meio da interface tarefa/detalhes.

Obter a Lista Oficial de Vozes

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

Atributos de Resposta

Parâmetro	Tipo	Descrição
voices	array	Lista de vozes.
voices.voice_id	string	Identificador exclusivo para a voz.
voices.name	string	Nome da voz.
voices.country_name	string	Nome do país.
voices.country_icon_url	string	URL para o ícone do país.
voices.preview_audio_url	string	URL para a pré-visualização de voz.
voices.gender	string	Gênero associado à voz: masculino, feminino, desconhecido.
voices.language	string	Idioma da voz.
voices.style_list	array	Lista de emoções disponíveis.
voices.words_per_minute	string	ID da Tarefa

Exemplo

Atributos de Resposta

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

}

Acesso aos Detalhes da Tarefa

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

Atributos de solicitação

Parâmetro	Obrigatório	Tipo	Descrição
id	true	string	ID da Tarefa

Atributos de Resposta

Parâmetro	Tipo	Descrição
id	int	ID da Tarefa
message	int	Informações da tarefa.
status	int	O status atual da tarefa -1: não executado; -2: em execução.
additional_data	json	Gerar resultados; veja detalhes abaixo.

Exemplo

Atributos de solicitação


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

Atributos de Resposta

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

1.ai_headshot

Atributos de Resposta

Parâmetro	Tipo	Descrição
img_key	string	Chave de geração de arquivo
img_url	string	URL para o arquivo gerado.

Exemplo

{
          "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.Prévia do Avatar Falante

Atributos de Resposta

Parâmetro	Tipo	Descrição
key	int	Tamanho da geração de vídeo.
url	float	Duração da geração de vídeo.
subtitles	bool	Legendado ou não
audio_size	string	Tamanho da geração de áudio.
audio_duration	float	Duração da geração de áudio.

Exemplo

{
        "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.Gerar Vídeos

Atributos de Resposta

Parâmetro	Tipo	Descrição
key	string	Chave da geração de vídeo.
url	string	URL da geração de vídeo.
video_720p	obj	Gera informações de vídeo 720p, ou nulo se não houver vídeo com esta resolução.
video_720p.key	string	Chave de informações de vídeo gerado em 720p.
video_720p.url	string	URL de informações de vídeo gerado em 720p.
video_720p.video_size	int	Tamanho de informação de vídeo gerado em 720p.
video_720p.video_duration	float	Duração de informações do vídeo gerado em 720p.
video_size	int	Tamanho das informações do vídeo gerado.
video_duration	float	Duração das informações do vídeo gerado.

Exemplo

{
    "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.text to image

Atributos de Resposta

Parâmetro	Tipo	Descrição
images	array	Matriz da geração de imagem.
image_key	string	Chave da geração de imagem.
image_url	string	URL da geração de imagem.
image_size	int	Tamanho da geração de imagem.

Exemplo

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