Flux Kontext API
Acesso à API do Flux Kontext para edição in-context de imagens, edições locais, transferência de estilo e consistência de personagem.
curl -X POST https://runapi.ai/api/v1/flux_kontext/text_to_image \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-kontext-max",
"prompt": "Edite esta foto de produto: mude o fundo para uma praia tropical mantendo o produto exatamente igual."
}'
import { FluxKontextClient } from "@runapi.ai/flux-kontext";
const client = new FluxKontextClient();
const result = await client.textToImage.run({
model: "flux-kontext-max",
prompt: "Edite esta foto de produto: mude o fundo para uma praia tropical mantendo o produto exatamente igual.",
});
<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\FluxKontext\FluxKontextClient;
$client = new FluxKontextClient();
$result = $client->textToImage->run([
'model' => 'flux-kontext-max',
'prompt' => 'Edite esta foto de produto: mude o fundo para uma praia tropical mantendo o produto exatamente igual.',
]);
require "runapi/flux_kontext"
client = RunApi::FluxKontext::Client.new
result = client.text_to_image.run(
model: "flux-kontext-max",
prompt: "Edite esta foto de produto: mude o fundo para uma praia tropical mantendo o produto exatamente igual."
)
npx skills add runapi-ai/flux-kontext -g
# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
Flux Kontext é o modelo de edição in-context do Black Forest Labs que aplica edições direcionadas preservando estilo, identidade do personagem e composição de cena. Destaca-se em transferência de estilo e manutenção de consistência visual.
- Variantes para diferentes metas de qualidade e latência
- API key unificada
- O model skill inclui documentação, schemas e notas de setup
- Gerações com falha não são cobradas
Variantes
Instale o skill Flux Kontext para desenvolver apps
Carregue documentação do modelo, schemas, notas de preço e etapas de setup no seu workspace de código.
# Install the model skill for app development workflows
npx skills add runapi-ai/flux-kontext -g
Install the Flux Kontext skill for this app: 1. Add runapi-ai/flux-kontext with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
Como construir com este model skill
Escolha o modelo
Selecione o modelo e a variante que combinam com seu tipo de saída, meta de qualidade e latência.
Autentique uma vez
Use sua chave RunAPI para todos os modelos compatíveis.
Instale o skill
Adicione o model skill ao workspace de código antes de implementar a funcionalidade.
Receba a saída
Consulte por task ID ou trate o callback quando a geração terminar.
Onde Flux Kontext se encaixa
Flux Kontext é o modelo de edição com consciência contextual do Black Forest Labs, baseado na arquitetura Flux de 12B parâmetros. Pelo RunAPI, os variants Kontext Pro e Max compartilham uma única key.
Por que usar Flux Kontext pela RunAPI
Uma API key
Use as mesmas credenciais entre modelos e provedores.
Pronto para skills
O model skill inclui schemas, notas de setup, contexto de preços e IDs de modelo.
Cobrança previsível
O preço por uso fica visível antes da chamada.
Perguntas frequentes
O que é edição contextual?
Flux Kontext edita uma região específica de uma imagem preservando a iluminação, perspectiva e estilo das áreas não tocadas.
Qual a diferença entre Pro e Max?
Pro é o tier padrão para a maioria das tarefas de edição. Max oferece maior fidelidade e é adequado para edições complexas com múltiplos elementos.
Quais formatos de entrada são suportados?
JPEG, PNG e WebP. Mantenha imagens de entrada abaixo de 10 MB para performance ideal.
Posso manter a identidade do personagem entre edições?
Sim — Kontext é projetado para preservar consistência de personagem ao editar fundos, roupas ou elementos de cena.
Qual é a velocidade de geração?
Tipicamente 3–5 segundos por imagem, dependendo da complexidade e do variant.
Como chamo este modelo?
Instale o model skill e siga as notas de setup com sua chave RunAPI.
Gerações com falha custam dinheiro?
Gerações com falha não são cobradas
Posso chamar a partir da minha aplicação?
Sim. Instale o model skill no workspace de código e use durante a implementação da funcionalidade.