Visão geral
Este endpoint é mantido para clientes legacy de variações compatíveis com OpenAI. Ele não é o caminho recomendado para workflows image-to-image atuais; use/v1/images/edits com gpt-image-2 ou /v1/images/generations com um modelo image-to-image como nano-banana-pro quando possível. Requer multipart/form-data.
Corpo da requisição
Timeout de solicitações síncronas: alguns provedores de imagem roteados retornam a imagem final inline e aguardam a geração terminar. Solicitações de alta resolução ou alta qualidade podem levar perto de um minuto ou mais, então configure o timeout do seu cliente HTTP para pelo menos120s. Se a resposta de criação incluir status: "pending", task_id ou poll_url, siga o poll_url retornado.
file
obrigatório
A imagem a ser usada como base para a variação. Deve ser um arquivo PNG válido, menor que 50MB e quadrado.
string
obrigatório
Identificador de modelo obrigatório para rotas legacy compatíveis com variações. Não há padrão implícito; para workflows image-to-image atuais, prefira
/v1/images/edits ou /v1/images/generations com um modelo atual.integer
padrão:"1"
O número de imagens a gerar. Deve estar entre 1 e 10.
string
O tamanho das imagens geradas para rotas legacy compatíveis com variações. Os valores compatíveis dependem do modelo selecionado.
string
padrão:"url"
O formato em que as imagens geradas são retornadas. Deve ser
url ou b64_json.string
Um identificador único representando seu usuário final para monitoramento de abuso.
Resposta
integer
Timestamp Unix de quando as imagens foram criadas.
array
Array de variações de imagem geradas.Cada objeto contém:
url(string): URL da imagem de variação (se response_format forurl)b64_json(string): Imagem codificada em Base64 (se response_format forb64_json)
Observações
Este é um endpoint de compatibilidade legacy. Ele não está incluído no catálogo atual de modelos de imagem recomendados. Para novas integrações, use
/v1/images/edits com gpt-image-2, ou /v1/images/generations com operation: "image-to-image" e um modelo image-to-image atual.