Herramientas de IA

Talking Avatar

Los recursos (imagen, video) generados por nuestra API son válidos por 7 días. Guarda los recursos relevantes lo antes posible para evitar su vencimiento.

Construir Vista Previa

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

Encabezados de Solicitud

Parámetro	Requerido	Tipo	Descripción
Content-Type	true	string	Tipo de transmisión de datos: multipart/form-data

Atributos de Solicitud

1. Usar voz preestablecida

Parámetro	Requerido	Tipo	Descripción
voice_id	true	string	ID de la lista de voces (se prefiere voice_id)
text	true	string	Contenido del texto

2. Usar voz clonada

Parámetro	Requerido	Tipo	Descripción
lang	true	string	Idioma (El modo clonado solo admite inglés, chino tradicional, coreano y japonés)
file	false	file	Audio original subido (se da prioridad a este campo). Se admiten dos métodos para subir audios.
file_url	false	string	Dirección del audio original. Se admiten dos métodos para subir audios.
text	true	string	Contenido del texto

Atributos de Respuesta

Parámetro	Tipo	Descripción
code	int	200
message	string	Comentario de la tarea
data	obj	Objeto de la tarea
data.task_id	string	ID de la tarea

Ejemplo

Atributos de Solicitud

1. Usar voz preestablecida


                  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 Respuesta

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

A continuación, puedes consultar el estado de la tarea y obtener los datos de la tarea a través de la interfaz task/detail.

Generar Video de Foto Parlante

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

Encabezados de Solicitud

Parámetro	Requerido	Tipo	Descripción
Content-Type	true	string	Tipo de transmisión de datos: multipart/form-data

Atributos de Solicitud

1. Sintetizando audio con voz preestablecida

Parámetro	Requerido	Tipo	Descripción
voice_id	true	string	ID de la lista de voces (se prefiere voice_id)
text	true	string	Contenido del texto
type	true	int	0:Voz preestablecida
avatar	false	file	Imagen original del avatar subida (se da prioridad a este campo). Se admiten dos métodos para subir imágenes de avatar. Formatos compatibles: JPG, PNG, JPEG, WebP
avatar_url	false	string	Imagen original del avatar subida. Se admiten dos métodos para subir imágenes de avatar. Formatos compatibles: JPG, PNG, JPEG, WebP

2. Sintetizando audio con voz clonada

Parámetro	Requerido	Tipo	Descripción
text	true	string	Contenido del texto
style	false	string	Emoción por defecto: normal
lang	true	string	Contenido del texto
avatar	false	file	Imagen original del avatar subida (se da prioridad a este campo). Se admiten dos métodos para subir imágenes de avatar. Formatos compatibles: JPG, PNG, JPEG, WebP
avatar_url	false	string	Imagen original del avatar subida. Se admiten dos métodos para subir imágenes de avatar. Formatos compatibles: JPG, PNG, JPEG, WebP
type	true	int	1:Voz clonada
file	false	file	Archivo de audio original subido (se da prioridad a este campo). Se admiten dos métodos para subir archivos de audio. Formatos compatibles: WAV, MP3, MP4, AAC, WebM (Máximo 200 MB)
file_url	false	string	Archivo de audio original subido. Se admiten dos métodos para subir archivos de audio. Formatos compatibles: WAV, MP3, MP4, AAC, WebM (Máximo 200 MB).

3. Subir archivos de audio directamente

Parámetro	Requerido	Tipo	Descripción
avatar	false	file	Imagen original del avatar subida (se da prioridad a este campo). Se admiten dos métodos para subir imágenes de avatar. Formatos compatibles: JPG, PNG, JPEG, WebP
avatar_url	false	string	Imagen original del avatar subida. Se admiten dos métodos para subir imágenes de avatar. Formatos compatibles: JPG, PNG, JPEG, WebP
type	true	int	2:Subir audio
file	false	file	Archivo de audio original subido (se da prioridad a este campo). Se admiten dos métodos para subir archivos de audio. Formatos compatibles: WAV, MP3, MP4, AAC, WebM (Máximo 200 MB)
file_url	false	string	Archivo de audio original subido. Se admiten dos métodos para subir archivos de audio. Formatos compatibles: WAV, MP3, MP4, AAC, WebM (Máximo 200 MB).

Atributos de Respuesta

Parámetro	Tipo	Descripción
code	int	200
message	string	Comentario de la tarea
data	obj	Objeto de la tarea
data.task_id	string	ID de la tarea

Ejemplo

Atributos de Solicitud

1. Sintetizando audio con voz preestablecida


                  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 audio con 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. Subir archivos de audio directamente


                  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 Respuesta

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

A continuación, puedes consultar el estado de la tarea y obtener los datos de la tarea a través de la interfaz task/detail.

Obtener Lista Oficial de Voces

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

Atributos de Respuesta

Parámetro	Tipo	Descripción
voices	array	Lista de voces.
voices.voice_id	string	Identificador único para la voz.
voices.name	string	Nombre de la voz.
voices.country_name	string	Nombre del país.
voices.country_icon_url	string	URL para el ícono del país.
voices.preview_audio_url	string	URL para la vista previa de la voz.
voices.gender	string	Género asociado a la voz: masculino, femenino, desconocido.
voices.language	string	Idioma de la voz.
voices.style_list	array	Lista de emociones disponibles.
voices.words_per_minute	string	ID de la tarea

Ejemplo

Atributos de Respuesta

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

}

Acceso al Detalle de la Tarea

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

Atributos de Solicitud

Parámetro	Requerido	Tipo	Descripción
id	true	string	ID de la tarea

Atributos de Respuesta

Parámetro	Tipo	Descripción
id	int	ID de la tarea
message	int	Información de la tarea.
status	int	Estado actual de la tarea -1: no ejecutada; -2: en ejecución.
additional_data	json	Generar resultados; consulta los detalles a continuación.

Ejemplo

Atributos de Solicitud


                  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 Respuesta

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

1. Fotos para CV

Atributos de Respuesta

Parámetro	Tipo	Descripción
img_key	string	Clave del archivo generado
img_url	string	URL para el archivo generado.

Ejemplo

{
          "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. Vista previa de la foto parlante

Atributos de Respuesta

Parámetro	Tipo	Descripción
key	int	Tamaño del video generado.
url	float	Duración del video generado.
subtitles	bool	Con subtítulos o no
audio_size	string	Tamaño del audio generado.
audio_duration	float	Duración del audio generado.

Ejemplo

{
        "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. Generar videos

Atributos de Respuesta

Parámetro	Tipo	Descripción
key	string	Clave del video generado.
url	string	URL del video generado.
video_720p	obj	Información del video generado en 720p, o nulo si no hay video de esa definición.
video_720p.key	string	Clave de la información del video generado en 720p.
video_720p.url	string	URL de la información del video generado en 720p.
video_720p.video_size	int	Tamaño de la información del video generado en 720p.
video_720p.video_duration	float	Duración de la información del video generado en 720p.
video_size	int	Tamaño de la información del video generado.
video_duration	float	Duración de la información del video generado.

Ejemplo

{
    "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. Texto a imagen

Atributos de Respuesta

Parámetro	Tipo	Descripción
images	array	Arreglo de imágenes generadas.
image_key	string	Clave de la imagen generada.
image_url	string	URL de la imagen generada.
image_size	int	Tamaño de la imagen generada.

Ejemplo

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