logo
RunComfy
  • ComfyUI
  • TreinadorNovo
  • Modelos
  • API
  • Preços
discord logo
MODELOS
Explorar
Todos os modelos
BIBLIOTECA
Gerações
APIS DE MODELOS
Documentação da API
Chaves API
CONTA
Uso

FLUX 3 Image Edit: Edição de Imagem com Múltiplas Referências até 4K em Models and API | RunComfy

blackforestlabs/flux-3/edit

FLUX 3 Image Edit transforma de uma a dez fotos de referência e uma instrução escrita em uma nova imagem estática em 1K, 2K ou 4K.

Índice

1. Introdução2. Autenticação3. Referência da APIEnviar uma solicitaçãoStatus da solicitaçãoObter resultadosCancelar solicitação4. Arquivos de entradaArquivo hospedado (URL)5. EsquemaEsquema de entradaEsquema de saída

1. Introdução

Use a API RunComfy para executar blackforestlabs/flux-3/edit. Para entradas e saídas aceitas, consulte o esquema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-3/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "images": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7463/media-files/promo-input.webp"
    ],
    "prompt": "Turn image 1 into a furniture campaign advertisement. Keep the same ceramic table lamp: the round speckled white base and the oatmeal linen shade. Switch the lamp on so warm light glows through the shade. Place it on a low oak side table in a dim evening living room, with a soft pool of light on the wall and a blurred window showing blue dusk. Add the headline \"AFTER HOURS\" in cream serif at the upper left, and \"CERAMIC LAMP\" in small spaced capitals beneath it. Do not change the lamp's shape."
  }'

2. Autenticação

Defina a variável de ambiente YOUR_API_TOKEN com sua chave de API (gerenciamento no Perfil) e inclua em cada solicitação um token Bearer no cabeçalho Authorization : Authorization: Bearer $YOUR_API_TOKEN.

3. Referência da API

Enviar uma solicitação

Envie um trabalho de geração assíncrono e receba imediatamente um request_id e URLs para status, resultados e cancelamento.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-3/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "images": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7463/media-files/promo-input.webp"
    ],
    "prompt": "Turn image 1 into a furniture campaign advertisement. Keep the same ceramic table lamp: the round speckled white base and the oatmeal linen shade. Switch the lamp on so warm light glows through the shade. Place it on a low oak side table in a dim evening living room, with a soft pool of light on the wall and a blurred window showing blue dusk. Add the headline \"AFTER HOURS\" in cream serif at the upper left, and \"CERAMIC LAMP\" in small spaced capitals beneath it. Do not change the lamp's shape."
  }'

Status da solicitação

Obtém o estado atual de um request_id ("in_queue", "in_progress", "completed" ou "cancelled").

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

Obter resultados

Obtém as saídas finais e metadados do request_id; se o trabalho não estiver concluído, a resposta retorna o estado atual para continuar o polling.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

Cancelar solicitação

Cancela um trabalho na fila por request_id; trabalhos em andamento não podem ser cancelados.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. Arquivos de entrada

Arquivo hospedado (URL)

Forneça uma URL HTTPS publicamente acessível. O host deve permitir buscas no servidor (sem login/cookies), sem limite de taxa agressivo ou bloqueio de bots. Recomendado: imagens ≤ 50 MB (~4K), vídeos ≤ 100 MB (~2–5 min em 720p). Para ativos privados, URLs estáveis ou pré-assinadas.

5. Esquema

Esquema de entrada

{
  "type": "object",
  "title": "Esquema de entrada",
  "required": [
    "images",
    "prompt"
  ],
  "properties": {
    "images": {
      "title": "Imagens",
      "description": "De uma a dez imagens de origem, na ordem em que a instrução as nomeia. Cada lado deve ter pelo menos 256 pixels, e cada imagem não deve ser maior que 4 megapixels.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "minItems": 1,
      "maxItems": 10,
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7463/media-files/promo-input.webp"
      ]
    },
    "prompt": {
      "title": "Prompt",
      "description": "O que deve mudar e o que deve permanecer. Nomeie os uploads em ordem, como imagem 1 e imagem 2. Coloque exatamente o texto da imagem entre aspas.",
      "type": "string",
      "default": "Turn image 1 into a furniture campaign advertisement. Keep the same ceramic table lamp: the round speckled white base and the oatmeal linen shade. Switch the lamp on so warm light glows through the shade. Place it on a low oak side table in a dim evening living room, with a soft pool of light on the wall and a blurred window showing blue dusk. Add the headline \"AFTER HOURS\" in cream serif at the upper left, and \"CERAMIC LAMP\" in small spaced capitals beneath it. Do not change the lamp's shape."
    },
    "aspect_ratio": {
      "title": "Proporção",
      "description": "Quadro de saída. auto segue a primeira imagem.",
      "type": "string",
      "enum": [
        "auto",
        "21:9",
        "2:1",
        "16:9",
        "3:2",
        "7:5",
        "4:3",
        "5:4",
        "1:1",
        "4:5",
        "3:4",
        "5:7",
        "2:3",
        "9:16",
        "1:2"
      ],
      "default": "auto"
    },
    "resolution": {
      "title": "Resolução",
      "description": "Nível de tamanho de saída. Esta é a única configuração que altera o preço.",
      "type": "string",
      "enum": [
        "1k",
        "2k",
        "4k"
      ],
      "default": "1k"
    },
    "enable_prompt_expansion": {
      "title": "Ativar expansão de prompt",
      "description": "Expanda uma instrução curta mantendo a edição pretendida e o papel de cada imagem.",
      "type": "boolean",
      "default": false
    },
    "output_format": {
      "title": "Formato de saída",
      "description": "Tipo de arquivo do arquivo estático retornado. png evita compressão extra JPEG.",
      "type": "string",
      "enum": [
        "jpeg",
        "png"
      ],
      "default": "jpeg"
    }
  }
}

Esquema de saída

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL de imagem única"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL de vídeo único"
      },
      "images": {
        "type": "array",
        "description": "várias URLs de imagem",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "várias URLs de vídeo",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}
Siga-nos
  • LinkedIn
  • Facebook
  • Instagram
  • Twitter
Suporte
  • Discord
  • E-mail
  • Status do Sistema
  • afiliado
Modelos de Vídeo
  • Wan 2.6 Flash
  • Wan 2.5
  • Wan 3.0
  • MiniMax H3 Max
  • Wan 3.0 Prime
  • MiniMax H3 Open Image to Video
  • Ver todos os modelos →
Modelos de Imagem
  • Wan 2.6 Image to Image
  • Seedream 5.0 Pro
  • Nano Banana Pro
  • Flux 2 Pro
  • Z Image Turbo LoRA
  • seedream 4.0
  • Ver todos os modelos →
Legal
  • Termos de Serviço
  • Política de Privacidade
  • Política de Cookies
RunComfy
Copyright 2026 RunComfy. Todos os Direitos Reservados.

RunComfy é a principal ComfyUI plataforma, oferecendo ComfyUI online ambiente e serviços, juntamente com fluxos de trabalho do ComfyUI apresentando visuais impressionantes. RunComfy também oferece AI Models, permitindo que artistas utilizem as mais recentes ferramentas de AI para criar arte incrível.