Saltar para o conteúdo principal
POST
Use gpt-image-2.6-ext com version igual a flare / sunburst. Cobrança por imagem. Suporta resolution 1k / 2k / 4k com n: 1, todos os níveis de qualidade e PNG / JPEG / WebP / SVG / GIF.
Esta é a API Ext. O nome e as regras diferem dos modelos GPT-Image-2.6 cobrados por tokens.

Autenticação

string
obrigatório
Use uma chave da plataforma com Bearer Token, disponível na página de chaves API. Envie Content-Type: application/json.

Seleção de versão

Parâmetros

Valores enumerados não diferenciam maiúsculas e minúsculas; espaços externos são removidos. Exemplos usam minúsculas.
string
obrigatório
Valor fixo: gpt-image-2.6-ext.
string
obrigatório
Instruções obrigatórias e não vazias. Com várias referências, indique a primeira ou segunda imagem e descreva o que alterar e preservar.
string
padrão:"flare"
flare / sunburst; padrão flare. Outros valores: HTTP 400. Os preços podem variar entre versões.
string
padrão:"1k"
1k / 2k / 4k (maiúsculas 1K / 2K / 4K também são aceitas). Junto com a proporção de size, define os pixels de saída; veja a tabela “Proporções e dimensões” abaixo. O preço por imagem varia conforme o nível; valores como hd / 8k retornam HTTP 400.
string
padrão:"auto"
Somente auto ou as 10 proporções abaixo, não pixels como 1024x1024. Com texto, auto gera 1:1. Na edição, escolhe a proporção compatível mais próxima da primeira referência com dimensões legíveis. Para GIF, omita ou use auto.
string
Alias de size; use um dos dois. Se ambos forem enviados, devem coincidir, caso contrário HTTP 400. Para GIF, omita ou use auto.
integer
padrão:"1"
Use atualmente o inteiro 1.
string
auto / low / medium / high / xhigh / max. Se omitido, não é encaminhado e o provedor escolhe automaticamente. auto não é fixado em low. O preço não muda; níveis altos geralmente demoram mais. Outros valores: HTTP 400.
string
padrão:"png"
png / jpeg / webp / svg / gif; jpg é alias de jpeg. SVG e GIF aceitam apenas geração por texto. Outros formatos: HTTP 400.
A saída SVG ainda não é suportada.
string
low / medium / high; se omitido, o provedor decide. Controla a complexidade: low para ícones simples e ilustrações planas, high para mais detalhes. Sem efeito no preço por imagem.
string[]
Até 16 imagens de no máximo 20 MB cada. PNG / JPEG / WebP / GIF / BMP. URLs HTTP(S) públicas ou Data URL de imagem como data:image/png;base64,.... Referências ativam a edição. SVG e GIF não aceitam referências.
Quando resolution é 2k / 4k, as imagens de referência não podem ser GIF / BMP.
Aliases aceitos: image_url, image, images, input_image, input_images. Prefira image_urls. As URLs devem ser públicas e acessíveis sem login.

Proporções e dimensões

Com auto, texto para imagem usa 1:1: 1024×1024 em 1k, 2048×2048 em 2k e 2880×2880 em 4k. A edição seleciona a proporção mais próxima da tabela, sem garantir os pixels originais.

Exemplo com referências

A edição também usa POST /v1/images/generations. Substitua as URLs de exemplo por imagens acessíveis.

Saída SVG

Defina output_format: "svg". Somente texto para imagem com n=1. size aceita proporções; complexity: "low" é adequado para gráficos vetoriais simples.
object
Configuração opcional do modelo que escreve SVG, exclusiva de SVG. O objeto inteiro pode ser omitido. O modelo de texto não tem cobrança adicional.

GIFs animados

Defina output_format: "gif". Somente texto para imagem. Omita size / aspect_ratio ou use auto; proporções e pixels retornam HTTP 400. Descreva o movimento e o ciclo.

Parâmetros não aceitos e ignorados

Envio e resultados

Envio bem-sucedido retorna HTTP 200. Leia data[0].task_id e consulte a API de status a cada 3–5 segundos até completed ou failed. Após timeout do cliente, continue consultando a tarefa existente em vez de gerar novamente.
O exemplo mostra o objeto da tarefa. Se a resposta usar um envelope {code, data}, leia data primeiro. Os exemplos Python / JavaScript tratam ambas as formas.
result.images[0].url é um array; o primeiro link é result.images[0].url[0]. Baixe antes de expires_at; a validade recomendada é de 24 horas após a conclusão. cost / credits_cost indicam os custos finais. Consulta em lote: POST /v1/tasks/batch com {"task_ids":["task_xxx","task_yyy"]}.

Cobrança

O preço por imagem depende apenas de version × resolution. Qualidade, formato (incluindo SVG / GIF), complexidade, proporção, quantidade de referências e svg.model não o alteram. Use atualmente n=1; falhas são reembolsadas integralmente. Consulte a página de preços APIMart ou /api/pricing.

Tratamento de erros