---
title: "Usa GPT Image en OpenClaw con RunAPI — Guía de API de imagen"
url: "https://runapi.ai/pt-BR/openclaw-gpt-image.md"
canonical: "https://runapi.ai/pt-BR/openclaw-gpt-image"
locale: "pt-BR"
model: "gpt-image"
---

# Usa GPT Image en OpenClaw.

GPT Image 2 es el modelo dedicado de generación de imágenes de OpenAI — texto a imagen y edición de imágenes basada en instrucciones con resolución de salida de hasta 4K y soporte de fondo transparente. Los agentes OpenClaw lo llaman a través de la misma clave RunAPI y endpoint /v1 usados para chat, sin habilidades adicionales que instalar.

## 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 product photo of a glass perfume bottle on a marble surface, transparent background, studio lighting, the label reads AURORA in gold serif font",
    "output_resolution": "2k",
    "aspect_ratio": "3:4"
  }'

```

### 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 en tu perfil de shell. Si RunAPI ya está configurado en OpenClaw para chat, la misma clave funciona para GPT Image — no se necesita configuración adicional.
2. **Llama a GPT Image 2** — Envía una solicitud POST al endpoint text_to_image con model establecido en gpt-image-2-text-to-image. Incluye un prompt descriptivo con instrucciones de disposición y estilo. Establece output_resolution en 2k o 4k para mayor detalle. Para editar imágenes existentes, usa el endpoint edit_image con gpt-image-2-image-to-image y proporciona source_image_urls.
3. **Obtén el resultado** — La API devuelve un task_id inmediatamente. Consulta el endpoint de estado de la tarea hasta que el estado cambie a completed, luego recupera la URL de la imagen de salida de la respuesta. GPT Image 2 normalmente se completa en 10-30 segundos dependiendo de la resolución.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obligatorio. gpt-image-2-text-to-image para generación, gpt-image-2-image-to-image para edición. |
| `prompt` | `string` | Obligatorio. Descripción en lenguaje natural de la imagen deseada. Admite instrucciones detalladas de disposición, superposiciones de texto y estilo. |
| `output_resolution` | `string` | Opcional. Resolución de salida — 1k (predeterminado), 2k o 4k. Mayor resolución cuesta más por imagen. |
| `aspect_ratio` | `string` | Opcional. Por defecto auto. Admite 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16 y más. |
| `source_image_urls` | `array` | Obligatorio para el endpoint edit_image. Una o más URLs de imágenes fuente a editar. |

## FAQ

### ¿Puedo usar GPT Image 2 en OpenClaw?

Sí. Los agentes OpenClaw llaman a GPT Image 2 a través del endpoint text_to_image de RunAPI. Establece el campo model en gpt-image-2-text-to-image y envía la solicitud con la misma RUNAPI_API_KEY que usas para chat. No se requieren habilidades ni plugins adicionales.

### ¿Cuál es la diferencia entre GPT Image 2 y GPT-4o Image?

GPT Image 2 es el modelo dedicado de generación de imágenes de OpenAI con mayor calidad, salida 4K y soporte de fondo transparente. GPT-4o Image genera imágenes dentro de un contexto de chat pero está limitado a relaciones de aspecto 1:1, 3:2 o 2:3. Ambos están disponibles a través de RunAPI — usa gpt-image-2-text-to-image para generación independiente y gpt-4o-image para salida de imagen integrada en chat.

### ¿GPT Image 2 admite fondos transparentes?

Sí. GPT Image 2 puede producir imágenes con fondos transparentes cuando se indica en el prompt. Esto es útil para fotos de producto, logotipos y elementos de interfaz. Especifica la transparencia en tu prompt — por ejemplo, "foto de producto con fondo transparente."

### ¿Cómo funciona el precio de GPT Image 2 en RunAPI?

GPT Image 2 se factura por imagen según la resolución de salida: 1k es el coste más bajo, 2k es intermedio y 4k es el más caro. La misma tarifa se aplica tanto a text_to_image como a edit_image. Consulta la página de precios de RunAPI para las tarifas actuales por imagen. Las generaciones fallidas no se cobran.

### ¿Puedo editar una imagen existente con GPT Image 2?

Sí. Usa el endpoint edit_image con model establecido en gpt-image-2-image-to-image. Pasa las URLs de las imágenes fuente en source_image_urls y describe la edición en el prompt — por ejemplo, "cambia el fondo a un atardecer en la playa" o "añade un sombrero rojo a la persona." GPT Image 2 sigue instrucciones de edición en lenguaje natural.


## Links

- [Guía de configuración de OpenClaw →](https://runapi.ai/pt-BR/openclaw)
- [Modelos de GPT Image →](https://runapi.ai/pt-BR/models/gpt-image)
- [Model catalog](https://runapi.ai/pt-BR/models)
- [API docs](https://runapi.ai/pt-BR/docs)