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

Edição de imagem GPT Image 2: edição imagem a imagem de alta fidelidade no playground e API | Models and API | RunComfy

openai/gpt-image-2/edit

Transforme imagens de origem em visuais 4K sofisticados com texto multilíngue, pintura precisa e edições prontas para a marca para atualizações rápidas de produtos, campanhas e fluxos de trabalho de design criativo.

Í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 openai/gpt-image-2/edit. Para entradas e saídas aceitas, consulte o esquema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/openai/gpt-image-2/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Turn the background into a bright, minimal white-to-soft-gray studio sweep with gentle floor shadow; add a large headline in-image that reads 'OPEN STUDIO' in a bold, clean sans-serif, high contrast, centered; keep the main person or product, pose, and face identity unchanged",
    "images": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7341/media-files/promo.webp"
    ]
  }'

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/openai/gpt-image-2/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Turn the background into a bright, minimal white-to-soft-gray studio sweep with gentle floor shadow; add a large headline in-image that reads 'OPEN STUDIO' in a bold, clean sans-serif, high contrast, centered; keep the main person or product, pose, and face identity unchanged",
    "images": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7341/media-files/promo.webp"
    ]
  }'

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": [
    "prompt",
    "images"
  ],
  "properties": {
    "images": {
      "title": "Imagens",
      "description": "Imagens de referência para editar, até 10 imagens",
      "type": "array",
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "maxItems": 10,
      "minItems": 1,
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7341/media-files/promo.webp"
      ]
    },
    "prompt": {
      "title": "Prompt",
      "description": "",
      "type": "string",
      "default": "Turn the background into a bright, minimal white-to-soft-gray studio sweep with gentle floor shadow; add a large headline in-image that reads 'OPEN STUDIO' in a bold, clean sans-serif, high contrast, centered; keep the main person or product, pose, and face identity unchanged"
    },
    "aspect_ratio": {
      "title": "Proporção",
      "description": "Proporção da imagem editada. Detectado automaticamente na imagem de entrada, se omitido.",
      "type": "string",
      "enum": [
        "1:1",
        "3:2",
        "2:3",
        "3:4",
        "4:3",
        "4:5",
        "5:4",
        "9:16",
        "16:9",
        "21:9"
      ],
      "default": "1:1"
    },
    "resolution": {
      "title": "Resolução",
      "description": "Resolução de saída.",
      "type": "string",
      "enum": [
        "1k",
        "2k",
        "4k"
      ],
      "default": "1k"
    },
    "quality": {
      "title": "Qualidade",
      "description": "Qualidade de imagem.",
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high"
      ],
      "default": "medium"
    },
    "output_format": {
      "title": "Formato de saída",
      "description": "Formato de imagem de saída.",
      "type": "string",
      "enum": [
        "png",
        "jpeg",
        "webp"
      ],
      "default": "png"
    }
  }
}

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
  • Gemini Omni Flash Video Edit
  • Gemini Omni Flash Image to Video
  • Gemini Omni Flash Reference to Video
  • Wan 2.6 Flash
  • Seedance 2.0 Pro
  • Wan 2.7 Reference to Video
  • Ver todos os modelos →
Modelos de Imagem
  • Seedream 5.0 Pro Image Edit
  • seedream 4.0
  • Nano Banana 2 Edit
  • Nano Banana Pro
  • GPT Image 2 Image Edit
  • GPT Image 2
  • 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.