---
title: "Usa Flux Kontext en Hermes Agent con RunAPI — Guía de API de imágenes"
url: "https://runapi.ai/es/hermes-flux-kontext.md"
canonical: "https://runapi.ai/es/hermes-flux-kontext"
locale: "es"
model: "flux-kontext"
---

# Usa Flux Kontext en Hermes Agent.

Flux Kontext de Black Forest Labs gestiona la edición y generación de imágenes guiadas por texto con consistencia de personajes. Hermes Agent lo llama a través de RunAPI usando el proveedor custom:runapi — la misma clave y URL base que configuraste para chat.

## API example

```bash
curl -X POST https://runapi.ai/v1/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-kontext-pro",
    "prompt": "a matte-black water bottle on a beige stone surface, soft side light, studio photography"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "flux-kontext-pro"
}

```

## 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 para chat, la misma clave y base_url funcionan para generación de imágenes — no se necesita configuración adicional.
2. **Llama a Flux Kontext** — Envía una solicitud POST al endpoint text_to_image con model establecido en flux-kontext-pro. Incluye un prompt de texto describiendo la imagen que deseas. Opcionalmente pasa un image_url para edición en contexto.
3. **Obtén el resultado** — El endpoint devuelve un task ID. Consulta el endpoint de estado de la tarea hasta que el estado cambie a completado y luego recupera la URL de la imagen generada de la respuesta.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obligatorio. flux-kontext-pro o flux-kontext-max. |
| `prompt` | `string` | Instrucción de texto para generación o edición. |
| `image_url` | `string` | URL de imagen fuente para edición en contexto. |
| `aspect_ratio` | `string` | Opcional. Relación de aspecto de la salida. |

## FAQ

### ¿Puedo usar Flux Kontext en Hermes Agent?

Sí. Configura RunAPI como proveedor custom:runapi en Hermes Agent y luego llama al endpoint text_to_image con model establecido en flux-kontext-pro. La misma RUNAPI_API_KEY que usas para chat también sirve para generación de imágenes.

### ¿Necesito una clave API separada para Flux Kontext?

No. La misma RUNAPI_API_KEY funciona para todos los modelos de RunAPI — LLM, imagen, video y música. Una clave, una cuenta de facturación.

### ¿Flux Kontext es asíncrono o síncrono?

Asíncrono. La API devuelve un task ID de inmediato. Consulta el endpoint de estado de la tarea o usa un webhook de callback para recibir la URL de la imagen completada.

### ¿Cuánto cuesta Flux Kontext?

Flux Kontext Pro empieza en 2,5 centavos por imagen. Flux Kontext Max cuesta más por mayor fidelidad. Consulta la página de precios de RunAPI para las tarifas actuales — la facturación es de pago por uso sin suscripción.


## Links

- [Guía de configuración de Hermes Agent →](https://runapi.ai/es/hermes-agent)
- [Modelos de Flux Kontext →](https://runapi.ai/es/models/flux-kontext)
- [Model catalog](https://runapi.ai/es/models)
- [API docs](https://runapi.ai/es/docs)