Generación y edición de imágenes

Genere y edite imágenes con puntos de conexión compatibles con OpenAI, compatibles con entradas multiparte y URLs JSON.

Descripción general

Cree nuevas imágenes o edite imágenes existentes mediante rutas estándar de OpenAI, admitiendo subidas de archivos multiparte y URLs de imagen JSON no continuas para gpt-image-2.

Generación de imágenes

POST/v1/images/generations
  • Punto de conexión canónico: POST /v1/images/generations (operationId: openai.images.generations) crea imágenes a partir de una descripción de texto.
  • Parámetros de generación: Acepta prompt, y los opcionales model, n, quality y size.
  • Alias de compatibilidad: Acepta POST /openai/v1/images/generations (operationId: openai.images.generations.alias).

Edición de imágenes

POST/openai/v1/images/edits
json
{
  "model": "gpt-image-2",
  "prompt": "Combina estas imágenes de referencia en un retrato surrealista coherente.",
  "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"
}
  • Punto de conexión canónico: POST /openai/v1/images/edits (operationId: openai.images.edits) con alias de compatibilidad POST /v1/images/edits (operationId: openai.images.edits.alias).
  • Entrada por URL JSON: Para gpt-image-2 y canales nativos admitidos, envíe un JSON no continuo con model, prompt, una matriz images con 1 a 16 objetos con image_url y un objeto opcional mask (image_url).
  • Requisitos de HTTPS público: Las URLs de imágenes deben ser direcciones HTTPS de acceso público sin credenciales incrustadas, leídas directamente por el proveedor ascendente.
  • Control de calidad y dimensiones: gpt-image-2 usa calidad medium por defecto (también admite low y high); los parámetros nativos adicionales se transmiten intactos.
  • Contrato de operación: Publicado bajo operationId: openai.images.edits con el alias compatible POST /v1/images/edits.