Descripción general
Referencia de la API
Guías de integración
Errores
Precios y facturación
Edición de imágenes con GPT-Image-1
Usa POST /v1/images/edits con gpt-image-1 en CometAPI para editar imágenes mediante máscaras, prompts y opciones de tamaño, alineado con el comportamiento de edición de imágenes de 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>"
}
]
}Usa esta ruta cuando
- Ya tienes una imagen de origen y quieres una edición guiada por prompt
- Puede que necesites una máscara para cambios específicos
- Puedes manejar una carga de archivos multipart en lugar de una solicitud JSON simple
Primera ruta de validación
- Comienza con un archivo PNG o JPG
- Omite la máscara hasta que el flujo base de edición funcione
- Usa una instrucción corta que pida un único cambio visible
- Espera una latencia mayor que en la generación de imágenes simple
Comportamiento del modelo
gpt-image-1,gpt-image-1-miniygpt-image-1.5se tratan mejor como rutas de edición orientadas primero a base64dall-e-3puede devolver una salida en URL cuando la ruta del proveedor lo admiteqwen-image-editsigue el comportamiento de edición específico del proveedor detrás de la misma ruta de CometAPI
gpt-image-1 se realizó correctamente cuando se permitió un timeout más largo. La respuesta devolvió usage.input_tokens, usage.output_tokens, usage.total_tokens y una carga útil data[0].b64_json.Autorizaciones
Bearer token authentication. Use your CometAPI key.
Cuerpo
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>"
}
]
}