{"id":20175,"date":"2026-09-29T09:28:35","date_gmt":"2026-09-29T13:28:35","guid":{"rendered":"https:\/\/wp.glbgpt.com\/?p=20175"},"modified":"2026-09-29T09:28:36","modified_gmt":"2026-09-29T13:28:36","slug":"openai-image-edit-api","status":"publish","type":"post","link":"https:\/\/wp.glbgpt.com\/pt-br\/hub\/openai-image-edit-api","title":{"rendered":"API de edi\u00e7\u00e3o de imagens OpenAI: m\u00e1scaras, par\u00e2metros, pre\u00e7os e fluxos de trabalho GlobalGPT"},"content":{"rendered":"<p class=\"wp-block-paragraph\"><strong>A API de edi\u00e7\u00e3o de imagens OpenAI altera uma imagem existente a partir de um prompt.<\/strong> A rota nativa \u00e9 <code>POST \/v1\/images\/edits<\/code>; ela aceita uma imagem, um prompt e controles de edi\u00e7\u00e3o opcionais, como uma m\u00e1scara ou imagens de refer\u00eancia. Use a API de Imagens para uma solicita\u00e7\u00e3o espec\u00edfica e use a API de Respostas quando o produto precisar de um fluxo de trabalho de imagem com v\u00e1rias etapas.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Uma edi\u00e7\u00e3o confi\u00e1vel \u00e9 um pequeno fluxo de trabalho: congelar o arquivo de origem, definir o que deve permanecer, definir o que pode ser alterado, inspecionar os bytes retornados e salvar o recurso aprovado. Se voc\u00ea preferir alternar entre modelos de imagem e outras ferramentas de m\u00eddia em um \u00fanico espa\u00e7o de trabalho, <a href=\"https:\/\/www.glbgpt.com\/image-generator\/gpt-image-2?inviter=hub_content_gpt_image_2&amp;login=1\">Crie e edite imagens com o GPT Image 2 em GlobalGPT<\/a>; sua API p\u00fablica utiliza um contrato de tarefa ass\u00edncrona diferente, que este guia distingue do endpoint nativo do OpenAI.<\/p>\n\n\n\n<div class=\"wp-block-group is-layout-constrained wp-block-group-is-layout-constrained\">\n<figure class=\"wp-block-image size-large\"><a href=\"https:\/\/www.glbgpt.com\/image?inviter=hub_features_image&amp;login=1\"><img alt=\"\" fetchpriority=\"high\" decoding=\"async\" width=\"1024\" height=\"621\" src=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/01\/new-image-gen-1024x621.png\" class=\"wp-image-18222\" srcset=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/01\/new-image-gen-1024x621.png 1024w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/01\/new-image-gen-300x182.png 300w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/01\/new-image-gen-768x465.png 768w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/01\/new-image-gen-1536x931.png 1536w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/01\/new-image-gen-2048x1241.png 2048w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/01\/new-image-gen-18x12.png 18w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/a><\/figure>\n\n\n\n<div class=\"wp-block-buttons is-content-justification-center is-layout-flex wp-container-core-buttons-is-layout-3e41869c wp-block-buttons-is-layout-flex\">\n<div class=\"wp-block-button\"><a class=\"wp-block-button__link has-luminous-vivid-amber-background-color has-background wp-element-button\" href=\"https:\/\/www.glbgpt.com\/image?inviter=hub_features_image&amp;login=1\">Experimente v\u00e1rios modelos de imagem principal no GlobalGPT<\/a><\/div>\n<\/div>\n<\/div>\n\n\n\n<div class=\"oie-quick\" style=\"box-sizing:border-box;background:#102b46;color:#fff;border-radius:8px;padding:24px;margin:26px 0;font:16px\/1.65 system-ui,-apple-system,sans-serif;max-width:100%;min-width:0;\"><h2 style=\"color:#fff;margin-top:0;box-sizing:border-box;line-height:1.3;\">Resposta r\u00e1pida: escolha a abordagem antes de escrever o c\u00f3digo<\/h2><div class=\"oie-scroll\" style=\"overflow-x:auto;box-sizing:border-box;\"><table style=\"color:#fff;border-collapse:collapse;width:100%;min-width:700px;box-sizing:border-box;\"><thead style=\"box-sizing:border-box;\"><tr style=\"box-sizing:border-box;\"><th style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;border-color:#49637d;box-sizing:border-box;\">Necessidade<\/th><th style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;border-color:#49637d;box-sizing:border-box;\">Rota<\/th><th style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;border-color:#49637d;box-sizing:border-box;\">Solicitar formato<\/th><th style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;border-color:#49637d;box-sizing:border-box;\">Resultado a ser tratado<\/th><\/tr><\/thead><tbody style=\"box-sizing:border-box;\"><tr style=\"box-sizing:border-box;\"><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;border-color:#49637d;box-sizing:border-box;\">Uma gera\u00e7\u00e3o ou edi\u00e7\u00e3o de imagem<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;border-color:#49637d;box-sizing:border-box;\">API de imagem da OpenAI<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;border-color:#49637d;box-sizing:border-box;\"><code style=\"background:#eef3f8;padding:2px 5px;border-radius:4px;font-size:.92em;box-sizing:border-box;color:#18364a;\">POST \/v1\/images\/edits<\/code>, formul\u00e1rio com v\u00e1rias partes<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;border-color:#49637d;box-sizing:border-box;\"><code style=\"background:#eef3f8;padding:2px 5px;border-radius:4px;font-size:.92em;box-sizing:border-box;color:#18364a;\">data[0].b64_json<\/code>; decodific\u00e1-la e armazen\u00e1-la<\/td><\/tr><tr style=\"box-sizing:border-box;\"><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;border-color:#49637d;box-sizing:border-box;\">V\u00e1rias voltas com contexto de imagem<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;border-color:#49637d;box-sizing:border-box;\">API de respostas OpenAI<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;border-color:#49637d;box-sizing:border-box;\"><code style=\"background:#eef3f8;padding:2px 5px;border-radius:4px;font-size:.92em;box-sizing:border-box;color:#18364a;\">POST \/v1\/responses<\/code> com ferramenta de gera\u00e7\u00e3o de imagens<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;border-color:#49637d;box-sizing:border-box;\">Extrair o item de sa\u00edda da gera\u00e7\u00e3o de imagens<\/td><\/tr><tr style=\"box-sizing:border-box;\"><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;border-color:#49637d;box-sizing:border-box;\">V\u00e1rios perfis de m\u00eddia social associados a uma \u00fanica conta<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;border-color:#49637d;box-sizing:border-box;\">API p\u00fablica GlobalGPT<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;border-color:#49637d;box-sizing:border-box;\"><code style=\"background:#eef3f8;padding:2px 5px;border-radius:4px;font-size:.92em;box-sizing:border-box;color:#18364a;\">POST \/tasks<\/code>, em seguida, fazer a sondagem <code style=\"background:#eef3f8;padding:2px 5px;border-radius:4px;font-size:.92em;box-sizing:border-box;color:#18364a;\">GET \/tasks\/{id}<\/code><\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;border-color:#49637d;box-sizing:border-box;\"><code style=\"background:#eef3f8;padding:2px 5px;border-radius:4px;font-size:.92em;box-sizing:border-box;color:#18364a;\">output.url<\/code>; salve-o antes que o prazo de 30 dias termine<\/td><\/tr><\/tbody><\/table><\/div><p class=\"oie-note\" style=\"box-sizing:border-box;background:#f0f5f9;border-left:4px solid #5d7d99;padding:13px 16px;color:#27445f;margin:12px 0;\">Os nomes dos endpoints parecem semelhantes, mas os corpos das solicita\u00e7\u00f5es e o tratamento dos resultados n\u00e3o s\u00e3o intercambi\u00e1veis.<\/p><\/div>\n\n\n\n<nav class=\"oie-toc\" style=\"box-sizing:border-box;background:#eef6ff;border:1px solid #c6dbee;border-top:4px solid #2a6ca8;border-radius:6px;padding:20px;margin:28px 0;font:16px\/1.65 system-ui,-apple-system,sans-serif;max-width:100%;min-width:0;color:#17323f;\"><strong style=\"display:block;margin-bottom:8px;box-sizing:border-box;\">Nesta p\u00e1gina<\/strong><ol style=\"columns:18rem 2;margin:0;padding-left:22px;box-sizing:border-box;\"><li style=\"box-sizing:border-box;\"><a href=\"#what-is-image-edit-api\" style=\"color:#145ea8;box-sizing:border-box;\">O que a API de edi\u00e7\u00e3o de imagens faz<\/a><\/li><li style=\"box-sizing:border-box;\"><a href=\"#native-first-edit\" style=\"color:#145ea8;box-sizing:border-box;\">Fa\u00e7a uma primeira edi\u00e7\u00e3o no idioma original<\/a><\/li><li style=\"box-sizing:border-box;\"><a href=\"#masks-and-references\" style=\"color:#145ea8;box-sizing:border-box;\">Use m\u00e1scaras e imagens de refer\u00eancia<\/a><\/li><li style=\"box-sizing:border-box;\"><a href=\"#models-and-parameters\" style=\"color:#145ea8;box-sizing:border-box;\">Escolha modelos e par\u00e2metros<\/a><\/li><li style=\"box-sizing:border-box;\"><a href=\"#image-edit-pricing\" style=\"color:#145ea8;box-sizing:border-box;\">Entenda os pre\u00e7os<\/a><\/li><li style=\"box-sizing:border-box;\"><a href=\"#globalgpt-contract\" style=\"color:#145ea8;box-sizing:border-box;\">Utilize a rota de tarefas GlobalGPT<\/a><\/li><li style=\"box-sizing:border-box;\"><a href=\"#tested-workflow\" style=\"color:#145ea8;box-sizing:border-box;\">Leia o teste do modelo GlobalGPT<\/a><\/li><li style=\"box-sizing:border-box;\"><a href=\"#image-edit-errors\" style=\"color:#145ea8;box-sizing:border-box;\">Lidar com erros e respostas lentas<\/a><\/li><li style=\"box-sizing:border-box;\"><a href=\"#faq\" style=\"color:#145ea8;box-sizing:border-box;\">PERGUNTAS FREQUENTES<\/a><\/li><\/ol><\/nav>\n\n\n\n<h2 id=\"what-is-image-edit-api\" class=\"wp-block-heading\">O que a API de edi\u00e7\u00e3o de imagens OpenAI faz?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">O processo de edi\u00e7\u00e3o come\u00e7a com uma imagem existente. Sua solicita\u00e7\u00e3o descreve a altera\u00e7\u00e3o, enquanto a imagem de entrada fornece o contexto visual que deve ser mantido ap\u00f3s a edi\u00e7\u00e3o. Voc\u00ea pode substituir um plano de fundo, adicionar ou remover um elemento, fazer uma reformula\u00e7\u00e3o mais ampla ou passar mais de uma imagem como refer\u00eancia. O modelo ainda interpreta a solicita\u00e7\u00e3o; a API n\u00e3o \u00e9 um editor de pixels com um limite de sele\u00e7\u00e3o garantido.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">O documento OpenAI descreve dois fluxos de trabalho \u00fateis. O <strong>API de imagens<\/strong> \u00e9 a op\u00e7\u00e3o ideal quando uma solicita\u00e7\u00e3o deve retornar uma imagem. O <strong>API de respostas<\/strong> \u00e9 a op\u00e7\u00e3o mais adequada quando um usu\u00e1rio analisa o resultado, solicita outra altera\u00e7\u00e3o e mant\u00e9m o contexto da imagem ao longo das itera\u00e7\u00f5es. Essa escolha afeta tanto a estrutura da solicita\u00e7\u00e3o quanto o c\u00f3digo que extrai o resultado.<\/p>\n\n\n\n<div class=\"oie-table\" style=\"box-sizing:border-box;background:#f5f8fb;border:1px solid #d7e0e9;border-top:4px solid #4f759a;border-radius:6px;padding:18px;margin:24px 0;font:16px\/1.65 system-ui,-apple-system,sans-serif;max-width:100%;min-width:0;color:#17323f;\"><h3 style=\"margin:0 0 12px;box-sizing:border-box;line-height:1.3;\">API de Imagens versus API de Respostas<\/h3><div class=\"oie-scroll\" style=\"overflow-x:auto;box-sizing:border-box;\"><table style=\"border-collapse:collapse;width:100%;min-width:700px;box-sizing:border-box;\"><thead style=\"box-sizing:border-box;\"><tr style=\"box-sizing:border-box;\"><th style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;background:#e7eef5;color:#173b5d;box-sizing:border-box;\">Pergunta<\/th><th style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;background:#e7eef5;color:#173b5d;box-sizing:border-box;\">API de imagens<\/th><th style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;background:#e7eef5;color:#173b5d;box-sizing:border-box;\">API de respostas<\/th><\/tr><\/thead><tbody style=\"box-sizing:border-box;\"><tr style=\"box-sizing:border-box;\"><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Ideal para<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Uma \u00fanica a\u00e7\u00e3o de gera\u00e7\u00e3o ou edi\u00e7\u00e3o<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Uma experi\u00eancia de edi\u00e7\u00e3o em v\u00e1rias etapas<\/td><\/tr><tr style=\"box-sizing:border-box;\"><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Entrada t\u00edpica<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Imagem em v\u00e1rias partes, prompt, m\u00e1scara opcional<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Entrada de conversa\u00e7\u00e3o e ferramenta de gera\u00e7\u00e3o de imagens<\/td><\/tr><tr style=\"box-sizing:border-box;\"><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Tratamento da sa\u00edda<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\"><code style=\"background:#eef3f8;padding:2px 5px;border-radius:4px;font-size:.92em;box-sizing:border-box;color:#18364a;\">data[0].b64_json<\/code><\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Encontre o item de sa\u00edda da gera\u00e7\u00e3o de imagens<\/td><\/tr><tr style=\"box-sizing:border-box;\"><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Detalhes dos custos<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">A edi\u00e7\u00e3o direta utiliza as taxas atuais de entrada\/sa\u00edda<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">As regras de entrada armazenadas em cache podem variar; verifique os pre\u00e7os atuais<\/td><\/tr><\/tbody><\/table><\/div><\/div>\n\n\n\n<h2 id=\"native-first-edit\" class=\"wp-block-heading\">Fa\u00e7a uma primeira edi\u00e7\u00e3o usando a API nativa do OpenAI<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Mantenha a chave da API no seu servidor e carregue-a a partir de uma vari\u00e1vel de ambiente. O exemplo abaixo envia uma imagem e um prompt para o endpoint de edi\u00e7\u00f5es documentado. O <code>imagem[]<\/code> O campo pode ser repetido quando o modelo selecionado suporta v\u00e1rias entradas. O pipeline do shell decodifica a primeira imagem em base64 retornada, convertendo-a em um arquivo PNG local.<\/p>\n\n\n\n<div class=\"oie-code\" style=\"box-sizing:border-box;background:#0e1c2c;color:#edf6ff;border-radius:6px;padding:18px;margin:24px 0;font:16px\/1.65 system-ui,-apple-system,sans-serif;max-width:100%;min-width:0;\"><h3 style=\"color:#fff;margin:0 0 4px;box-sizing:border-box;line-height:1.3;\">Edi\u00e7\u00e3o nativa do Curl: salvar o resultado em formato b64_json<\/h3><div class=\"oie-code-label\" style=\"color:#a8c9df;font-size:12px;text-transform:uppercase;letter-spacing:.08em;box-sizing:border-box;\">bash<\/div><pre style=\"overflow-x:auto;white-space:pre-wrap;overflow-wrap:anywhere;background:#08131f;padding:14px;border-radius:4px;color:#edf6ff;font:13px\/1.6 ui-monospace,SFMono-Regular,Menlo,monospace;box-sizing:border-box;max-width:100%;\"><code style=\"background:none;padding:0;border-radius:4px;font-size:.92em;box-sizing:border-box;color:inherit;\">curl -s \\\n  -X POST \"https:\/\/api.openai.com\/v1\/images\/edits\" \\\n  -H \"Authorization: Bearer $OPENAI_API_KEY\" \\\n  -F \"model=gpt-image-2.5-sunburst\" \\\n  -F \"image[]=@source.png\" \\\n  -F \"prompt=Substitua apenas o fundo por uma cena de est\u00fadio em bege quente; mantenha o produto e a etiqueta inalterados.\" \\\n| jq -r '.data[0].b64_json' \\\n| base64 --decode &gt; edited.png<\/code><\/pre><\/div>\n\n\n\n<div class=\"oie-code\" style=\"box-sizing:border-box;background:#0e1c2c;color:#edf6ff;border-radius:6px;padding:18px;margin:24px 0;font:16px\/1.65 system-ui,-apple-system,sans-serif;max-width:100%;min-width:0;\"><h3 style=\"color:#fff;margin:0 0 4px;box-sizing:border-box;line-height:1.3;\">Edi\u00e7\u00e3o do SDK do Python: decodificar os bytes retornados<\/h3><div class=\"oie-code-label\" style=\"color:#a8c9df;font-size:12px;text-transform:uppercase;letter-spacing:.08em;box-sizing:border-box;\">Python<\/div><pre style=\"overflow-x:auto;white-space:pre-wrap;overflow-wrap:anywhere;background:#08131f;padding:14px;border-radius:4px;color:#edf6ff;font:13px\/1.6 ui-monospace,SFMono-Regular,Menlo,monospace;box-sizing:border-box;max-width:100%;\"><code style=\"background:none;padding:0;border-radius:4px;font-size:.92em;box-sizing:border-box;color:inherit;\">from openai import OpenAI\nimport base64\n\nclient = OpenAI()\nresult = client.images.edit(\n    model=\"gpt-image-2.5-sunburst\",\n    image=open(\"source.png\", \"rb\"),\n    prompt=\"Substitua apenas o fundo por um cen\u00e1rio de est\u00fadio em bege quente; mantenha o produto e a etiqueta inalterados.\",\n)\n\nimage_bytes = base64.b64decode(result.data[0].b64_json)\nwith open(\"edited.png\", \"wb\") as output:\n    output.write(image_bytes)<\/code><\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Antes de considerar essa produ\u00e7\u00e3o pronta, verifique o arquivo decodificado: confira seu tipo MIME, dimens\u00f5es, n\u00famero de bytes e se os detalhes visuais importantes ainda est\u00e3o presentes. Uma resposta 200 apenas indica que a solicita\u00e7\u00e3o foi aceita; ela n\u00e3o garante que a etiqueta, o logotipo ou a geometria do produto tenham sido preservados.<\/p>\n\n\n\n<h2 id=\"masks-and-references\" class=\"wp-block-heading\">Use m\u00e1scaras e imagens de refer\u00eancia com seguran\u00e7a<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Uma m\u00e1scara indica ao modelo qual \u00e1rea voc\u00ea deseja alterar, mas o mascaramento de imagens do GPT continua sendo baseado em prompts. O guia do OpenAI alerta explicitamente que o modelo usa a m\u00e1scara como orienta\u00e7\u00e3o, e n\u00e3o como um limite absoluto de pixels. Mantenha o prompt espec\u00edfico em rela\u00e7\u00e3o ao objeto protegido e revise a imagem inteira ap\u00f3s a gera\u00e7\u00e3o.<\/p>\n\n\n\n<div class=\"oie-checklist\" style=\"box-sizing:border-box;background:#fff8e9;border:1px solid #e8cf8f;border-left:5px solid #d39b19;border-radius:5px;padding:16px;margin:24px 0;font:16px\/1.65 system-ui,-apple-system,sans-serif;max-width:100%;min-width:0;color:#17323f;\"><h3 style=\"margin-top:0;box-sizing:border-box;line-height:1.3;\">Verifica\u00e7\u00e3o pr\u00e9via da m\u00e1scara<\/h3><ul style=\"box-sizing:border-box;\"><li style=\"box-sizing:border-box;\">A imagem e a m\u00e1scara utilizam o mesmo formato.<\/li><li style=\"box-sizing:border-box;\">A imagem e a m\u00e1scara t\u00eam as mesmas dimens\u00f5es.<\/li><li style=\"box-sizing:border-box;\">O arquivo da m\u00e1scara tem menos de 50 MB.<\/li><li style=\"box-sizing:border-box;\">A m\u00e1scara cont\u00e9m um canal alfa.<\/li><li style=\"box-sizing:border-box;\">A instru\u00e7\u00e3o indica o que deve permanecer inalterado e o que deve ser substitu\u00eddo.<\/li><\/ul><\/div>\n\n\n\n<div class=\"oie-code\" style=\"box-sizing:border-box;background:#0e1c2c;color:#edf6ff;border-radius:6px;padding:18px;margin:24px 0;font:16px\/1.65 system-ui,-apple-system,sans-serif;max-width:100%;min-width:0;\"><h3 style=\"color:#fff;margin:0 0 4px;box-sizing:border-box;line-height:1.3;\">Verifique a m\u00e1scara antes de envi\u00e1-la<\/h3><div class=\"oie-code-label\" style=\"color:#a8c9df;font-size:12px;text-transform:uppercase;letter-spacing:.08em;box-sizing:border-box;\">Python<\/div><pre style=\"overflow-x:auto;white-space:pre-wrap;overflow-wrap:anywhere;background:#08131f;padding:14px;border-radius:4px;color:#edf6ff;font:13px\/1.6 ui-monospace,SFMono-Regular,Menlo,monospace;box-sizing:border-box;max-width:100%;\"><code style=\"background:none;padding:0;border-radius:4px;font-size:.92em;box-sizing:border-box;color:inherit;\">from PIL import Image\n\nsource = Image.open(\"source.png\")\nmask = Image.open(\"mask.png\")\n\nassert source.format == mask.format, (source.format, mask.format)\nassert source.size == mask.size, (source.size, mask.size)\nassert mask.width * mask.height &gt; 0\nassert mask.mode in {\"RGBA\", \"LA\"}, mask.mode\nassert mask.fp is None or True  # verifique o tamanho do arquivo no disco separadamente\nprint(\"source:\", source.size, source.format)\nprint(\"m\u00e1scara:\", mask.size, mask.mode)<\/code><\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Se voc\u00ea passar v\u00e1rias imagens com uma m\u00e1scara, o guia atual indica que a m\u00e1scara se aplica \u00e0 primeira imagem. Essa \u00e9 uma orienta\u00e7\u00e3o \u00fatil para definir um fluxo de trabalho de refer\u00eancia: defina como primeira entrada o recurso cuja \u00e1rea voc\u00ea pretende editar e trate as imagens restantes como refer\u00eancias, em vez de presumir que a m\u00e1scara selecione todas elas.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">As imagens de refer\u00eancia resolvem um problema diferente. Elas podem fornecer uma identidade para o produto, um tipo de ilumina\u00e7\u00e3o, uma paleta de cores ou uma orienta\u00e7\u00e3o de composi\u00e7\u00e3o. Elas n\u00e3o obrigam o modelo a preservar todos os contornos. Se a forma exata da embalagem ou o r\u00f3tulo precisarem permanecer inalterados, utilize uma etapa de revis\u00e3o visual ou uma etapa de edi\u00e7\u00e3o convencional ap\u00f3s a gera\u00e7\u00e3o do modelo.<\/p>\n\n\n\n<h2 id=\"models-and-parameters\" class=\"wp-block-heading\">Escolha o modelo e os par\u00e2metros<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">A lista atual do guia de imagens OpenAI inclui <code>gpt-image-2.5-sunburst<\/code>, <code>gpt-image-2.5-flare<\/code>, e <code>gpt-image-2<\/code>. Trate os nomes dos modelos e as op\u00e7\u00f5es compat\u00edveis como documenta\u00e7\u00e3o em constante atualiza\u00e7\u00e3o: verifique a p\u00e1gina do modelo imediatamente antes de integr\u00e1-los e marque uma vers\u00e3o datada se a reprodutibilidade for importante.<\/p>\n\n\n\n<div class=\"oie-table\" style=\"box-sizing:border-box;background:#f5f8fb;border:1px solid #d7e0e9;border-top:4px solid #4f759a;border-radius:6px;padding:18px;margin:24px 0;font:16px\/1.65 system-ui,-apple-system,sans-serif;max-width:100%;min-width:0;color:#17323f;\"><h3 style=\"margin:0 0 12px;box-sizing:border-box;line-height:1.3;\">Decis\u00f5es sobre par\u00e2metros que evitam falhas evit\u00e1veis<\/h3><div class=\"oie-scroll\" style=\"overflow-x:auto;box-sizing:border-box;\"><table style=\"border-collapse:collapse;width:100%;min-width:700px;box-sizing:border-box;\"><thead style=\"box-sizing:border-box;\"><tr style=\"box-sizing:border-box;\"><th style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;background:#e7eef5;color:#173b5d;box-sizing:border-box;\">Decis\u00e3o<\/th><th style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;background:#e7eef5;color:#173b5d;box-sizing:border-box;\">Regra pr\u00e1tica<\/th><th style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;background:#e7eef5;color:#173b5d;box-sizing:border-box;\">Por que \u00e9 importante<\/th><\/tr><\/thead><tbody style=\"box-sizing:border-box;\"><tr style=\"box-sizing:border-box;\"><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Fidelidade da entrada<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Omitir <code style=\"background:#eef3f8;padding:2px 5px;border-radius:4px;font-size:.92em;box-sizing:border-box;color:#18364a;\">fidelidade_de_entrada<\/code> para <code style=\"background:#eef3f8;padding:2px 5px;border-radius:4px;font-size:.92em;box-sizing:border-box;color:#18364a;\">gpt-image-2<\/code>; suas entradas de imagem s\u00e3o processadas com alta fidelidade.<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">O envio de um campo n\u00e3o compat\u00edvel pode transformar uma edi\u00e7\u00e3o v\u00e1lida em uma solicita\u00e7\u00e3o rejeitada.<\/td><\/tr><tr style=\"box-sizing:border-box;\"><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Qualidade<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Documento sobre as rotas 2.5 Sunburst e Flare <code style=\"background:#eef3f8;padding:2px 5px;border-radius:4px;font-size:.92em;box-sizing:border-box;color:#18364a;\">baixo<\/code>, <code style=\"background:#eef3f8;padding:2px 5px;border-radius:4px;font-size:.92em;box-sizing:border-box;color:#18364a;\">m\u00e9dio<\/code>, <code style=\"background:#eef3f8;padding:2px 5px;border-radius:4px;font-size:.92em;box-sizing:border-box;color:#18364a;\">alto<\/code>, <code style=\"background:#eef3f8;padding:2px 5px;border-radius:4px;font-size:.92em;box-sizing:border-box;color:#18364a;\">xalto<\/code>, e <code style=\"background:#eef3f8;padding:2px 5px;border-radius:4px;font-size:.92em;box-sizing:border-box;color:#18364a;\">m\u00e1x.<\/code>.<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Uma configura\u00e7\u00e3o mais alta \u00e9 uma escolha entre custo e lat\u00eancia, n\u00e3o uma garantia de melhor preserva\u00e7\u00e3o.<\/td><\/tr><tr style=\"box-sizing:border-box;\"><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Formato<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Verifique qual \u00e9 o formato de sa\u00edda documentado pelo endpoint atual e, em seguida, analise o arquivo decodificado.<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Seu pipeline de armazenamento deve se basear nos bytes e no tipo MIME, e n\u00e3o apenas na op\u00e7\u00e3o solicitada.<\/td><\/tr><tr style=\"box-sizing:border-box;\"><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Contexto<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Indique o plano de fundo desejado no prompt e utilize a op\u00e7\u00e3o de plano de fundo documentada, quando dispon\u00edvel.<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">O modelo ainda interpreta a cena; mantenha as restri\u00e7\u00f5es do objeto expl\u00edcitas.<\/td><\/tr><tr style=\"box-sizing:border-box;\"><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Refer\u00eancias<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Use uma imagem de refer\u00eancia para orientar a identidade, a cor ou a ilumina\u00e7\u00e3o e definir a fun\u00e7\u00e3o de cada elemento.<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Pap\u00e9is amb\u00edguos das imagens dificultam o diagn\u00f3stico do desvio.<\/td><\/tr><\/tbody><\/table><\/div><\/div>\n\n\n\n<h2 id=\"image-edit-pricing\" class=\"wp-block-heading\">Quanto custa a API de edi\u00e7\u00e3o de imagens OpenAI?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">O OpenAI cobra pelo uso da GPT Image com base em categorias de tokens, em vez de um pre\u00e7o fixo universal por edi\u00e7\u00e3o. A p\u00e1gina atual de pre\u00e7os lista tarifas separadas para entrada de imagem, entrada em cache e sa\u00edda de imagem. As edi\u00e7\u00f5es diretas na API de Imagens n\u00e3o recebem o tratamento de entrada em cache documentado para a ferramenta de gera\u00e7\u00e3o de imagens na API de Respostas; portanto, n\u00e3o copie uma estimativa da API de Respostas para uma chamada direta <code>\/v1\/imagens\/edi\u00e7\u00f5es<\/code> or\u00e7amento.<\/p>\n\n\n\n<div class=\"oie-table\" style=\"box-sizing:border-box;background:#f5f8fb;border:1px solid #d7e0e9;border-top:4px solid #4f759a;border-radius:6px;padding:18px;margin:24px 0;font:16px\/1.65 system-ui,-apple-system,sans-serif;max-width:100%;min-width:0;color:#17323f;\"><h3 style=\"margin:0 0 12px;box-sizing:border-box;line-height:1.3;\">Taxas de tokens de imagem publicadas, verificadas em 28\/09\/2026<\/h3><div class=\"oie-scroll\" style=\"overflow-x:auto;box-sizing:border-box;\"><table style=\"border-collapse:collapse;width:100%;min-width:700px;box-sizing:border-box;\"><thead style=\"box-sizing:border-box;\"><tr style=\"box-sizing:border-box;\"><th style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;background:#e7eef5;color:#173b5d;box-sizing:border-box;\">Modelo<\/th><th style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;background:#e7eef5;color:#173b5d;box-sizing:border-box;\">Entrada de imagem \/ 1 milh\u00e3o de tokens<\/th><th style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;background:#e7eef5;color:#173b5d;box-sizing:border-box;\">Entrada de imagem em cache \/ 1 milh\u00e3o de tokens<\/th><th style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;background:#e7eef5;color:#173b5d;box-sizing:border-box;\">Sa\u00edda de imagem \/ 1 milh\u00e3o de tokens<\/th><\/tr><\/thead><tbody style=\"box-sizing:border-box;\"><tr style=\"box-sizing:border-box;\"><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">GPT Image 2.5<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">$8<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">$2*<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">$30<\/td><\/tr><tr style=\"box-sizing:border-box;\"><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Imagem GPT 2<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">$4<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">$1*<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">$15<\/td><\/tr><\/tbody><\/table><\/div><\/div>\n\n\n\n<p class=\"oie-note\" style=\"max-width:880px;box-sizing:border-box;background:#f0f5f9;border-left:4px solid #5d7d99;padding:13px 16px;color:#27445f;font:16px\/1.65 system-ui,-apple-system,sans-serif;min-width:0;margin:12px 0;\">*A coluna \u201ccached-input\u201d \u00e9 exibida para o contexto de pre\u00e7os publicado. O guia de pre\u00e7os indica que o \u201ccached-input\u201d se aplica \u00e0 ferramenta de gera\u00e7\u00e3o de imagens na API de Respostas, e n\u00e3o a solicita\u00e7\u00f5es diretas da API de Imagens, como <code style=\"background:#eef3f8;padding:2px 5px;border-radius:4px;font-size:.92em;box-sizing:border-box;color:#18364a;\">\/v1\/imagens\/edi\u00e7\u00f5es<\/code>. As tarifas podem sofrer altera\u00e7\u00f5es; fa\u00e7a o c\u00e1lculo com base nos dados de uso fornecidos para a sua pr\u00f3pria solicita\u00e7\u00e3o.<\/p>\n\n\n\n<div class=\"oie-code\" style=\"box-sizing:border-box;background:#0e1c2c;color:#edf6ff;border-radius:6px;padding:18px;margin:24px 0;font:16px\/1.65 system-ui,-apple-system,sans-serif;max-width:100%;min-width:0;\"><h3 style=\"color:#fff;margin:0 0 4px;box-sizing:border-box;line-height:1.3;\">Fa\u00e7a uma estimativa transparente com base no uso<\/h3><div class=\"oie-code-label\" style=\"color:#a8c9df;font-size:12px;text-transform:uppercase;letter-spacing:.08em;box-sizing:border-box;\">Python<\/div><pre style=\"overflow-x:auto;white-space:pre-wrap;overflow-wrap:anywhere;background:#08131f;padding:14px;border-radius:4px;color:#edf6ff;font:13px\/1.6 ui-monospace,SFMono-Regular,Menlo,monospace;box-sizing:border-box;max-width:100%;\"><code style=\"background:none;padding:0;border-radius:4px;font-size:.92em;box-sizing:border-box;color:inherit;\">def estimate_image_cost(image_input_tokens, image_output_tokens,\n input_rate, output_rate):\n    retorne (image_input_tokens \/ 1_000_000) * input_rate + \\\n (image_output_tokens \/ 1_000_000) * output_rate\n\n# Apenas a t\u00edtulo de exemplo: substitua pelos valores de uso em sua resposta.\nestimate = estimate_image_cost(\n    image_input_tokens=250_000,\n    image_output_tokens=120_000,\n    input_rate=4,00,\n    output_rate=15,00,\n)\nprint(f\"${estimate:.4f}\")<\/code><\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Esta f\u00f3rmula \u00e9 um exemplo de planejamento, n\u00e3o uma garantia de um valor fixo por imagem. Inclua novas tentativas, armazenamento de arquivos e qualquer uso separado de texto ou ferramentas em seu pr\u00f3prio or\u00e7amento. Quando o resultado for importante, mantenha a solicita\u00e7\u00e3o, o uso da resposta, o hash do arquivo decodificado e a decis\u00e3o de aprova\u00e7\u00e3o juntos.<\/p>\n\n\n\n<h2 id=\"globalgpt-contract\" class=\"wp-block-heading\">O GlobalGPT utiliza um contrato de API de edi\u00e7\u00e3o de imagens diferente<\/h2>\n\n\n\n<div class=\"wp-block-group is-layout-constrained wp-block-group-is-layout-constrained\">\n<figure class=\"wp-block-image size-large\"><a href=\"https:\/\/www.glbgpt.com\/home\/api?inviter=hub_api&amp;login=1\"><img alt=\"\" decoding=\"async\" width=\"1024\" height=\"702\" src=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/api-1024x702.png\" class=\"wp-image-20178\" srcset=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/api-1024x702.png 1024w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/api-300x206.png 300w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/api-767x526.png 767w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/api-17x12.png 17w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/api-1536x1053.png 1536w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/api.png 1938w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/a><\/figure>\n\n\n\n<div class=\"wp-block-buttons is-content-justification-center is-layout-flex wp-container-core-buttons-is-layout-3e41869c wp-block-buttons-is-layout-flex\">\n<div class=\"wp-block-button\"><a class=\"wp-block-button__link wp-element-button\" href=\"https:\/\/www.glbgpt.com\/home\/api?inviter=hub_api&amp;login=1\">Obter a chave da API agora<\/a><\/div>\n<\/div>\n<\/div>\n\n\n\n<p class=\"wp-block-paragraph\">O <a href=\"https:\/\/www.glbgpt.com\/home\/api\/docs\">Documenta\u00e7\u00e3o da API GlobalGPT<\/a> descreve a gera\u00e7\u00e3o de imagens, v\u00eddeos e \u00e1udio como tarefas de m\u00eddia ass\u00edncronas. Sua URL base p\u00fablica \u00e9 <code>https:\/\/api2.glbgpt.com\/ai-api\/open\/v1<\/code>. Envie o JSON para <code>\/tarefas<\/code>, pesquisa <code>\/tarefas\/{id}<\/code>, e leia <code>output.url<\/code> ap\u00f3s a conclus\u00e3o bem-sucedida de uma tarefa. O cat\u00e1logo de modelos lista <code>gpt-image-2<\/code> e <code>gpt-image-2.5<\/code> como rotas de edi\u00e7\u00e3o\/refer\u00eancia de imagens com at\u00e9 quatro imagens de entrada e <code>propor\u00e7\u00e3o da imagem<\/code>.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" width=\"1440\" height=\"680\" src=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/globalgpt-media-tasks-20260928_a012b9ace6664ba99a8e9964f8d24fb7.webp\" alt=\"Documenta\u00e7\u00e3o da API de tarefas de m\u00eddia p\u00fablica do GlobalGPT, mostrando os campos de URL de envio, estimativa, consulta e sa\u00edda\" class=\"wp-image-20184\" srcset=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/globalgpt-media-tasks-20260928_a012b9ace6664ba99a8e9964f8d24fb7.webp 1440w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/globalgpt-media-tasks-20260928_a012b9ace6664ba99a8e9964f8d24fb7-300x142.webp 300w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/globalgpt-media-tasks-20260928_a012b9ace6664ba99a8e9964f8d24fb7-1024x484.webp 1024w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/globalgpt-media-tasks-20260928_a012b9ace6664ba99a8e9964f8d24fb7-768x363.webp 768w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/globalgpt-media-tasks-20260928_a012b9ace6664ba99a8e9964f8d24fb7-18x9.webp 18w\" sizes=\"(max-width: 1440px) 100vw, 1440px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Documenta\u00e7\u00e3o da API p\u00fablica da S05:<\/strong> Documenta\u00e7\u00e3o p\u00fablica sobre o contrato de tarefa ass\u00edncrona; este artigo o diferencia do endpoint nativo de edi\u00e7\u00f5es multiparte do OpenAI.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1500\" height=\"1080\" src=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/globalgpt-openai-image-models-20260928_a9c8f99a4adc4697bb81c7204d4740aa.webp\" alt=\"Cat\u00e1logo de modelos de imagem p\u00fablica GlobalGPT, apresentando as rotas do GPT Image e detalhes das tarefas compat\u00edveis\" class=\"wp-image-20185\" srcset=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/globalgpt-openai-image-models-20260928_a9c8f99a4adc4697bb81c7204d4740aa.webp 1500w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/globalgpt-openai-image-models-20260928_a9c8f99a4adc4697bb81c7204d4740aa-300x216.webp 300w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/globalgpt-openai-image-models-20260928_a9c8f99a4adc4697bb81c7204d4740aa-1024x737.webp 1024w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/globalgpt-openai-image-models-20260928_a9c8f99a4adc4697bb81c7204d4740aa-768x553.webp 768w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/globalgpt-openai-image-models-20260928_a9c8f99a4adc4697bb81c7204d4740aa-18x12.webp 18w\" sizes=\"(max-width: 1500px) 100vw, 1500px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Cat\u00e1logo de modelos p\u00fablicos da S06:<\/strong> Evid\u00eancias p\u00fablicas do cat\u00e1logo de modelos para as rotas do GPT Image e seus limites documentados para tarefas de imagem; verifique os cr\u00e9ditos e campos din\u00e2micos antes da publica\u00e7\u00e3o.<\/p>\n\n\n\n<div class=\"oie-code\" style=\"box-sizing:border-box;background:#0e1c2c;color:#edf6ff;border-radius:6px;padding:18px;margin:24px 0;font:16px\/1.65 system-ui,-apple-system,sans-serif;max-width:100%;min-width:0;\"><h3 style=\"color:#fff;margin:0 0 4px;box-sizing:border-box;line-height:1.3;\">Formato da tarefa p\u00fablica GlobalGPT<\/h3><div class=\"oie-code-label\" style=\"color:#a8c9df;font-size:12px;text-transform:uppercase;letter-spacing:.08em;box-sizing:border-box;\">bash<\/div><pre style=\"overflow-x:auto;white-space:pre-wrap;overflow-wrap:anywhere;background:#08131f;padding:14px;border-radius:4px;color:#edf6ff;font:13px\/1.6 ui-monospace,SFMono-Regular,Menlo,monospace;box-sizing:border-box;max-width:100%;\"><code style=\"background:none;padding:0;border-radius:4px;font-size:.92em;box-sizing:border-box;color:inherit;\">BASE=\"https:\/\/api2.glbgpt.com\/ai-api\/open\/v1\"\n\n# Opcional: fazer uma estimativa sem criar uma tarefa ou reservar cr\u00e9ditos.\ncurl \"$BASE\/tasks\/estimate\" \\\n  -H \"Authorization: Bearer $GLOBALGPT_API_KEY\" \\\n  -H \"Content-Type: application\/json\" \\\n  -d '{\n    \"model\": \"gpt-image-2.5\",\n    \"prompt\": \"Mantenha a garrafa e o r\u00f3tulo inalterados. Substitua apenas o fundo por uma ilumina\u00e7\u00e3o de est\u00fadio bege quente.\",\n    \"images\": [\"https:\/\/YOUR_PUBLIC_IMAGE_URL\/product.png\"],\n    \"aspect_ratio\": \"3:2\"\n  }'\n\n# Envie somente ap\u00f3s verificar a estimativa.\ncurl \"$BASE\/tasks\" \\\n  -H \"Authorization: Bearer $GLOBALGPT_API_KEY\" \\\n  -H \"Content-Type: application\/json\" \\\n  -H \"Idempotency-Key: image-edit-example-001\" \\\n  -d '{\n    \"model\": \"gpt-image-2.5\",\n    \"prompt\": \"Mantenha a garrafa e o r\u00f3tulo inalterados. Substitua apenas o fundo por uma ilumina\u00e7\u00e3o de est\u00fadio bege quente.\",\n    \"images\": [\"https:\/\/YOUR_PUBLIC_IMAGE_URL\/product.png\"],\n    \"aspect_ratio\": \"3:2\"\n  }'\n\n# Verifique o ID da tarefa retornada at\u00e9 que haja sucesso ou falha.\ncurl \"$BASE\/tasks\/TASK_ID\" \\\n  -H \"Authorization: Bearer $GLOBALGPT_API_KEY\"<\/code><\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">N\u00e3o cole o arquivo multiparte do OpenAI <code>m\u00e1scara<\/code>, <code>fidelidade_de_entrada<\/code>, <code>tamanho<\/code>, ou <code>qualidade<\/code> campos neste JSON e presumir que eles funcionem. A documenta\u00e7\u00e3o p\u00fablica atual do GlobalGPT n\u00e3o lista esses campos para essa rota de imagem. Campos n\u00e3o suportados podem ser descartados e exibidos em <code>par\u00e2metros_ignorados<\/code>, portanto, verifique essa resposta antes de concluir que uma configura\u00e7\u00e3o entrou em vigor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">O GlobalGPT reserva cr\u00e9ditos quando uma tarefa de m\u00eddia \u00e9 enviada, libera-os quando a tarefa falha e mant\u00e9m as m\u00eddias bem-sucedidas dispon\u00edveis por 30 dias, conforme a documenta\u00e7\u00e3o p\u00fablica. Salve o ativo retornado em um armazenamento sob seu controle caso a URL precise permanecer ativa por mais tempo. Use o endpoint de estimativa antes de um lote, uma chave de idempot\u00eancia ao tentar novamente uma solicita\u00e7\u00e3o de rede e o ID original da tarefa quando uma consulta estiver apenas lenta.<\/p>\n\n\n\n<h2 id=\"tested-workflow\" class=\"wp-block-heading\">O que o teste do modelo GlobalGPT revelou<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Para tornar essa distin\u00e7\u00e3o mais concreta, realizei um teste de API com o modelo GlobalGPT limitado em 28\/09\/2026, utilizando dois prompts de entrada fict\u00edcios e sem refer\u00eancia a marcas, al\u00e9m de dois prompts de edi\u00e7\u00e3o. Cada tarefa utilizou o GPT Image 2, uma solicita\u00e7\u00e3o na propor\u00e7\u00e3o 3:2 e a primeira sa\u00edda v\u00e1lida. As imagens abaixo s\u00e3o evid\u00eancias do teste do modelo, e n\u00e3o uma sess\u00e3o da \u00e1rea de trabalho do navegador, um benchmark ou uma garantia de que todas as edi\u00e7\u00f5es preservar\u00e3o todos os contornos.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1536\" height=\"1024\" src=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/task_kT3VC8CRTLh9RPtLdYFwesrXsotpdQ7U.png\" alt=\"Um frasco de cer\u00e2mica na cor marfim fosco sobre um fundo branco liso, com as palavras \u201cNORTH\u201d e \u201c250 ml\u201d no r\u00f3tulo\" class=\"wp-image-20186\" srcset=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/task_kT3VC8CRTLh9RPtLdYFwesrXsotpdQ7U.png 1536w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/task_kT3VC8CRTLh9RPtLdYFwesrXsotpdQ7U-300x200.png 300w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/task_kT3VC8CRTLh9RPtLdYFwesrXsotpdQ7U-1024x683.png 1024w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/task_kT3VC8CRTLh9RPtLdYFwesrXsotpdQ7U-768x512.png 768w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/task_kT3VC8CRTLh9RPtLdYFwesrXsotpdQ7U-18x12.png 18w\" sizes=\"(max-width: 1536px) 100vw, 1536px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Entrada P00:<\/strong> A imagem original congelada: uma garrafa fict\u00edcia sem marca, com uma tampa branca curta e um r\u00f3tulo curto.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1536\" height=\"1024\" src=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/task_t7czrp2KJTtuEdj4NuegsGdxfCK1SE38.png\" alt=\"Uma natureza morta em tons de bege aconchegante, em ambiente interno, com um vaso de cer\u00e2mica e a luz suave que entra pela janela\" class=\"wp-image-20187\" srcset=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/task_t7czrp2KJTtuEdj4NuegsGdxfCK1SE38.png 1536w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/task_t7czrp2KJTtuEdj4NuegsGdxfCK1SE38-300x200.png 300w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/task_t7czrp2KJTtuEdj4NuegsGdxfCK1SE38-1024x683.png 1024w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/task_t7czrp2KJTtuEdj4NuegsGdxfCK1SE38-768x512.png 768w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/task_t7czrp2KJTtuEdj4NuegsGdxfCK1SE38-18x12.png 18w\" sizes=\"(max-width: 1536px) 100vw, 1536px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Refer\u00eancia P01:<\/strong> A imagem de refer\u00eancia congelada: utilizada apenas para fins de ilumina\u00e7\u00e3o e cor, e n\u00e3o como uma segunda identidade do produto.<\/p>\n\n\n\n<section class=\"oie-result\" style=\"box-sizing:border-box;background:#f4f8f5;border:1px solid #bfd8c7;border-top:4px solid #39825b;border-radius:6px;padding:20px;margin:26px 0;font:16px\/1.65 system-ui,-apple-system,sans-serif;max-width:100%;min-width:0;color:#17323f;\"><h3 style=\"margin-top:0;color:#1f5b3b;box-sizing:border-box;line-height:1.3;\">T01: edi\u00e7\u00e3o de fundo com uma imagem<\/h3><p class=\"oie-result-meta\" style=\"color:#355b47;font-size:14px;box-sizing:border-box;margin:12px 0;\"><strong style=\"box-sizing:border-box;\">Modelo:<\/strong> Imagem GPT 2 \u00b7 <strong style=\"box-sizing:border-box;\">Data:<\/strong> 28\/09\/2026 \u00b7 <strong style=\"box-sizing:border-box;\">Sa\u00edda:<\/strong> primeiro PNG v\u00e1lido com resolu\u00e7\u00e3o de 1536\u00d71024<\/p><details style=\"margin:14px 0;box-sizing:border-box;\"><summary style=\"cursor:pointer;font-weight:650;color:#1d6543;box-sizing:border-box;\">Mostrar o prompt completo<\/summary><pre style=\"background:#fff;border:1px solid #d5e4d9;padding:13px;white-space:pre-wrap;overflow-wrap:anywhere;font:13px\/1.6 ui-monospace,SFMono-Regular,Menlo,monospace;box-sizing:border-box;max-width:100%;\"><code style=\"background:none;padding:0;border-radius:4px;font-size:.92em;box-sizing:border-box;color:inherit;\">Mantenha inalterados a garrafa de cer\u00e2mica, a tampa branca curta, o texto fict\u00edcio do r\u00f3tulo \"NORTH\" e \"250 ml\", as cores, o \u00e2ngulo da c\u00e2mera e as propor\u00e7\u00f5es da imagem de origem. Substitua apenas o fundo branco puro por um cen\u00e1rio de est\u00fadio interno em tom bege quente, inspirado na luz suave da janela e em sombras delicadas. N\u00e3o adicione nenhum objeto, logotipo, palavra, marca d\u2019\u00e1gua, pessoa ou r\u00f3tulo novo. Mantenha a garrafa como o \u00fanico objeto em uma composi\u00e7\u00e3o na orienta\u00e7\u00e3o paisagem com propor\u00e7\u00e3o 3:2.<\/code><\/pre><\/details><figure style=\"margin:28px 0;box-sizing:border-box;\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/static.futureshareai.com\/anywhere-test\/task_4kxJZYwlOYxqv3xbyIoa3c4r6CAPPHyn.png\" alt=\"A garrafa de cer\u00e2mica NORTH inserida em uma cena de est\u00fadio em tons de bege quente\" width=\"1536\" height=\"1024\" style=\"max-width:100%;height:auto;display:block;width:100%;border-radius:6px;box-sizing:border-box;\"><figcaption style=\"font-size:14px;color:#506174;margin-top:8px;box-sizing:border-box;\">A garrafa continua reconhec\u00edvel, o r\u00f3tulo NORTH \/ 250 ml est\u00e1 vis\u00edvel, e o fundo branco d\u00e1 lugar a uma cena aconchegante em tons de bege, em ambiente interno, com sombras suaves que parecem vir de uma janela.<\/figcaption><\/figure><p style=\"box-sizing:border-box;margin:12px 0;\"><strong style=\"box-sizing:border-box;\">O que isso demonstra:<\/strong> A garrafa continua reconhec\u00edvel, o r\u00f3tulo NORTH \/ 250 ml est\u00e1 vis\u00edvel, e o fundo branco d\u00e1 lugar a uma cena aconchegante em tons de bege, em ambiente interno, com sombras suaves que parecem vir de uma janela.<\/p><p style=\"box-sizing:border-box;margin:12px 0;\"><strong style=\"box-sizing:border-box;\">Limite:<\/strong> Esta \u00e9 uma das primeiras sa\u00eddas v\u00e1lidas. Ela n\u00e3o comprova a preserva\u00e7\u00e3o exata dos pixels nem a fidelidade geral dos r\u00f3tulos.<\/p><\/section>\n\n\n\n<section class=\"oie-result\" style=\"box-sizing:border-box;background:#f4f8f5;border:1px solid #bfd8c7;border-top:4px solid #39825b;border-radius:6px;padding:20px;margin:26px 0;font:16px\/1.65 system-ui,-apple-system,sans-serif;max-width:100%;min-width:0;color:#17323f;\"><h3 style=\"margin-top:0;color:#1f5b3b;box-sizing:border-box;line-height:1.3;\">T02: refer\u00eancia de ilumina\u00e7\u00e3o e cor com duas imagens<\/h3><p class=\"oie-result-meta\" style=\"color:#355b47;font-size:14px;box-sizing:border-box;margin:12px 0;\"><strong style=\"box-sizing:border-box;\">Modelo:<\/strong> Imagem GPT 2 \u00b7 <strong style=\"box-sizing:border-box;\">Data:<\/strong> 28\/09\/2026 \u00b7 <strong style=\"box-sizing:border-box;\">Sa\u00edda:<\/strong> primeiro PNG v\u00e1lido com resolu\u00e7\u00e3o de 1536\u00d71024<\/p><details style=\"margin:14px 0;box-sizing:border-box;\"><summary style=\"cursor:pointer;font-weight:650;color:#1d6543;box-sizing:border-box;\">Mostrar o prompt completo<\/summary><pre style=\"background:#fff;border:1px solid #d5e4d9;padding:13px;white-space:pre-wrap;overflow-wrap:anywhere;font:13px\/1.6 ui-monospace,SFMono-Regular,Menlo,monospace;box-sizing:border-box;max-width:100%;\"><code style=\"background:none;padding:0;border-radius:4px;font-size:.92em;box-sizing:border-box;color:inherit;\">Use a imagem de entrada 1 como refer\u00eancia exata do produto e a imagem de entrada 2 apenas como refer\u00eancia para a ilumina\u00e7\u00e3o bege quente, a temperatura de cor e as sombras suaves do ambiente interno. Mantenha inalterados a forma da garrafa de cer\u00e2mica, a tampa branca curta, o texto fict\u00edcio do r\u00f3tulo \"NORTH\" e \"250 ml\", as cores, o \u00e2ngulo da c\u00e2mera e as propor\u00e7\u00f5es da imagem de entrada 1. Substitua o fundo branco por um ambiente de est\u00fadio interno em tom bege quente e tranquilo. N\u00e3o copie nenhum objeto, texto, logotipo, marca d\u2019\u00e1gua, pessoa ou r\u00f3tulo adicional da imagem de entrada 2. Mantenha a garrafa como o \u00fanico objeto em uma composi\u00e7\u00e3o paisagem na propor\u00e7\u00e3o 3:2.<\/code><\/pre><\/details><figure style=\"margin:28px 0;box-sizing:border-box;\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/static.futureshareai.com\/anywhere-test\/task_wiHpx53i7vJr5ueEtGzqzYzs4TC5bkOs.png\" alt=\"A garrafa de cer\u00e2mica NORTH em um quarto em tons de bege aconchegantes, com a luz suave que entra pela janela\" width=\"1536\" height=\"1024\" style=\"max-width:100%;height:auto;display:block;width:100%;border-radius:6px;box-sizing:border-box;\"><figcaption style=\"font-size:14px;color:#506174;margin-top:8px;box-sizing:border-box;\">O produto e o r\u00f3tulo NORTH \/ 250 ml continuam reconhec\u00edveis, enquanto o cen\u00e1rio adota o ambiente aconchegante em tons de bege do P01, com a mesa e a luz que entra pela janela.<\/figcaption><\/figure><p style=\"box-sizing:border-box;margin:12px 0;\"><strong style=\"box-sizing:border-box;\">O que isso demonstra:<\/strong> O produto e o r\u00f3tulo NORTH \/ 250 ml continuam reconhec\u00edveis, enquanto o cen\u00e1rio adota o ambiente aconchegante em tons de bege do P01, com a mesa e a luz que entra pela janela.<\/p><p style=\"box-sizing:border-box;margin:12px 0;\"><strong style=\"box-sizing:border-box;\">Limite:<\/strong> A propor\u00e7\u00e3o da tampa da garrafa, o contorno da garrafa e o posicionamento mudaram visivelmente. N\u00e3o considere isso uma preserva\u00e7\u00e3o perfeita ou exata da identidade; recorra \u00e0 compara\u00e7\u00e3o manual quando as dimens\u00f5es da mercadoria precisarem coincidir.<\/p><\/section>\n\n\n\n<p class=\"oie-note\" style=\"max-width:880px;box-sizing:border-box;background:#f0f5f9;border-left:4px solid #5d7d99;padding:13px 16px;color:#27445f;font:16px\/1.65 system-ui,-apple-system,sans-serif;min-width:0;margin:12px 0;\"><strong style=\"box-sizing:border-box;\">Como utilizar essas evid\u00eancias:<\/strong> O resultado \u00fatil \u00e9 um processo de revis\u00e3o repet\u00edvel. Fixe a URL de entrada, nomeie o objeto protegido, descreva a fun\u00e7\u00e3o de refer\u00eancia, inspecione os bytes retornados e compare o produto aprovado com a fonte antes da publica\u00e7\u00e3o. A transfer\u00eancia de estilo pode ser bem-sucedida mesmo que a geometria ainda sofra desvios.<\/p>\n\n\n\n<h2 id=\"image-edit-errors\" class=\"wp-block-heading\">Lidar com erros e respostas lentas<\/h2>\n\n\n\n<div class=\"oie-table\" style=\"box-sizing:border-box;background:#f5f8fb;border:1px solid #d7e0e9;border-top:4px solid #4f759a;border-radius:6px;padding:18px;margin:24px 0;font:16px\/1.65 system-ui,-apple-system,sans-serif;max-width:100%;min-width:0;color:#17323f;\"><h3 style=\"margin:0 0 12px;box-sizing:border-box;line-height:1.3;\">Sintoma \u2192 verifica\u00e7\u00e3o \u2192 a\u00e7\u00e3o<\/h3><div class=\"oie-scroll\" style=\"overflow-x:auto;box-sizing:border-box;\"><table style=\"border-collapse:collapse;width:100%;min-width:700px;box-sizing:border-box;\"><thead style=\"box-sizing:border-box;\"><tr style=\"box-sizing:border-box;\"><th style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;background:#e7eef5;color:#173b5d;box-sizing:border-box;\">Sintoma<\/th><th style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;background:#e7eef5;color:#173b5d;box-sizing:border-box;\">Verifique primeiro<\/th><th style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;background:#e7eef5;color:#173b5d;box-sizing:border-box;\">Pr\u00f3ximo passo seguro<\/th><\/tr><\/thead><tbody style=\"box-sizing:border-box;\"><tr style=\"box-sizing:border-box;\"><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">401 \/ erro de autentica\u00e7\u00e3o<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Chave do lado do servidor, permiss\u00f5es da conta, host do endpoint<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Pare e corrija a autentica\u00e7\u00e3o; n\u00e3o avalie a qualidade da imagem.<\/td><\/tr><tr style=\"box-sizing:border-box;\"><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">400 \/ 422 solicita\u00e7\u00e3o inv\u00e1lida<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">ID do modelo, nomes de campos com v\u00e1rias partes, tipo de arquivo, op\u00e7\u00f5es n\u00e3o suportadas<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Altere apenas o campo indicado pelo erro e, em seguida, mantenha a solicita\u00e7\u00e3o original que apresentou falha.<\/td><\/tr><tr style=\"box-sizing:border-box;\"><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">429 \/ 5xx \/ capacidade<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Se um ID de tarefa foi criado<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Se n\u00e3o houver nenhum ID de tarefa, tente novamente uma vez de acordo com sua pol\u00edtica; se houver uma tarefa, verifique esse ID.<\/td><\/tr><tr style=\"box-sizing:border-box;\"><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">A tarefa permanece na fila ou em processamento<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Status, hora da \u00faltima medi\u00e7\u00e3o, estimativa do provedor<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Fa\u00e7a a consulta em um intervalo definido; n\u00e3o crie uma duplicata enquanto o status for desconhecido.<\/td><\/tr><tr style=\"box-sizing:border-box;\"><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">A sa\u00edda \u00e9 um objeto JSON salvo como uma imagem<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Tipo de conte\u00fado, primeiros bytes, formato decodificado<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Analisar a resposta, decodificar <code style=\"background:#eef3f8;padding:2px 5px;border-radius:4px;font-size:.92em;box-sizing:border-box;color:#18364a;\">b64_json<\/code> ou baixar <code style=\"background:#eef3f8;padding:2px 5px;border-radius:4px;font-size:.92em;box-sizing:border-box;color:#18364a;\">output.url<\/code>, e depois validar.<\/td><\/tr><tr style=\"box-sizing:border-box;\"><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">O par\u00e2metro parece n\u00e3o ter efeito algum<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">GlobalGPT <code style=\"background:#eef3f8;padding:2px 5px;border-radius:4px;font-size:.92em;box-sizing:border-box;color:#18364a;\">par\u00e2metros_ignorados<\/code> e ficha do modelo<\/td><td style=\"padding:11px;border:1px solid #c9d5e1;text-align:left;vertical-align:top;box-sizing:border-box;\">Remova os campos n\u00e3o suportados e utilize o contrato espec\u00edfico do modelo.<\/td><\/tr><\/tbody><\/table><\/div><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Separe as evid\u00eancias de transporte das evid\u00eancias de qualidade. Um tempo limite excedido, uma falha no DNS ou uma resposta de capacidade do provedor significam que voc\u00ea n\u00e3o possui uma imagem v\u00e1lida para avalia\u00e7\u00e3o. Por outro lado, uma imagem v\u00e1lida com um limite ou r\u00f3tulo alterado \u00e9 um resultado visual que deve ser relatado tal como est\u00e1, mesmo que a composi\u00e7\u00e3o pare\u00e7a atraente.<\/p>\n\n\n\n<h2 id=\"workflow-checklist\" class=\"wp-block-heading\">Lista de verifica\u00e7\u00e3o para edi\u00e7\u00e3o de imagens em ambiente de produ\u00e7\u00e3o<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Congelar a fonte:<\/strong> armazenar o arquivo de entrada, as dimens\u00f5es, o formato e o hash.<\/li>\n\n\n\n<li><strong>Atribuir fun\u00e7\u00f5es \u00e0s imagens:<\/strong> identifique a imagem em quest\u00e3o e quaisquer refer\u00eancias de ilumina\u00e7\u00e3o, paleta de cores ou composi\u00e7\u00e3o.<\/li>\n\n\n\n<li><strong>Cues protegidos contra grava\u00e7\u00e3o:<\/strong> liste a marca, a silhueta, as cores e as propor\u00e7\u00f5es que precisam ser analisadas.<\/li>\n\n\n\n<li><strong>Escolha o contrato:<\/strong> Utilize o formato multipart OpenAI para o endpoint de edi\u00e7\u00f5es nativas ou as tarefas JSON GlobalGPT para sua API de m\u00eddia p\u00fablica.<\/li>\n\n\n\n<li><strong>Calcular e enviar:<\/strong> utilizar as taxas atuais do OpenAI ou do GlobalGPT <code>\/tarefas\/estimativa<\/code>; adicione uma chave de idempot\u00eancia para que os envios possam ser repetidos com seguran\u00e7a.<\/li>\n\n\n\n<li><strong>Consultar e decodificar:<\/strong> manter um ID de tarefa, validar o arquivo retornado e salvar os bytes ou a URL em um armazenamento aprovado.<\/li>\n\n\n\n<li><strong>Aprovar visualmente:<\/strong> compare o resultado com o original antes que ele seja inserido em um cat\u00e1logo de produtos, an\u00fancio ou p\u00e1gina voltada para o cliente.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">Se voc\u00ea quiser executar o mesmo processo sem precisar unir pain\u00e9is de modelos separados, tente <a href=\"https:\/\/www.glbgpt.com\/image-generator\/gpt-image-2?inviter=hub_content_gpt_image_2&amp;login=1\">Imagem GPT 2 em GlobalGPT<\/a>. Para a vers\u00e3o do fluxo de trabalho voltada para navegadores, consulte <a href=\"https:\/\/www.glbgpt.com\/hub\/globalgpt-image-edit\/\">editar imagens na \u00e1rea de trabalho GlobalGPT<\/a>; para uma discuss\u00e3o mais ampla sobre configura\u00e7\u00e3o e pre\u00e7os, consulte <a href=\"https:\/\/www.glbgpt.com\/hub\/gpt-image-2-5-api-guide\/\">Configura\u00e7\u00e3o e pre\u00e7os da API de imagens do GPT<\/a>.<\/p>\n\n\n\n<h2 id=\"faq\" class=\"wp-block-heading\">Perguntas frequentes<\/h2>\n\n\n\n<h3 style=\"font-size:21px;line-height:1.35;margin:28px 0 8px;color:#15395c;box-sizing:border-box;font:16px\/1.65 system-ui,-apple-system,sans-serif;max-width:100%;min-width:0;\">O que \u00e9 a API de edi\u00e7\u00e3o de imagens OpenAI?<\/h3><p style=\"max-width:880px;box-sizing:border-box;font:16px\/1.65 system-ui,-apple-system,sans-serif;min-width:0;color:#17323f;margin:12px 0;\">Trata-se da rota de edi\u00e7\u00e3o de imagens em POST \/v1\/images\/edits. Voc\u00ea envia uma imagem de entrada e um prompt, opcionalmente com uma m\u00e1scara ou imagens de refer\u00eancia, e depois decodifica os dados da imagem retornados. Use a API de Imagens para uma \u00fanica edi\u00e7\u00e3o e a API de Respostas quando o produto precisar de uma conversa com v\u00e1rias trocas de mensagens sobre imagens.<\/p>\n\n\n\n<h3 style=\"font-size:21px;line-height:1.35;margin:28px 0 8px;color:#15395c;box-sizing:border-box;font:16px\/1.65 system-ui,-apple-system,sans-serif;max-width:100%;min-width:0;\">A API de edi\u00e7\u00e3o de imagens OpenAI retorna uma URL p\u00fablica da imagem?<\/h3><p style=\"max-width:880px;box-sizing:border-box;font:16px\/1.65 system-ui,-apple-system,sans-serif;min-width:0;color:#17323f;margin:12px 0;\">Os exemplos documentados da API de imagens retornam b64_json. Decodifique esses bytes, valide o arquivo e salve-o em um armazenamento sob seu controle. N\u00e3o presuma que uma resposta bem-sucedida seja uma URL hospedada em uma CDN.<\/p>\n\n\n\n<h3 style=\"font-size:21px;line-height:1.35;margin:28px 0 8px;color:#15395c;box-sizing:border-box;font:16px\/1.65 system-ui,-apple-system,sans-serif;max-width:100%;min-width:0;\">A m\u00e1scara de imagem OpenAI representa uma sele\u00e7\u00e3o exata de pixels?<\/h3><p style=\"max-width:880px;box-sizing:border-box;font:16px\/1.65 system-ui,-apple-system,sans-serif;min-width:0;color:#17323f;margin:12px 0;\">N\u00e3o. Uma m\u00e1scara orienta uma edi\u00e7\u00e3o baseada em instru\u00e7\u00f5es. O modelo pode alterar os pixels ao redor da \u00e1rea solicitada; portanto, verifique os r\u00f3tulos, os detalhes do produto, as marcas de seguran\u00e7a e outros elementos que devem permanecer corretos.<\/p>\n\n\n\n<h3 style=\"font-size:21px;line-height:1.35;margin:28px 0 8px;color:#15395c;box-sizing:border-box;font:16px\/1.65 system-ui,-apple-system,sans-serif;max-width:100%;min-width:0;\">Quantas imagens de entrada um editor de imagens pode utilizar?<\/h3><p style=\"max-width:880px;box-sizing:border-box;font:16px\/1.65 system-ui,-apple-system,sans-serif;min-width:0;color:#17323f;margin:12px 0;\">O guia de imagens atual oferece suporte a v\u00e1rias imagens de entrada para fluxos de trabalho de refer\u00eancia. Para saber o limite exato e o comportamento espec\u00edfico do modelo, consulte a documenta\u00e7\u00e3o do modelo atual; o n\u00famero m\u00e1ximo suportado n\u00e3o garante a preserva\u00e7\u00e3o perfeita em todas as composi\u00e7\u00f5es.<\/p>\n\n\n\n<h3 style=\"font-size:21px;line-height:1.35;margin:28px 0 8px;color:#15395c;box-sizing:border-box;font:16px\/1.65 system-ui,-apple-system,sans-serif;max-width:100%;min-width:0;\">Posso enviar a solicita\u00e7\u00e3o OpenAI \/v1\/images\/edits para o GlobalGPT alterando o par\u00e2metro base_url?<\/h3><p style=\"max-width:880px;box-sizing:border-box;font:16px\/1.65 system-ui,-apple-system,sans-serif;min-width:0;color:#17323f;margin:12px 0;\">O contrato de m\u00eddia p\u00fablica do GlobalGPT utiliza JSON POST \/tasks e, em seguida, GET \/tasks\/{id}, com imagens e aspect_ratio, desde que o modelo selecionado as aceite. A documenta\u00e7\u00e3o p\u00fablica n\u00e3o lista a m\u00e1scara multipart, o par\u00e2metro input_fidelity, o tamanho nem o contrato de qualidade do OpenAI para essa rota.<\/p>\n\n\n\n<h3 style=\"font-size:21px;line-height:1.35;margin:28px 0 8px;color:#15395c;box-sizing:border-box;font:16px\/1.65 system-ui,-apple-system,sans-serif;max-width:100%;min-width:0;\">Como devo estimar a complexidade de uma tarefa de imagem antes de envi\u00e1-la?<\/h3><p style=\"max-width:880px;box-sizing:border-box;font:16px\/1.65 system-ui,-apple-system,sans-serif;min-width:0;color:#17323f;margin:12px 0;\">Para o GlobalGPT, envie primeiro o mesmo corpo JSON para \/tasks\/estimate. Isso n\u00e3o cria uma tarefa nem reserva cr\u00e9ditos. Para o OpenAI, fa\u00e7a o c\u00e1lculo com as taxas atuais por milh\u00e3o de tokens e, em seguida, verifique o uso real na resposta ou no registro de cobran\u00e7a.<\/p>\n\n\n<p><script type=\"application\/ld+json\">{<br \/>\n  \"@context\": \"https:\/\/schema.org\",<br \/>\n  \"@type\": \"FAQPage\",<br \/>\n  \"mainEntity\": [<br \/>\n    {<br \/>\n      \"@type\": \"Question\",<br \/>\n      \"name\": \"What is the OpenAI Image Edit API?\",<br \/>\n      \"acceptedAnswer\": {<br \/>\n        \"@type\": \"Answer\",<br \/>\n        \"text\": \"It is the image-editing route at POST \/v1\/images\/edits. You send an input image and a prompt, optionally with a mask or reference images, then decode the returned image data. Use the Image API for a single edit and the Responses API when the product needs a multi-turn image conversation.\"<br \/>\n      }<br \/>\n    },<br \/>\n    {<br \/>\n      \"@type\": \"Question\",<br \/>\n      \"name\": \"Does the OpenAI Image Edit API return a public image URL?\",<br \/>\n      \"acceptedAnswer\": {<br \/>\n        \"@type\": \"Answer\",<br \/>\n        \"text\": \"The documented Image API examples return b64_json. Decode those bytes, validate the file, and save it in storage you control. Do not assume that a successful response is a hosted CDN URL.\"<br \/>\n      }<br \/>\n    },<br \/>\n    {<br \/>\n      \"@type\": \"Question\",<br \/>\n      \"name\": \"Is an OpenAI image mask exact pixel selection?\",<br \/>\n      \"acceptedAnswer\": {<br \/>\n        \"@type\": \"Answer\",<br \/>\n        \"text\": \"No. A mask guides a prompt-based edit. The model can change pixels around the requested area, so inspect labels, product details, safety marks, and other elements that must remain correct.\"<br \/>\n      }<br \/>\n    },<br \/>\n    {<br \/>\n      \"@type\": \"Question\",<br \/>\n      \"name\": \"How many input images can an image edit use?\",<br \/>\n      \"acceptedAnswer\": {<br \/>\n        \"@type\": \"Answer\",<br \/>\n        \"text\": \"The current image guide supports multiple input images for reference workflows. For the exact limit and model-specific behavior, check the current model documentation; a supported maximum does not guarantee perfect preservation in every composition.\"<br \/>\n      }<br \/>\n    },<br \/>\n    {<br \/>\n      \"@type\": \"Question\",<br \/>\n      \"name\": \"Can I send the OpenAI \/v1\/images\/edits request to GlobalGPT by changing base_url?\",<br \/>\n      \"acceptedAnswer\": {<br \/>\n        \"@type\": \"Answer\",<br \/>\n        \"text\": \"No. GlobalGPT's public media contract uses JSON POST \/tasks, then GET \/tasks\/{id}, with images and aspect_ratio where the selected model accepts them. The public docs do not list OpenAI's multipart mask, input_fidelity, size, or quality contract for that route.\"<br \/>\n      }<br \/>\n    },<br \/>\n    {<br \/>\n      \"@type\": \"Question\",<br \/>\n      \"name\": \"How should I estimate an image task before submitting it?\",<br \/>\n      \"acceptedAnswer\": {<br \/>\n        \"@type\": \"Answer\",<br \/>\n        \"text\": \"For GlobalGPT, send the same JSON body to \/tasks\/estimate first. It does not create a task or reserve credits. For OpenAI, calculate with the current per-million-token rates and then verify actual usage in the response or billing record.\"<br \/>\n      }<br \/>\n    }<br \/>\n  ]<br \/>\n}<\/script><\/p>","protected":false},"excerpt":{"rendered":"<p>A API de edi\u00e7\u00e3o de imagens OpenAI altera uma imagem existente a partir de um prompt. A rota nativa \u00e9 POST \/v1\/images\/edits; ela aceita uma imagem, um prompt e controles de edi\u00e7\u00e3o opcionais, como m\u00e1scara ou imagens de refer\u00eancia. Use a API de Imagem para uma solicita\u00e7\u00e3o espec\u00edfica e use a API de Respostas quando o produto precisar de uma imagem com v\u00e1rias etapas [\u2026]<\/p>","protected":false},"author":7,"featured_media":20176,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_seopress_robots_primary_cat":"","_seopress_titles_title":"OpenAI Image Edit API: Masks, Pricing & Examples","_seopress_titles_desc":"Learn how the OpenAI Image Edit API handles masks, reference images, parameters, pricing, and a separate GlobalGPT async image workflow.","_seopress_robots_index":"","footnotes":""},"categories":[8],"tags":[],"class_list":["post-20175","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-ai-image"],"acf":[],"_links":{"self":[{"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/posts\/20175","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/users\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/comments?post=20175"}],"version-history":[{"count":3,"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/posts\/20175\/revisions"}],"predecessor-version":[{"id":20188,"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/posts\/20175\/revisions\/20188"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/media\/20176"}],"wp:attachment":[{"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/media?parent=20175"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/categories?post=20175"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/tags?post=20175"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}