Référence API
Guides d’intégration
Erreurs
Tarification et facturation
Édition d’images avec GPT-Image-1
Utilisez POST /v1/images/edits avec gpt-image-1 dans CometAPI pour modifier des images via des masques, des prompts et des options de taille, en accord avec le comportement d’édition d’images d’OpenAI.
curl --request POST \
--url https://api.cometapi.com/v1/images/edits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=Add a small red ribbon to the paper boat.' \
--form image='@example-file' \
--form mask='@example-file'{
"created": 1773381100,
"usage": {
"input_tokens": 226,
"input_tokens_details": {
"image_tokens": 194,
"text_tokens": 32
},
"output_tokens": 4160,
"total_tokens": 4386
},
"data": [
{
"b64_json": "<base64-image-data>"
}
]
}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 masque pour des changements ciblés
- Vous pouvez gérer un téléversement de fichier multipart au lieu d’une simple requête JSON
Premier parcours de validation
- Commencez avec un fichier PNG ou JPG
- Ignorez le masque jusqu’à ce que le flux d’édition de base fonctionne
- Utilisez une instruction courte demandant un seul changement visible
- Attendez-vous à une latence plus élevée que pour une génération d’image simple
Comportement du modèle
gpt-image-1,gpt-image-1-minietgpt-image-1.5sont plus adaptés à des routes d’édition basées d’abord sur du base64dall-e-3peut renvoyer une sortie URL lorsque le chemin du fournisseur le prend en chargeqwen-image-editsuit le comportement d’édition spécifique au fournisseur derrière la même route CometAPI
gpt-image-1 basée sur PNG a réussi lorsqu’un délai d’expiration plus long était autorisé. La réponse a renvoyé usage.input_tokens, usage.output_tokens, usage.total_tokens et une charge utile data[0].b64_json.Autorisations
Bearer token authentication. Use your CometAPI key.
Corps
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 current model from the Models page.
Optional PNG mask. Transparent areas indicate regions that should be edited.
Number of edited images to return.
Quality setting for models that support it.
high, medium, low Requested output format when supported by the selected model.
url, b64_json Requested output size when supported by the selected model.
curl --request POST \
--url https://api.cometapi.com/v1/images/edits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=Add a small red ribbon to the paper boat.' \
--form image='@example-file' \
--form mask='@example-file'{
"created": 1773381100,
"usage": {
"input_tokens": 226,
"input_tokens_details": {
"image_tokens": 194,
"text_tokens": 32
},
"output_tokens": 4160,
"total_tokens": 4386
},
"data": [
{
"b64_json": "<base64-image-data>"
}
]
}