---
title: "Usa GPT Image en Hermes Agent con RunAPI — Guía de API de imágenes"
url: "https://runapi.ai/es/hermes-gpt-image.md"
canonical: "https://runapi.ai/es/hermes-gpt-image"
locale: "es"
model: "gpt-image"
---

# Usa GPT Image en Hermes Agent.

GPT Image 2 de OpenAI genera imágenes fotorrealistas con renderizado preciso de texto a través del endpoint text_to_image de RunAPI. Hermes Agent lo llama mediante el proveedor custom:runapi — la misma clave y URL base configuradas para chat. Admite tamaños de 1024x1024 a 1536x1024 y niveles de calidad de low a high. Las tareas son asíncronas — consulta el task_id hasta completar.

## 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": "gpt-image-2-text-to-image",
    "prompt": "A minimalist product photo of a glass water bottle on a white marble surface, soft natural light",
    "size": "1024x1024",
    "quality": "high"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "gpt-image-2-text-to-image"
}

```

## 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 GPT Image — no se necesita configuración adicional.
2. **Llama a GPT Image** — Envía un POST al endpoint text_to_image con model establecido en gpt-image-2-text-to-image. Incluye un prompt descriptivo. Opcionalmente establece size (1024x1024, 1536x1024 o 1024x1536) y quality (low, medium, high o auto). Para edición de imagen a imagen, usa el endpoint image_to_image con una source_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 de la imagen generada de la respuesta.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obligatorio. gpt-image-2-text-to-image, gpt-image-1.5-text-to-image, gpt-image-2-image-to-image o gpt-image-1.5-image-to-image. |
| `prompt` | `string` | Descripción de texto de la imagen a generar. |
| `size` | `string` | Opcional. Dimensiones de salida: 1024x1024, 1536x1024 o 1024x1536. |
| `quality` | `string` | Opcional. Nivel de calidad de la imagen — low, medium, high o auto. Afecta al coste por imagen. |
| `source_image_url` | `string` | Obligatorio para image_to_image. URL de la imagen de entrada para editar o transformar. |
| `callback_url` | `string` | Opcional. URL de webhook para notificación de finalización asíncrona. |

## FAQ

### ¿Puedo generar imágenes con GPT Image desde Hermes Agent?

Sí. Envía un POST al endpoint text_to_image con model establecido en gpt-image-2-text-to-image o gpt-image-1.5-text-to-image. El mismo proveedor custom:runapi y RUNAPI_API_KEY que usas para chat gestionan también la generación de imágenes.

### ¿Cuál es la diferencia entre GPT Image 2 y GPT Image 1.5?

GPT Image 2 ofrece mejor precisión en renderizado de texto, mayor consistencia y una gama más amplia de opciones de calidad (low, medium, high, auto). GPT Image 1.5 es la variante anterior. Ambos admiten texto a imagen e imagen a imagen.

### ¿Cómo se factura GPT Image en RunAPI?

GPT Image se factura por imagen. El coste varía según el nivel de calidad seleccionado — low, medium, high o auto. Auto selecciona la calidad según el prompt. Consulta la página de precios de RunAPI para las tarifas actuales.

### ¿GPT Image admite edición de imágenes de imagen a imagen?

Sí. Usa gpt-image-2-image-to-image con el endpoint image_to_image. Pasa una source_image_url y un prompt de texto. El modelo combina la imagen de entrada con el prompt para producir el resultado editado.

### ¿Necesito una configuración de proveedor separada para GPT Image?

No. La misma RUNAPI_API_KEY y base_url del proveedor custom:runapi funcionan para GPT Image, GPT chat y todos los demás modelos de RunAPI. Solo cambia el endpoint y el parámetro model según lo que generas.


## Links

- [Guía de configuración de Hermes Agent →](https://runapi.ai/es/hermes-agent)
- [GPT Image en RunAPI →](https://runapi.ai/es/models/gpt-image)
- [Model catalog](https://runapi.ai/es/models)
- [API docs](https://runapi.ai/es/docs)