Saltar a contenido

Creación de avatares

Esta guía de API proporciona una descripción general de la creación de avatares en nuestra plataforma.

Puede ver una lista de todos los avatares predeterminados y avatares personalizados y verificar su estado. Use el avatar 'id' para monitorear el progreso, ya que el proceso de generación puede tomar algún tiempo. Una vez listo, puede usar estos avatares para generar videos, mejorando su contenido con funciones de avatar personalizadas. 🦊

Inicio rápido

Profundicemos y exploremos cómo crear avatares instantáneos y premium en nuestra plataforma.

Crear avatar instantáneo

Un avatar instantáneo se genera rápidamente a partir de una foto que usted proporciona, lo que ofrece una forma rápida de crear un avatar. Para crear un avatar instantáneo, debe proporcionar una foto que se adhiera a estas directrices, ya que la calidad del avatar depende completamente de la foto proporcionada. Realice una solicitud a la API para la creación instantánea de avatar. Los formatos de imagen aceptados incluyen 'png' y 'jpeg'. Envíe el archivo y otros datos como multipart/form-data con las claves proporcionadas en la solicitud de muestra. En la respuesta, el 'id' es el elemento clave que usará para la solicitud de video masiva. La 'miniatura' proporciona una vista previa del avatar recién creado, lo que le permite revisarlo antes de usarlo. También se incluirán detalles adicionales como 'nombre', 'género' y 'usuario' en la respuesta. Utilice el estado del avatar api para comprobar el estado del avatar.

    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
}

Crear avatar premium.

Un avatar premium se crea a partir de un video, lo que resulta en una representación más realista y detallada. Para generar un avatar premium con nuestra API, siga estos pasos:

  1. Solicitar URL prefirmadas:

Primero, solicite las URL prefirmadas y los nombres de archivo de video correspondientes desde el punto de generación de URL prefirmadas, especificando las extensiones de archivo (p. ej., .mp4) de los videos que se subirán. La respuesta proporcionará dos URL prefirmadas: una para el video sin sonido y otra para el video con diálogo, lo que permite la subida directa. Además, la respuesta incluirá los nombres de archivo de ambos videos, que deben enviarse en el siguiente paso para generar el avatar premium.

```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"
}
}
```
  1. Subir videos usando URL pre-firmadas:

Para generar un avatar premium, debes subir un video con diálogos; el video sin sonido es opcional para mejorar la calidad del avatar. Asegúrate de que ambos videos cumplan con las directrices. Usa el método PUT con la 'presigned_url' que obtuviste en el paso anterior, que tiene una validez de 30 minutos. Los archivos de video deben subirse como datos binarios directamente a las URL dentro de este plazo.

```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'
```

```json
{
}
```

```bash
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'
```

```json
{
}
```
  1. Enviar solicitud de creación de avatar:

Después de subir los videos, use el 'file_name' obtenido de la solicitud de URL prefirmada para generar el avatar premium. La respuesta incluirá el 'id' del avatar premium recién creado, que se usará para las siguientes solicitudes de video en bloque](video_request.md). Además, la respuesta proporcionará una 'thumbnail' (vista previa del avatar), así como detalles como la 'hora de generación', el 'nombre', el 'género' y otra información relevante. Use la api de estado del avatar para verificar el estado del avatar.

```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'
```

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