Référence API
Guides d’intégration
Bibliothèques
Erreurs
Tarification et facturation
Édition d’images
Utilisez POST /v1/images/edits dans CometAPI pour modifier des images via des masques, des prompts et des options de taille, en conformité 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 modifications ciblées
- Vous pouvez gérer un upload de fichier multipart au lieu d’une simple requête JSON
Premier parcours de validation
- Commencez avec un seul fichier PNG ou JPG
- Ignorez le masque jusqu’à ce que le flux de base de modification fonctionne
- Utilisez une instruction courte demandant un seul changement visible
- Attendez-vous à une latence plus longue que pour une génération d’image standard
Comportement du modèle
gpt-image-1,gpt-image-1-mini, etgpt-image-1.5sont principalement des routes d’édition base64-firstdall-e-3peut renvoyer une sortie URL lorsque le parcours du fournisseur le prend en chargeqwen-image-editsuit le comportement d’édition spécifique au fournisseur derrière la même route CometAPI
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>"
}
]
}