Pular para o conteúdo principal
POST
Criar edição de imagem

Autorizações

Authorization
string
header
obrigatório

Autenticação com token Bearer

Corpo

multipart/form-data
model
string
obrigatório
image
obrigatório
prompt
string
obrigatório
models
string[]

Modelos de fallback opcionais e ordenados, tentados depois de model. model é obrigatório e é sempre o modelo principal. Quando uma tentativa falha com 429, 500, 502, 503 ou 504, a próxima entrada é tentada; os demais erros são retornados sem alteração. Aceita até 25 IDs de modelo ou predefinições; duplicatas e entradas iguais a model são ignoradas. Cada tentativa é validada, registrada e cobrada como uma solicitação separada, e o campo model da resposta e o rastreamento de roteamento mostram o modelo que atendeu a solicitação. Solicitações em streaming só recorrem a um fallback antes do primeiro byte, e trabalhos de vídeo e música apenas no envio. Solicitações de batch, realtime e council rejeitam models. Fallbacks definidos em uma rota dinâmica têm precedência, e phaseo/auto não pode ser combinado com models.

Required array length: 1 - 25 elements
Minimum string length: 1
Exemplo:
mask
string
markup
string

Camada de anotação PNG transparente sobre a primeira imagem, como upload de arquivo, URL ou string base64. Exige GPT Image 2.5 ou posterior e não pode ser combinada com mask.

complexity
enum<string>
Opções disponíveis:
low,
medium,
high
size
string
resolution
string
n
integer
Intervalo obrigatório: 1 <= x <= 10
quality
enum<string>

Qualidade de renderização de imagens. xhigh e max estão disponíveis apenas para os modelos GPT Image 2.5.

Opções disponíveis:
standard,
low,
medium,
high,
xhigh,
max,
auto
stream
boolean
partial_images
integer
Intervalo obrigatório: 0 <= x <= 3
output_format
enum<string>
Opções disponíveis:
png,
jpeg,
webp
output_compression
integer
Intervalo obrigatório: 0 <= x <= 100
background
enum<string>
Opções disponíveis:
transparent,
opaque,
auto
moderation
enum<string>
Opções disponíveis:
auto,
low
input_fidelity
enum<string>
Opções disponíveis:
high,
low
user
string
meta
boolean
usage
boolean
provider
object

Preferências de roteamento de provedores para seleção pelo gateway.

Resposta

Resposta da edição de imagem

created
integer
data
object[]
Última modificação em 16 de novembro de 2026