Crear edición de imagen
Usa POST /v1/images/edits en CometAPI para editar imágenes con cargas multipart, máscaras, modelos de imagen GPT y controles de salida de imagen codificada.
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_formatcontrola el tipo de imagen codificada dentro deb64_jsonresponse_formatsolo importa cuando un modelo admite salida por URLqwen-image-editsigue un comportamiento de edición específico del proveedor detrás de la misma ruta de CometAPI
Autorizaciones
Bearer token authentication. Use your CometAPI key.
Cuerpo
Source image file. Start with one PNG or JPG input for the simplest flow.
Edit instruction describing the change you want.
"Add a small red ribbon to the paper boat."
The image editing model to use. Choose a supported model from the Models page.
Optional PNG mask. Transparent areas mark the regions to edit. The mask dimensions must match the source image exactly.
Number of edited images to return.
Quality setting for models that support it.
high, medium, low 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.
url, b64_json Encoded image type for GPT image edit results returned in data[].b64_json. For example, use jpeg for a JPEG payload.
"jpeg"
Requested output size when supported by the selected model.
Respuesta
Edited image result.
Background mode returned by models that expose it.
Encoded image type returned by GPT image models.
Quality level returned by models that expose it.
Output size returned by models that expose it.