API Heygen Avatar V | Precios y documentación

heygen/avatar-v/text-to-video

Avatar V habla un guión en una mirada pública, con dirección opcional para un movimiento de cabeza o una mano más tranquila.

Índice

1. Primeros pasos

Usa la API de RunComfy para ejecutar heygen/avatar-v/text-to-video. Para entradas y salidas admitidas, consulta el esquema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/heygen/avatar-v/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "avatar_id": "Elise",
    "voice_id": "Match look",
    "script": "Good morning. The harbor market opens in ten minutes, and the first crates of peaches are already on the tables."
  }'

2. Autenticación

Define la variable de entorno YOUR_API_TOKEN con tu clave API (gestión en Perfil) e incluye en cada solicitud un token Bearer en la cabecera Authorization : Authorization: Bearer $YOUR_API_TOKEN.

3. Referencia de la API

Enviar una solicitud

Envía un trabajo de generación asíncrono y recibe de inmediato un request_id y URLs para consultar estado, obtener resultados y cancelar.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/heygen/avatar-v/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "avatar_id": "Elise",
    "voice_id": "Match look",
    "script": "Good morning. The harbor market opens in ten minutes, and the first crates of peaches are already on the tables."
  }'

Estado de la solicitud

Obtiene el estado actual de un request_id ("in_queue", "in_progress", "completed" o "cancelled").

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

Obtener resultados

Obtiene las salidas finales y metadatos del request_id; si el trabajo no ha terminado, la respuesta devuelve el estado actual para seguir haciendo polling.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

Cancelar solicitud

Cancela un trabajo en cola por request_id; los trabajos en curso no se pueden cancelar.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. Archivos de entrada

Archivo alojado (URL)

Proporciona una URL HTTPS públicamente accesible. El host debe permitir peticiones del servidor (sin login/cookies), sin rate limit agresivo ni bloqueo de bots. Recomendado: imágenes ≤ 50 MB (~4K), vídeos ≤ 100 MB (~2–5 min a 720p). Para activos privados, URLs estables o firmadas.

5. Esquema

Esquema de entrada

{
  "type": "object",
  "title": "Esquema de entrada",
  "required": [
    "avatar_id",
    "voice_id",
    "script"
  ],
  "properties": {
    "avatar_id": {
      "title": "Avatar",
      "description": "Mirada pública que aparece en cámara. Cada opción acepta este motor de renderizado.",
      "type": "string",
      "enum": [
        "Elise",
        "Dante Office 2",
        "Genevieve Office 3",
        "Brody Living Room 2",
        "Elodie Kitchen 9",
        "Julian Office 8",
        "Camille",
        "Sebastian Office 11"
      ],
      "default": "Elise"
    },
    "voice_id": {
      "title": "Voz",
      "description": "Voz que habla el guión. Match look utiliza la voz emparejada con la persona seleccionada.",
      "type": "string",
      "enum": [
        "Match look",
        "Nadine - Calm & Gentle",
        "Vincent - Thoughtful & Clear",
        "Jonah - Clear & Professional",
        "Elowen - Warm & Soothing",
        "Hugh - Firm & Measured",
        "Cecily - Warm & Friendly",
        "Lucian - Conversational & Easygoing",
        "Noelle - Warm & Soothing"
      ],
      "default": "Match look"
    },
    "script": {
      "title": "Guion",
      "description": "Palabras para hablar. La duración del clip sigue este texto.",
      "type": "string",
      "maxLength": 5000,
      "default": "Good morning. The harbor market opens in ten minutes, and the first crates of peaches are already on the tables."
    },
    "resolution": {
      "title": "Resolución",
      "description": "Tamaño del marco. 720p y 1080p utilizan la misma velocidad por segundo.",
      "type": "string",
      "enum": [
        "720p",
        "1080p"
      ],
      "default": "1080p"
    },
    "motion_prompt": {
      "title": "Aviso de movimiento",
      "description": "Nota opcional para un asentimiento, un gesto o manos más tranquilas. Déjelo vacío para dejar que el guión lidere.",
      "type": "string",
      "default": "A small nod, then one open hand toward the camera."
    }
  }
}

Esquema de salida

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL de una sola imagen"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL de un solo vídeo"
      },
      "images": {
        "type": "array",
        "description": "varias URLs de imagen",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "varias URLs de vídeo",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

RunComfy

RunComfy es la principal ComfyUI plataforma, ofreciendo ComfyUI en línea entorno y servicios, junto con flujos de trabajo de ComfyUI con impresionantes imágenes. RunComfy también ofrece AI Models, permitiendo a los artistas aprovechar las últimas herramientas de AI para crear arte increíble.

1. Primeros pasos

Usa la API de RunComfy para ejecutar heygen/avatar-v/text-to-video. Para entradas y salidas admitidas, consulta el esquema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/heygen/avatar-v/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "avatar_id": "Elise",
    "voice_id": "Match look",
    "script": "Good morning. The harbor market opens in ten minutes, and the first crates of peaches are already on the tables."
  }'

