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.
A imagem a ser usada como base para a variação. Deve ser um arquivo PNG válido, menor que 50MB e quadrado.
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.O número de imagens a gerar. Deve estar entre 1 e 10.
O tamanho das imagens geradas para rotas legacy compatíveis com variações. Os valores compatíveis dependem do modelo selecionado.
O formato em que as imagens geradas são retornadas. Deve ser
url ou b64_json.Um identificador único representando seu usuário final para monitoramento de abuso.
Resposta
Timestamp Unix de quando as imagens foram criadas.
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.