Editar imagem
Cria imagens a partir de um prompt e de uma ou mais imagens de referência, enviadas como arquivos em um formulário multipart ou como links.
Cria imagens a partir de um prompt e de uma ou mais imagens de referência, enviadas como arquivos em um formulário multipart ou como links.
apiKeyAuthorizationBearer <token>Sua chave de API, enviada como Authorization: Bearer <key>.
Idempotency-Key?stringUm valor à sua escolha, com até 255 caracteres. Enviar o mesmo valor de novo não cria nem cobra uma segunda requisição; em vez disso, retorna 409.
length <= 255multipart/form-data- body
model*stringO modelo a usar.
"gpt-image-2""gpt-image-2-adobe""gpt-image-2.5""gpt-image-2.5-flare""gpt-image-2.5-sunburst""gpt-image-2.6""gpt-image-2.6-flare""gpt-image-2.6-sunburst""nano-banana-2""nano-banana-2.1""nano-banana-pro""nano-banana-2-1k""nano-banana-2-2k""nano-banana-2-4k""nano-banana-pro-1k""nano-banana-pro-2k""nano-banana-pro-4k"prompt*stringO que a imagem deve mostrar. Até 32.000 caracteres.
length <= 32000n?integerQuantas imagens gerar. Uma requisição usa n vezes os créditos do modelo. No máximo 10 em 1K, 4 em 2K e 2 em 4K.
1 <= value <= 101size?stringauto deixa o modelo escolher (em um modelo de uma só resolução, essa resolução). Os outros valores são tamanhos de 1K, 2K e 4K; cada modelo aceita as resoluções listadas no seu cartão em /pt/models, pelo mesmo preço. Veja o guia de tamanhos para a proporção de cada um. gpt-image-2-adobe e gpt-image-2.5-flare também aceitam uma largura e uma altura à sua escolha: múltiplos de 16, até 3840 px por lado, com proporção de no máximo 3:1, de 655.360 a 8.294.400 pixels.
"auto""auto""1024x1024""1536x1024""1024x1536""1443x1090""1090x1443""1672x941""941x1672""1408x1120""1120x1408""1920x832""832x1920""1792x896""896x1792""1152x864""864x1152""1280x720""720x1280""1120x896""896x1120""1456x624""624x1456""1536x768""768x1536""2048x2048""2048x1360""1360x2048""2304x1728""1728x2304""2048x1152""1152x2048""2240x1792""1792x2240""2912x1248""1248x2912""3072x1536""1536x3072""2048x688""688x2048""2880x2880""3504x2336""2336x3504""3264x2448""2448x3264""3840x2160""2160x3840""3200x2560""2560x3200""3840x1648""1648x3840""3840x1920""1920x3840""3840x1280""1280x3840""2048x512""512x2048""3072x384""384x3072""4096x1024""1024x4096""6144x768""768x6144""8192x2048""2048x8192""12288x1536""1536x12288"quality?stringQualidade da renderização, respeitada pelo gpt-image-2-adobe e pelas versões flare e sunburst; os outros modelos GPT a escolhem sozinhos e o Nano Banana a ignora. xhigh e max funcionam apenas no gpt-image-2.5-sunburst. Toda qualidade custa o mesmo.
"auto""auto""low""medium""high""xhigh""max"background?stringNo momento, nenhum modelo gera fundo transparente, então transparent retorna 400. auto e opaque funcionam em todos os modelos.
"auto""auto""opaque"output_format?stringFormato do arquivo das imagens devolvidas. gif funciona no gpt-image-2.6 e nas versões flare e sunburst, svg apenas no gpt-image-2.6. png, jpeg e webp funcionam em todos os modelos.
"png""png""jpeg""webp""gif""svg"output_compression?integerQualidade de jpeg e webp, de 0 a 100. Padrão 100.
0 <= value <= 100moderation?stringCom que rigor o prompt e o resultado são verificados. low é menos restritivo.
"auto""auto""low"response_format?stringb64_json devolve os dados da imagem na resposta. url devolve um link para a imagem, guardada por 72 horas.
"b64_json""b64_json""url"async?booleanDefina como true para executar a requisição em segundo plano. A resposta é 202 com uma tarefa na hora; leia o resultado depois com GET /images/tasks/{id}. As imagens são devolvidas como links, então response_format deve ser url ou ficar de fora. O cabeçalho Prefer: respond-async faz o mesmo.
falsewebhook_url?stringCom async: um endereço https:// que recebe um POST da tarefa concluída (o mesmo JSON de GET /images/tasks/{id}). Há até 3 tentativas. Envie webhook_secret para que a chamada seja assinada; sem ele, confirme o que você recebeu buscando a tarefa com a sua chave.
uriwebhook_secret?stringCom webhook_url: um segredo seu, de 16 a 128 caracteres. A chamada ao seu endereço passa a levar x-webhook-signature: t=<unix seconds>,v1=<hex>, onde o hexadecimal é o HMAC-SHA256 de <t>.<body> feito com esse segredo.
16 <= length <= 128image[]*array<>Imagens de referência: PNG, JPEG ou WebP, de 1 a 16 arquivos, cada um com até 20 MB, 50 MB no total.
1 <= items <= 16input_fidelity?stringQuão fielmente o resultado mantém os detalhes das imagens de referência. Não é aceito pelo gpt-image-2.
"low""high"As imagens.
application/json- response
created*integerQuando as imagens foram geradas, como timestamp Unix em segundos.
data*array<>curl -X POST 'https://api.cheapestimagen.com/v1/images/edits' \ -F 'model=gpt-image-2' \ -F 'prompt=string' \ -F 'image[]=[ "string"]'{ "created": 0, "data": [ { "b64_json": "string", "url": "http://example.com" } ]}Criar imagem POST
Cria uma ou mais imagens a partir de um prompt de texto. Os créditos são reservados quando a requisição começa e devolvidos por toda imagem que não for entregue.
Obter tarefa GET
Obtém o estado de uma requisição assíncrona pelo id da tarefa: `in_progress`, depois `succeeded` com as imagens ou `failed` com o erro. Uma tarefa pode ser lida enquanto suas imagens forem guardadas, 72 horas. Consulte a cada poucos segundos; ler uma tarefa não conta como requisição em andamento. Para esperar várias tarefas, use `GET /images/tasks?ids=` e leia todas em uma só chamada.