3. Referencia de la API

Enviar una solicitud

Envía un trabajo de generación asíncrono y recibe de inmediato un request_id y URLs para consultar estado, obtener resultados y cancelar.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/heygen/avatar-v/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "avatar_id": "Elise",
    "voice_id": "Match look",
    "script": "Good morning. The harbor market opens in ten minutes, and the first crates of peaches are already on the tables."
  }'

Estado de la solicitud

Obtiene el estado actual de un request_id ("in_queue", "in_progress", "completed" o "cancelled").

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

Obtener resultados

Obtiene las salidas finales y metadatos del request_id; si el trabajo no ha terminado, la respuesta devuelve el estado actual para seguir haciendo polling.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

Cancelar solicitud

Cancela un trabajo en cola por request_id; los trabajos en curso no se pueden cancelar.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. Archivos de entrada

Archivo alojado (URL)

5. Esquema

Esquema de entrada

{
  "type": "object",
  "title": "Esquema de entrada",
  "required": [
    "avatar_id",
    "voice_id",
    "script"
  ],
  "properties": {
    "avatar_id": {
      "title": "Avatar",
      "description": "Mirada pública que aparece en cámara. Cada opción acepta este motor de renderizado.",
      "type": "string",
      "enum": [
        "Elise",
        "Dante Office 2",
        "Genevieve Office 3",
        "Brody Living Room 2",
        "Elodie Kitchen 9",
        "Julian Office 8",
        "Camille",
        "Sebastian Office 11"
      ],
      "default": "Elise"
    },
    "voice_id": {
      "title": "Voz",
      "description": "Voz que habla el guión. Match look utiliza la voz emparejada con la persona seleccionada.",
      "type": "string",
      "enum": [
        "Match look",
        "Nadine - Calm & Gentle",
        "Vincent - Thoughtful & Clear",
        "Jonah - Clear & Professional",
        "Elowen - Warm & Soothing",
        "Hugh - Firm & Measured",
        "Cecily - Warm & Friendly",
        "Lucian - Conversational & Easygoing",
        "Noelle - Warm & Soothing"
      ],
      "default": "Match look"
    },
    "script": {
      "title": "Guion",
      "description": "Palabras para hablar. La duración del clip sigue este texto.",
      "type": "string",
      "maxLength": 5000,
      "default": "Good morning. The harbor market opens in ten minutes, and the first crates of peaches are already on the tables."
    },
    "resolution": {
      "title": "Resolución",
      "description": "Tamaño del marco. 720p y 1080p utilizan la misma velocidad por segundo.",
      "type": "string",
      "enum": [
        "720p",
        "1080p"
      ],
      "default": "1080p"
    },
    "motion_prompt": {
      "title": "Aviso de movimiento",
      "description": "Nota opcional para un asentimiento, un gesto o manos más tranquilas. Déjelo vacío para dejar que el guión lidere.",
      "type": "string",
      "default": "A small nod, then one open hand toward the camera."
    }
  }
}

Esquema de salida

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL de una sola imagen"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL de un solo vídeo"
      },
      "images": {
        "type": "array",
        "description": "varias URLs de imagen",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "varias URLs de vídeo",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

Avatar V: Guión del vídeo parlante sincronizado con los labios en Models and API | RunComfy

Avatar V habla un guión en una mirada pública, con dirección opcional para un movimiento de cabeza o una mano más tranquila.

Índice

1. Primeros pasos

2. Autenticación

3. Referencia de la API

Enviar una solicitud

Estado de la solicitud

Obtener resultados

Cancelar solicitud

4. Archivos de entrada

Archivo alojado (URL)

5. Esquema

Esquema de entrada

Esquema de salida

Avatar V: Guión del vídeo parlante sincronizado con los labios en Models and API | RunComfy

Avatar V habla un guión en una mirada pública, con dirección opcional para un movimiento de cabeza o una mano más tranquila.

Índice

1. Primeros pasos

2. Autenticación

3. Referencia de la API

Enviar una solicitud

Estado de la solicitud

Obtener resultados

Cancelar solicitud

4. Archivos de entrada

Archivo alojado (URL)

5. Esquema

Esquema de entrada

Esquema de salida