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

# Usa Flux 2 en OpenClaw.

Flux 2 de Black Forest Labs ofrece dos niveles de calidad — Pro para generación rápida y económica a 5 centavos por imagen, y Flex para salida de mayor fidelidad. Ambos admiten texto a imagen y remix multi-fuente a resolución 1k o 2k. Los agentes OpenClaw lo llaman a través de la misma clave RunAPI usada 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-2-pro-text-to-image",
    "prompt": "a ceramic vase with dried flowers on a linen tablecloth, natural window light, 35mm film grain",
    "aspect_ratio": "3:4",
    "output_resolution": "2k"
  }'

```

### Response

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

```

## How it works

1. **Configura RunAPI** — Establece la variable de entorno RUNAPI_API_KEY. Si ya configuraste RunAPI como proveedor de OpenClaw para chat, la misma clave funciona para la generación de imágenes con Flux 2 — no se necesita configuración adicional.
2. **Llama a Flux 2** — Envía una solicitud POST al endpoint text_to_image con model establecido en flux-2-pro-text-to-image. Incluye un prompt y opcionalmente establece aspect_ratio (1:1, 4:3, 16:9, etc.) y output_resolution (1k o 2k). Para remix multi-fuente, usa el endpoint remix_image con source_image_urls en su lugar.
3. **Obtén el resultado** — El endpoint devuelve un ID de tarea. Consulta el endpoint de estado de la tarea hasta que el estado cambie a completed, luego recupera la URL de la imagen generada de la respuesta. Los SDK y la CLI de RunAPI gestionan el polling automáticamente.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obligatorio. flux-2-pro-text-to-image, flux-2-flex-text-to-image, flux-2-pro-remix-image o flux-2-flex-remix-image. |
| `prompt` | `string` | Descripción textual de la imagen a generar. |
| `aspect_ratio` | `string` | Opcional. Relación de aspecto de la salida: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2 o 2:3. Los endpoints de remix también aceptan auto. |
| `output_resolution` | `string` | Opcional. 1k (predeterminado) o 2k. Mayor resolución cuesta más por imagen. |
| `source_image_urls` | `array` | Obligatorio para remix_image. Array de URLs de imágenes fuente para combinar o transformar. |
| `callback_url` | `string` | Opcional. URL de webhook para notificación de finalización asíncrona. |

## FAQ

### ¿Cuál es la diferencia entre Flux 2 Pro y Flux 2 Flex?

Pro es el nivel más rápido y económico a 5 centavos por imagen 1k. Flex produce salida de mayor fidelidad a 14 centavos por imagen 1k. Ambos comparten los mismos parámetros de API y admiten los endpoints text_to_image y remix_image.

### ¿Puedo remixar múltiples imágenes fuente con Flux 2?

Sí. Usa el endpoint remix_image con model flux-2-pro-remix-image o flux-2-flex-remix-image. Pasa un array de URLs de imágenes fuente en source_image_urls junto con un prompt de texto que describa la salida deseada.

### ¿La resolución de salida de Flux 2 afecta al precio?

Sí. Cada variante se factura por imagen con precios basados en la resolución. Por ejemplo, Flux 2 Pro cuesta 5 centavos a 1k y 7 centavos a 2k. Flux 2 Flex cuesta 14 centavos a 1k y 24 centavos a 2k. Consulta la página de precios de RunAPI para las tarifas actuales.

### ¿Cómo se compara Flux 2 con Flux Kontext?

Flux Kontext se especializa en edición guiada por texto y consistencia de personajes con una sola imagen de entrada. Flux 2 se enfoca en generación de texto a imagen y remix multi-fuente con niveles de calidad Pro/Flex y resolución de salida seleccionable. Ambos son de Black Forest Labs y están disponibles a través de la misma clave RunAPI.

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

Asíncrono. La API devuelve un ID de tarea inmediatamente. Consulta el endpoint de estado de la tarea o establece un webhook callback_url para recibir la URL de la imagen completada. Los SDK y la CLI de RunAPI gestionan el polling automáticamente.


## Links

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