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 opcionais model, n, quality e size.
  • Alias de compatibilidade: Aceita POST /openai/v1/images/generations (operationId: openai.images.generations.alias).

Edição de imagens

POST/openai/v1/images/edits
json
{
  "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 compatibilidade POST /v1/images/edits (operationId: openai.images.edits.alias).
  • Entrada por URL JSON: Para gpt-image-2 e canais nativos suportados, envie um JSON sem streaming com model, prompt, uma matriz images contendo de 1 a 16 objetos com image_url e um objeto mask opcional (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-2 utiliza qualidade medium por padrão (low e high também são suportadas); parâmetros adicionais são repassados intactos.
  • Contrato de operação: Publicado sob operationId: openai.images.edits com o alias compatível POST /v1/images/edits.