Geração e edição de imagens
Gere e edite imagens com endpoints compatíveis com a OpenAI, com suporte para uploads multipart e URLs de imagem JSON.
Visão geral
Crie novas imagens ou edite imagens existentes usando rotas padrão da OpenAI, com suporte para uploads multipart e entrada de URLs de imagem JSON sem streaming para gpt-image-2.
Geração de imagens
POST
/v1/images/generations- Endpoint canônico:
POST /v1/images/generations(operationId: openai.images.generations) cria imagens a partir de um prompt de texto. - Parâmetros de geração: Aceita
prompt, e os opcionaismodel,n,qualityesize. - Alias de compatibilidade: Aceita
POST /openai/v1/images/generations(operationId: openai.images.generations.alias).
Edição de imagens
POST
/openai/v1/images/edits{
"model": "gpt-image-2",
"prompt": "Combine essas imagens de referência em um retrato surrealista coerente.",
"images": [
{ "image_url": "https://cdn.example.com/reference-1.png" },
{ "image_url": "https://cdn.example.com/reference-2.png" }
],
"mask": {
"image_url": "https://cdn.example.com/mask.png"
},
"n": 1,
"quality": "medium",
"size": "1024x1024"
}- Endpoint canônico:
POST /openai/v1/images/edits(operationId: openai.images.edits) com alias de compatibilidadePOST /v1/images/edits(operationId: openai.images.edits.alias). - Entrada por URL JSON: Para
gpt-image-2e canais nativos suportados, envie um JSON sem streaming commodel,prompt, uma matrizimagescontendo de 1 a 16 objetos comimage_urle um objetomaskopcional (image_url). - Requisitos de HTTPS público: As URLs de imagem devem ser endereços HTTPS publicamente acessíveis sem credenciais incorporadas, lidas diretamente pelo provedor.
- Controle de qualidade e dimensões:
gpt-image-2utiliza qualidademediumpor padrão (lowehightambém são suportadas); parâmetros adicionais são repassados intactos. - Contrato de operação: Publicado sob
operationId: openai.images.editscom o alias compatívelPOST /v1/images/edits.