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.
Use RunAPI to generate an image with Flux Kontext Pro.
Requirements:
- Call the RunAPI text_to_image endpoint at https://runapi.ai/v1/text_to_image
- Set model to "flux-kontext-pro"
- Use the RUNAPI_API_KEY environment variable for authorization
- The response is async — poll the task status endpoint until the task completes, then retrieve the image URL
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"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "flux-kontext-pro"
}
Use Flux Kontext no OpenClaw em três passos
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.
export RUNAPI_API_KEY=runapi_xxx
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.
text_to_image
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.
task_id: tsk_abc123
Parâmetros da API Flux Kontext
| Parâmetro | Tipo | Descrição |
|---|---|---|
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. |
O que é Flux Kontext no OpenClaw?
Flux Kontext da Black Forest Labs é um modelo de edição de imagens contínuo que usuários dizem ser "melhor que ChatGPT e Gemini" para modificações precisas. Você descreve o que mudar em texto simples e ele modifica aquela parte mantendo o resto intacto. Agentes OpenClaw o chamam via endpoint RunAPI text_to_image.
Casos de uso do Flux Kontext
Substituição de fundo mantendo o sujeito
Troque fundos de produto ou retrato enquanto o sujeito, a iluminação e as sombras permanecem intactos.
Mudanças de roupa e aparência
Mude roupas, cor do cabelo ou acessórios de um personagem mantendo os traços faciais e proporções corporais.
Substituição de texto em placas e etiquetas
Substitua texto em placas, etiquetas de produtos ou vitrines em imagens existentes sem perturbar o ambiente.
Perguntas sobre Flux Kontext + 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.
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.
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.
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.
Configuração geral do OpenClaw
Ainda não configurou? Comece com o guia de configuração do RunAPI para OpenClaw.
Guia de configuração do OpenClaw →Catálogo de modelos Flux Kontext
Veja todas as variantes, preços e documentação da API do Flux Kontext.
Modelos Flux Kontext →Experimente Flux Kontext no OpenClaw hoje.
Obtenha uma API key RunAPI gratuita, cole o prompt no OpenClaw e comece a gerar imagens com Flux Kontext.