Skip to main content
POST
Utilisez cette route pour modifier des images existantes avec des uploads multipart compatibles OpenAI sur CometAPI.

​
Utilisez cette route lorsque

  • Vous avez déjà une image source et souhaitez une modification guidée par prompt
  • Vous pouvez avoir besoin d’un mask pour des modifications ciblées
  • Vous pouvez gérer un upload de fichier multipart au lieu d’une requête JSON simple

​
Première requête sûre

  • Commencez avec un seul fichier PNG ou JPG
  • Ignorez le mask jusqu’à ce que le flux de modification de base fonctionne
  • Utilisez model: "gpt-image-2" pour les requêtes de modification d’image GPT sur cette route
  • Utilisez une instruction courte qui demande un seul changement visible
  • Lisez le résultat modifié depuis data[0].b64_json
  • Définissez output_format: "jpeg" lorsque vous voulez une charge utile JPEG
  • Attendez-vous à une latence plus longue que pour une génération d’image simple

​
Comportement du modèle

  • Les modèles de modification d’image GPT sur cette route renvoient des données d’image base64 inline
  • output_format contrôle le type d’image encodée à l’intérieur de b64_json
  • response_format n’a d’importance que lorsqu’un modèle prend en charge une sortie par URL
  • qwen-image-edit suit un comportement de modification spécifique au fournisseur derrière la même route CometAPI

Autorisations

​
Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

Corps

multipart/form-data
​
image
file
requis

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

​
prompt
string
requis

Edit instruction describing the change you want.

Exemple:

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

​
model
string
défaut: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
défaut:1

Number of edited images to return.

​
quality
enum<string>

Quality setting for models that support it.

Options 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.

Options 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.

Exemple:

"jpeg"

​
size
string

Requested output size when supported by the selected model.

Réponse

200 - application/json

Edited image result.

​
created
integer
requis
​
usage
object
requis
​
data
object[]
requis
​
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.