---
title: "Usa Kling en Hermes Agent con RunAPI — Guía de API de generación de video"
url: "https://runapi.ai/pt-BR/hermes-kling.md"
canonical: "https://runapi.ai/pt-BR/hermes-kling"
locale: "pt-BR"
model: "kling"
---

# Usa Kling en Hermes Agent.

Kling de Kuaishou genera video cinematográfico con control de movimiento, AI Avatar y velocidad Turbo. Hermes Agent lo llama a través del proveedor custom:runapi — la misma clave y URL base configuradas para chat. Admite texto a video e imagen a video con duraciones de 5 y 10 segundos. Las tareas son asíncronas — consulta el task_id hasta que el video esté listo.

## API example

```bash
curl -X POST https://runapi.ai/v1/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0",
    "prompt": "A hot air balloon drifting over snow-capped mountains at golden hour, smooth camera pan",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "kling-3.0"
}

```

## How it works

1. **Configura RunAPI** — Establece la variable de entorno RUNAPI_API_KEY. Si ya añadiste RunAPI como proveedor custom:runapi en Hermes Agent, la misma clave y base_url gestionan también las solicitudes de video de Kling.
2. **Llama a Kling** — Envía un POST al endpoint text_to_video con model kling-3.0. Incluye un prompt descriptivo y opcionalmente establece duration (5 o 10) y aspect_ratio. Para animación desde imagen, usa el endpoint image_to_video con una image_url.
3. **Obtén el resultado** — El endpoint devuelve un task_id con estado pendiente. Consulta el endpoint de estado de la tarea hasta que el estado cambie a completado y luego recupera la URL del video de la respuesta.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obligatorio. kling-3.0, kling-v2.5-turbo-text-to-video-pro, kling-ai-avatar-pro u otra variante de Kling. |
| `prompt` | `string` | Descripción de texto del video a generar. |
| `duration` | `integer` | Opcional. Duración del video en segundos — 5 o 10. |
| `aspect_ratio` | `string` | Opcional. Relación de aspecto de salida: 16:9, 9:16 o 1:1. |
| `image_url` | `string` | Obligatorio para image_to_video y ai_avatar. URL de la imagen de referencia de entrada. |
| `callback_url` | `string` | Opcional. URL de webhook para notificación de finalización asíncrona. |

## FAQ

### ¿Puedo generar video con Kling desde Hermes Agent?

Sí. Llama al endpoint text_to_video con model kling-3.0 a través del proveedor custom:runapi. La misma RUNAPI_API_KEY que usas para chat gestiona también las solicitudes de video de Kling.

### ¿Cuáles son las diferencias entre las variantes de Kling?

Kling 3.0 es el modelo más reciente de uso general, ideal para texto a video de alta calidad. Kling v2.5 Turbo está optimizado para velocidad. Los modelos AI Avatar generan video de cuerpo completo a partir de una imagen de referencia. Todos comparten la misma clave API y endpoint.

### ¿Cómo se factura Kling en RunAPI?

Kling se factura por segundo de video generado. La duración puede ser 5 o 10 segundos. El coste por segundo varía según el modelo. Consulta la página de precios de RunAPI para las tarifas actuales.

### ¿Kling admite generación de AI Avatar?

Sí. Usa los modelos kling-ai-avatar-pro o kling-ai-avatar-standard con el endpoint ai_avatar. Pasa una image_url de referencia y un prompt de texto. El modelo genera video de cuerpo completo animando la figura de la imagen.

### ¿Cómo funciona el polling de tareas para Kling en Hermes Agent?

La API devuelve inmediatamente un task_id. Consulta el endpoint de estado de la tarea a intervalos regulares hasta que el campo status cambie a completado. Luego recupera la URL del video de la salida de la respuesta.


## Links

- [Guía de configuración de Hermes Agent →](https://runapi.ai/pt-BR/hermes-agent)
- [Modelos de Kling →](https://runapi.ai/pt-BR/models/kling)
- [Model catalog](https://runapi.ai/pt-BR/models)
- [API docs](https://runapi.ai/pt-BR/docs)