Create image edit

curl https://api.cometapi.com/v1/images/edits \ -H "Authorization: Bearer $COMETAPI_KEY" \ -F image=@cat.jpg \ -F prompt="Add a small red bow tie on the cat" \ -F model=gpt-image-2 \ -F quality=low

{ "created": 1781075000, "background": "opaque", "output_format": "png", "quality": "low", "size": "1024x1024", "usage": { "input_tokens": 784, "input_tokens_details": { "image_tokens": 768, "text_tokens": 16 }, "output_tokens": 196, "output_tokens_details": { "image_tokens": 196, "text_tokens": 0 }, "total_tokens": 980 }, "data": [ { "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." } ] }

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.

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

Show child attributes

data

object[]

requis

Show child attributes

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.

curl https://api.cometapi.com/v1/images/edits \ -H "Authorization: Bearer $COMETAPI_KEY" \ -F image=@cat.jpg \ -F prompt="Add a small red bow tie on the cat" \ -F model=gpt-image-2 \ -F quality=low

Modération de contenu

Clés API

Utilisez cette route lorsque

Première requête sûre

Comportement du modèle

Autorisations

Corps

Réponse

​Utilisez cette route lorsque

​Première requête sûre

​Comportement du modèle

Autorisations

Corps

Réponse

Utilisez cette route lorsque

Première requête sûre

Comportement du modèle