Skip to main content
POST
Usa esta ruta para editar imágenes existentes con cargas multipart compatibles con OpenAI en CometAPI.

​
Usa esta ruta cuando

  • Ya tienes una imagen de origen y quieres una edición guiada por Prompt
  • Puede que necesites una máscara para cambios específicos
  • Puedes manejar la carga de archivos multipart en lugar de una solicitud JSON simple

​
Primera solicitud segura

  • Empieza con un archivo PNG o JPG
  • Omite la máscara hasta que el flujo base de edición funcione
  • Usa model: "gpt-image-2" para solicitudes de edición de imagen GPT en esta ruta
  • Usa una instrucción breve que solicite un cambio visible
  • Lee el resultado editado desde data[0].b64_json
  • Establece output_format: "jpeg" cuando quieras una carga útil JPEG
  • Espera una latencia mayor que en la generación de imágenes simple

​
Comportamiento del modelo

  • Los modelos de edición de imagen GPT en esta ruta devuelven datos de imagen base64 en línea
  • output_format controla el tipo de imagen codificada dentro de b64_json
  • response_format solo importa cuando un modelo admite salida por URL
  • qwen-image-edit sigue un comportamiento de edición específico del proveedor detrás de la misma ruta de CometAPI

Autorizaciones

​
Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

multipart/form-data
​
image
file
requerido

Source image file. Start with one PNG or JPG input for the simplest flow.

​
prompt
string
requerido

Edit instruction describing the change you want.

Ejemplo:

"Add a small red ribbon to the paper boat."

​
model
string
predeterminado:gpt-image-2

The image editing model to use. Choose a supported model from the Models page.

​
mask
file

Optional PNG mask. Transparent areas mark the regions to edit. The mask dimensions must match the source image exactly.

​
n
string
predeterminado:1

Number of edited images to return.

​
quality
enum<string>

Quality setting for models that support it.

Opciones disponibles:
high,
medium,
low
​
response_format
enum<string>

Requested response container when supported by the selected model. GPT image edit models return data[].b64_json; use output_format to choose the encoded image type.

Opciones disponibles:
url,
b64_json
​
output_format
string

Encoded image type for GPT image edit results returned in data[].b64_json. For example, use jpeg for a JPEG payload.

Ejemplo:

"jpeg"

​
size
string

Requested output size when supported by the selected model.

Respuesta

200 - application/json

Edited image result.

​
created
integer
requerido
​
usage
object
requerido
​
data
object[]
requerido
​
background
string

Background mode returned by models that expose it.

​
output_format
string

Encoded image type returned by GPT image models.

​
quality
string

Quality level returned by models that expose it.

​
size
string

Output size returned by models that expose it.