--- title: Use o Flux Kontext no WorkBuddy via RunAPI — Guia MCP | RunAPI description: Gere e edite imagens com o Flux Kontext no WorkBuddy via MCP com RunAPI. Uma API key, edição orientada por texto e consistência de personagem direto do workbench. url: https://runapi.ai/pt-BR/workbuddy-flux-kontext.md canonical: https://runapi.ai/pt-BR/workbuddy-flux-kontext locale: pt-BR site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-flux-kontext zh-CN: https://runapi.ai/zh-CN/workbuddy-flux-kontext es: https://runapi.ai/es/workbuddy-flux-kontext ja: https://runapi.ai/ja/workbuddy-flux-kontext de: https://runapi.ai/de/workbuddy-flux-kontext fr: https://runapi.ai/fr/workbuddy-flux-kontext pt-BR: https://runapi.ai/pt-BR/workbuddy-flux-kontext ko: https://runapi.ai/ko/workbuddy-flux-kontext it: https://runapi.ai/it/workbuddy-flux-kontext nl: https://runapi.ai/nl/workbuddy-flux-kontext pl: https://runapi.ai/pl/workbuddy-flux-kontext tr: https://runapi.ai/tr/workbuddy-flux-kontext zh-TW: https://runapi.ai/zh-TW/workbuddy-flux-kontext zh-HK: https://runapi.ai/zh-HK/workbuddy-flux-kontext ar: https://runapi.ai/ar/workbuddy-flux-kontext x-default: https://runapi.ai/workbuddy-flux-kontext model: flux-kontext --- > HTML version: https://runapi.ai/pt-BR/workbuddy-flux-kontext > Site index for agents: https://runapi.ai/llms.txt # Use o Flux Kontext no WorkBuddy. O Flux Kontext da Black Forest Labs realiza edição e geração de imagens orientada por texto com consistência de personagem. O WorkBuddy o chama por meio do servidor RunAPI MCP — descreva a imagem ou a edição em um prompt e o agente do workbench retorna a URL da imagem finalizada. - [Obter API Key](https://runapi.ai/pt-BR/login) - [Ler a documentação](https://runapi.ai/pt-BR/docs/guides) uma API key · conexão MCP com um clique · async gerenciado pelo servidor ### Prompt ```text Use the runapi MCP server to generate an image with Flux Kontext Pro. Requirements: - Call the RunAPI text_to_image tool with model "flux-kontext-pro" - Prompt: a matte-black water bottle on a beige stone surface, soft side light, studio photography - Wait for the task to complete and show me the image URL ``` ### Configuração MCP ```bash { "mcpServers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer ${RUNAPI_API_KEY}" } } } } ``` ### Resposta ```json { "task_id": "tsk_abc123", "status": "completed", "model": "flux-kontext-pro", "output": { "image_url": "https://media.runapi.ai/outputs/tsk_abc123.png" } } ``` ## Use o Flux Kontext no WorkBuddy em três etapas 1. **Adicione o servidor MCP do RunAPI** - Registre um servidor MCP chamado runapi no WorkBuddy, apontando para https://runapi.ai/mcp via HTTP streamable, com o cabeçalho Authorization lendo sua chave de RUNAPI_API_KEY. Se você já conectou o RunAPI para chat, o Flux Kontext é exposto no mesmo servidor — sem configuração extra. `url: https://runapi.ai/mcp auth: Bearer ${RUNAPI_API_KEY} ` 2. **Instrua o agente da bancada de trabalho** - Peça ao WorkBuddy para chamar a ferramenta text_to_image do RunAPI com o modelo definido como flux-kontext-pro. Descreva a imagem desejada ou passe uma image_url com uma instrução de edição para edição em contexto. `tool: text_to_image · model: flux-kontext-pro` 3. **Obtenha o resultado** - O servidor MCP cria a tarefa, acompanha até a conclusão e entrega a URL da imagem final ao WorkBuddy. O agente exibe a URL na conversa — sem polling manual da sua parte. `task_id: tsk_abc123 → completed` ## Parâmetros da ferramenta Flux Kontext | Parâmetro | Tipo | Descrição | | --- | --- | --- | | `model` | `string` | Obrigatório. flux-kontext-pro ou flux-kontext-max. | | `prompt` | `string` | Instrução em texto para geração ou edição. | | `image_url` | `string` | URL da imagem fonte para edição em contexto. | | `aspect_ratio` | `string` | Opcional. Proporção de saída. | ## O que é o Flux Kontext no WorkBuddy? O Flux Kontext da Black Forest Labs é um modelo de edição contínua de imagens que usuários descrevem como "melhor que ChatGPT e Gemini" para modificações precisas. Você descreve o que deseja alterar em linguagem natural, e ele modifica essa parte mantendo todo o restante intacto — o rosto permanece igual quando você troca a roupa, o produto fica na mesma posição quando você substitui o fundo. O WorkBuddy o acessa como uma ferramenta no servidor RunAPI MCP, então as edições acontecem diretamente no workbench. ## Casos de uso do Flux Kontext - **Substituição de fundo preservando os sujeitos** - Troque fundos de produtos ou retratos mantendo o sujeito na mesma posição exata — sem mascaramento, sem inpainting, apenas uma instrução de texto digitada no WorkBuddy. - **Alterações de roupa e aparência** - Troque roupas, cor do cabelo ou acessórios de um personagem preservando a identidade facial, útil para mockups de moda e iteração de design de personagens. - **Substituição de texto em placas e rótulos** - Substitua textos em placas, rótulos de produtos ou fachadas de lojas em imagens existentes — digite o novo texto no prompt e o Flux Kontext o renderiza no lugar. ## Perguntas sobre Flux Kontext + WorkBuddy ### Posso usar o Flux Kontext no WorkBuddy? Sim. Adicione o RunAPI como um servidor MCP no WorkBuddy e peça ao agente para chamar a ferramenta text_to_image com o modelo definido como flux-kontext-pro. A mesma RUNAPI_API_KEY que você usa para chat cuida da geração de imagens. ### Preciso de uma chave de API separada para o Flux Kontext? Não. A mesma RUNAPI_API_KEY funciona para todos os modelos RunAPI — LLM, imagem, vídeo e música. Um servidor MCP, uma chave, uma conta de cobrança. ### Quem gerencia o polling de tarefas assíncronas no WorkBuddy? O servidor RunAPI MCP. As tarefas do Flux Kontext são assíncronas, mas o servidor acompanha cada tarefa até a conclusão e retorna a URL da imagem finalizada ao WorkBuddy, sem polling manual. ### Quanto custa o Flux Kontext? O Flux Kontext Pro começa em 5 centavos de dólar por imagem. O Flux Kontext Max custa mais para maior fidelidade. Consulte a página de preços do RunAPI para as tarifas atuais — cobrança pay-as-you-go sem assinatura. ### O Flux Kontext consegue editar texto diretamente em imagens? Sim. Passe a imagem original como image_url e escreva algo como "change the sign text to OPEN" no prompt. O modelo renderiza o novo texto na mesma posição e estilo do original, o que funciona bem para mockups de rótulos e fachadas. - [Guia de configuração do WorkBuddy →](https://runapi.ai/pt-BR/workbuddy.md) - Ainda não conectado? Comece com o guia de configuração do RunAPI MCP para WorkBuddy. - [Modelos Flux Kontext →](https://runapi.ai/pt-BR/models/flux-kontext.md) - Veja todas as variantes, preços e documentação da API do Flux Kontext. ## Experimente o Flux Kontext no WorkBuddy hoje mesmo. Obtenha uma chave RunAPI gratuita, adicione o servidor MCP ao WorkBuddy e comece a gerar e editar imagens com o Flux Kontext. [Explorar modelos →](https://runapi.ai/pt-BR/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/pt-BR/.md) ### Produto - [Catálogo de modelos](https://runapi.ai/pt-BR/models.md) - [Preços](https://runapi.ai/pt-BR/pricing.md) - [Provedores](https://runapi.ai/pt-BR/models#all-models) ### Desenvolvedores - [Documentação](https://runapi.ai/pt-BR/docs/guides) - [SDKs](https://runapi.ai/pt-BR/sdk.md) - [CLI](https://runapi.ai/pt-BR/cli.md) - [Servidor MCP](https://runapi.ai/pt-BR/mcp.md) - [x402](https://runapi.ai/pt-BR/x402.md) ### Guias - [Claude Code vs Cursor](https://runapi.ai/pt-BR/claude-code-vs-cursor.md) - [Configuração da API do Cursor](https://runapi.ai/pt-BR/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/pt-BR/openrouter-alternative.md) ### Empresa - [Enterprise](https://runapi.ai/pt-BR/contact.md) - [Contato](https://runapi.ai/pt-BR/contact.md) ### Legal - [Termos](https://runapi.ai/pt-BR/terms.md) - [Privacidade](https://runapi.ai/pt-BR/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/pt-BR", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/pt-BR/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/pt-BR", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/pt-BRicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "SoftwareApplication", "name": "RunAPI Flux Kontext para WorkBuddy", "applicationCategory": "DeveloperApplication", "description": "Gere e edite imagens com o Flux Kontext no WorkBuddy via MCP com RunAPI. Uma API key, edição orientada por texto e consistência de personagem direto do workbench.", "url": "https://runapi.ai/pt-BR/workbuddy-flux-kontext" }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Posso usar o Flux Kontext no WorkBuddy?", "acceptedAnswer": { "@type": "Answer", "text": "Sim. Adicione o RunAPI como um servidor MCP no WorkBuddy e peça ao agente para chamar a ferramenta text_to_image com o modelo definido como flux-kontext-pro. A mesma RUNAPI_API_KEY que você usa para chat cuida da geração de imagens." } }, { "@type": "Question", "name": "Preciso de uma chave de API separada para o Flux Kontext?", "acceptedAnswer": { "@type": "Answer", "text": "Não. A mesma RUNAPI_API_KEY funciona para todos os modelos RunAPI — LLM, imagem, vídeo e música. Um servidor MCP, uma chave, uma conta de cobrança." } }, { "@type": "Question", "name": "Quem gerencia o polling de tarefas assíncronas no WorkBuddy?", "acceptedAnswer": { "@type": "Answer", "text": "O servidor RunAPI MCP. As tarefas do Flux Kontext são assíncronas, mas o servidor acompanha cada tarefa até a conclusão e retorna a URL da imagem finalizada ao WorkBuddy, sem polling manual." } }, { "@type": "Question", "name": "Quanto custa o Flux Kontext?", "acceptedAnswer": { "@type": "Answer", "text": "O Flux Kontext Pro começa em 5 centavos de dólar por imagem. O Flux Kontext Max custa mais para maior fidelidade. Consulte a página de preços do RunAPI para as tarifas atuais — cobrança pay-as-you-go sem assinatura." } }, { "@type": "Question", "name": "O Flux Kontext consegue editar texto diretamente em imagens?", "acceptedAnswer": { "@type": "Answer", "text": "Sim. Passe a imagem original como image_url e escreva algo como \"change the sign text to OPEN\" no prompt. O modelo renderiza o novo texto na mesma posição e estilo do original, o que funciona bem para mockups de rótulos e fachadas." } } ] }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "HowTo", "name": "Como usar o Flux Kontext no WorkBuddy via RunAPI", "description": "Adicione o RunAPI como um servidor MCP no WorkBuddy, instrua o agente do workbench a chamar a ferramenta text_to_image do Flux Kontext e receba a URL da imagem gerada.", "step": [ { "@type": "HowToStep", "position": 1, "name": "Adicione o servidor MCP do RunAPI", "text": "Registre um servidor MCP chamado runapi no WorkBuddy, apontando para https://runapi.ai/mcp via HTTP streamable, com o cabeçalho Authorization lendo sua chave de RUNAPI_API_KEY. Se você já conectou o RunAPI para chat, o Flux Kontext é exposto no mesmo servidor — sem configuração extra.", "url": "https://runapi.ai/pt-BR/workbuddy-flux-kontext#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "Instrua o agente da bancada de trabalho", "text": "Peça ao WorkBuddy para chamar a ferramenta text_to_image do RunAPI com o modelo definido como flux-kontext-pro. Descreva a imagem desejada ou passe uma image_url com uma instrução de edição para edição em contexto.", "url": "https://runapi.ai/pt-BR/workbuddy-flux-kontext#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "Obtenha o resultado", "text": "O servidor MCP cria a tarefa, acompanha até a conclusão e entrega a URL da imagem final ao WorkBuddy. O agente exibe a URL na conversa — sem polling manual da sua parte.", "url": "https://runapi.ai/pt-BR/workbuddy-flux-kontext#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Início", "item": "https://runapi.ai/pt-BR" }, { "@type": "ListItem", "position": 2, "name": "RunAPI Flux Kontext para WorkBuddy", "item": "https://runapi.ai/pt-BR/workbuddy-flux-kontext" } ] } ] ```