---
title: "Use Flux Kontext no OpenClaw via RunAPI — Guia de API de Imagem"
url: "https://runapi.ai/pt-BR/openclaw-flux-kontext.md"
canonical: "https://runapi.ai/pt-BR/openclaw-flux-kontext"
locale: "pt-BR"
model: "flux-kontext"
---

# Use Flux Kontext no OpenClaw.

Flux Kontext da Black Forest Labs realiza edição e geração de imagens guiadas por texto com consistência de personagem. Agentes OpenClaw o chamam pelo RunAPI com a mesma API key usada para chat — envie um prompt, receba uma URL de imagem.

## 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. **Configure RunAPI** — Defina a variável de ambiente RUNAPI_API_KEY. Se você já configurou RunAPI como provider OpenClaw para chat, a mesma key funciona para geração de imagem — nenhuma configuração extra necessária.
2. **Chame Flux Kontext** — Envie uma requisição POST ao endpoint text_to_image com model definido como flux-kontext-pro. Inclua um prompt de texto descrevendo a imagem desejada. Opcionalmente passe um image_url para edição in-context.
3. **Obtenha o resultado** — O endpoint retorna um task ID. Faça polling do endpoint de status da tarefa até o status mudar para completed, depois recupere a URL da imagem gerada na resposta.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obrigatório. flux-kontext-pro ou flux-kontext-max. |
| `prompt` | `string` | Instrução de texto para geração ou edição. |
| `image_url` | `string` | URL da imagem de origem para edição in-context. |
| `aspect_ratio` | `string` | Opcional. Proporção de aspecto da saída. |

## FAQ

### Posso usar Flux Kontext no OpenClaw?

Sim. Configure RunAPI como provider compatível com OpenAI no OpenClaw, depois chame o endpoint text_to_image com model definido como flux-kontext-pro. A mesma RUNAPI_API_KEY que você usa para chat gerencia geração de imagem.

### Preciso de uma API key separada para Flux Kontext?

Não. A mesma RUNAPI_API_KEY funciona para todos os modelos RunAPI — LLM, imagem, vídeo e música. Uma key, uma conta de faturamento.

### Flux Kontext é assíncrono ou síncrono?

Assíncrono. A API retorna um task ID imediatamente. Faça polling do endpoint de status da tarefa ou use um callback webhook para receber a URL da imagem completa.

### Quanto custa Flux Kontext?

Flux Kontext Pro começa em 2,5 centavos por imagem. Flux Kontext Max custa mais para maior fidelidade. Verifique a página de preços do RunAPI para taxas atuais — faturamento é pay-as-you-go sem assinatura.


## Links

- [Guia de configuração do OpenClaw →](https://runapi.ai/pt-BR/openclaw)
- [Modelos Flux Kontext →](https://runapi.ai/pt-BR/models/flux-kontext)
- [Model catalog](https://runapi.ai/pt-BR/models)
- [API docs](https://runapi.ai/pt-BR/docs)