Creare una modifica di immagine
Usa POST /v1/images/edits in CometAPI per modificare immagini con upload multipart, maschere, modelli di immagine GPT e controlli dell’output immagine codificato.
Usa questa route quando
- Hai già un’immagine sorgente e vuoi una modifica guidata da prompt
- Potresti aver bisogno di una maschera per modifiche mirate
- Puoi gestire il caricamento di file multipart invece di una semplice richiesta JSON
Prima richiesta sicura
- Inizia con un solo file PNG o JPG
- Salta la maschera finché il flusso base di modifica non funziona
- Usa
model: "gpt-image-2"per richieste di modifica immagine GPT su questa route - Usa un’istruzione breve che richieda una sola modifica visibile
- Leggi il risultato modificato da
data[0].b64_json - Imposta
output_format: "jpeg"quando vuoi un payload JPEG - Aspettati una latenza maggiore rispetto alla semplice generazione di immagini
Comportamento del modello
- I modelli di modifica immagine GPT su questa route restituiscono dati immagine base64 inline
output_formatcontrolla il tipo di immagine codificata all’interno dib64_jsonresponse_formatconta solo quando un modello supporta l’output URLqwen-image-editsegue un comportamento di modifica specifico del provider dietro la stessa route CometAPI
Autorizzazioni
Bearer token authentication. Use your CometAPI key.
Corpo
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.
Risposta
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.