Edición y variaciones de imágenes
API v3 de edición y manipulación inteligente de imágenes MCP
Realizar la edición general de imágenes con el proveedor, la resolución, la relación de aspecto y los controles de calidad.
Prompts y casos de uso de API v3 de edición y manipulación inteligente de imágenes
Después de conectar esta herramienta MCP a tu asistente de IA, puedes plantear las preguntas siguientes. Sustituye los marcadores entre corchetes por tus datos y usa los valores admitidos en Argumentos.
¿Es tu primera vez con Nexscope MCP? Sigue la guía de conexión, y después usa los prompts siguientes. Las pestañas Integración y Parámetros y respuesta contienen los pasos de conexión, un ejemplo de llamada y la referencia técnica.
1. Editar una imagen de producto
Prompt: Editar [image] según [editing brief] utilizando [supported image model]. Conserva los datos del producto y las partes que he pedido mantener.
2. Crear varias alternativas
Prompt: Editar [image] según [editing brief] utilizando [supported image model]. Conserva los datos del producto y las partes que he pedido mantener. Crear [number of outputs within this tool’s supported limit] para su revisión, manteniendo el mismo material fuente y breve.
3. Fitar la salida a un lugar
Prompt: Editar [image] según [editing brief] utilizando [supported image model]. Conserva los datos del producto y las partes que he pedido mantener. Uso [supported resolution] y [supported aspect ratio] para mi destino. Compruebe la compatibilidad con el modelo de imagen seleccionado.
4. Elija GPT Calidad de imagen
Prompt: Editar [image] según [editing brief] utilizando [supported image model]. Conserva los datos del producto y las partes que he pedido mantener. Al utilizar el soporte GPT Proveedor de imagen, uso [low, medium or high quality]. No aplique esta opción específica del proveedor a otros modelos.
5. Elija la ruta de edición
Prompt: Editar [image] según [editing brief] utilizando [supported image model]. Conserva los datos del producto y las partes que he pedido mantener. Uso [economy or stable generation] y elegir si refinar mi instrucción de edición antes de procesar. Conserva el cambio que he solicitado.
6. Aplicar el texto de fondo blanco
Prompt: Editar [image] según [editing brief] utilizando [supported image model]. Conserva los datos del producto y las partes que he pedido mantener. Utilice la plantilla de fondo blanco para esta edición, con mi material y direcciones suministrados. Revise el resultado antes de utilizarlo públicamente.
7. Aplicar la imagen principal del producto Retouching Editar
Prompt: Editar [image] según [editing brief] utilizando [supported image model]. Conserva los datos del producto y las partes que he pedido mantener. Utilice la plantilla de retoque de imagen principal del producto para esta edición, con mi material y direcciones suministrados. Revise el resultado antes de utilizarlo públicamente.
8. Aplicar la edición de generación de la escena
Prompt: Editar [image] según [editing brief] utilizando [supported image model]. Conserva los datos del producto y las partes que he pedido mantener. Utilice la plantilla de generación de escena para esta edición, con mis materiales y direcciones suministrados. Revise el resultado antes de utilizarlo públicamente.
9. Aplicar la edición del diseño del póster
Prompt: Editar [image] según [editing brief] utilizando [supported image model]. Conserva los datos del producto y las partes que he pedido mantener. Utilice la plantilla de diseño de pósters para esta edición, con mis materiales y direcciones suministrados. Revise el resultado antes de utilizarlo públicamente.
10. Aplicar la edición de Add Person or Object
Prompt: Editar [image] según [editing brief] utilizando [supported image model]. Conserva los datos del producto y las partes que he pedido mantener. Utilice la plantilla de añadir persona o objeto para esta edición, con mi material y direcciones suministrados. Revise el resultado antes de utilizarlo públicamente.
11. Aplicar el cambio de animal Editar
Prompt: Editar [image] según [editing brief] utilizando [supported image model]. Conserva los datos del producto y las partes que he pedido mantener. Utilice la plantilla de cambio animal para esta edición, con mis materiales y direcciones suministrados. Revise el resultado antes de utilizarlo públicamente.
12. Aplicar la versión plana del Apparel
Prompt: Editar [image] según [editing brief] utilizando [supported image model]. Conserva los datos del producto y las partes que he pedido mantener. Utilice la plantilla de prendas planas para esta edición, con mis materiales y direcciones suministrados. Revise el resultado antes de utilizarlo públicamente.
13. Aplicar el Apparel 3D Editar
Prompt: Editar [image] según [editing brief] utilizando [supported image model]. Conserva los datos del producto y las partes que he pedido mantener. Utilice la plantilla de 3d apparel para esta edición, con mis materiales y direcciones suministrados. Revise el resultado antes de utilizarlo públicamente.
14. Aplicar el Maniquí para modelar Editar
Prompt: Editar [image] según [editing brief] utilizando [supported image model]. Conserva los datos del producto y las partes que he pedido mantener. Utilice el maniquí para modelar plantilla para esta edición, con mi material suministrado y direcciones. Revise el resultado antes de utilizarlo públicamente.
15. Aplique la ilustración de Caricatura Editar
Prompt: Editar [image] según [editing brief] utilizando [supported image model]. Conserva los datos del producto y las partes que he pedido mantener. Utilice la plantilla de ilustración de dibujos animados para esta edición, con mi material y direcciones suministrados. Revise el resultado antes de utilizarlo públicamente.
16. Aplicar la versión de la remodelación del cuerpo
Prompt: Editar [image] según [editing brief] utilizando [supported image model]. Conserva los datos del producto y las partes que he pedido mantener. Utilice la plantilla de reformación del cuerpo para esta edición, con mi material suministrado y direcciones. Revise el resultado antes de utilizarlo públicamente.
17. Aplicar la edición de estilo de cambio
Prompt: Editar [image] según [editing brief] utilizando [supported image model]. Conserva los datos del producto y las partes que he pedido mantener. Utilice la plantilla de estilo de cambio para esta edición, con mis materiales y direcciones suministrados. Revise el resultado antes de utilizarlo públicamente.
18. Aplicar el elemento de eliminación Editar
Prompt: Editar [image] según [editing brief] utilizando [supported image model]. Conserva los datos del producto y las partes que he pedido mantener. Utilice la plantilla de elemento de eliminación para esta edición, con mi material y direcciones suministrados. Revise el resultado antes de utilizarlo públicamente.
19. Aplicar el texto de quitar
Prompt: Editar [image] según [editing brief] utilizando [supported image model]. Conserva los datos del producto y las partes que he pedido mantener. Utilice la plantilla de texto de eliminación para esta edición, con mi material y direcciones suministrados. Revise el resultado antes de utilizarlo públicamente.
20. Aplicar la edición de Remove Watermark
Prompt: Editar [image] según [editing brief] utilizando [supported image model]. Conserva los datos del producto y las partes que he pedido mantener. Utilice la plantilla de marca de agua para esta edición, con mi material y direcciones suministrados. Revise el resultado antes de utilizarlo públicamente.
21. Aplicar la edición Añadir Watermark
Prompt: Editar [image] según [editing brief] utilizando [supported image model]. Conserva los datos del producto y las partes que he pedido mantener. Utilice la plantilla de marca de agua adicional para esta edición, con mi material y direcciones suministrados. Revise el resultado antes de utilizarlo públicamente.
Qué debes proporcionar
Proporciona recursos que tengas derecho a usar y que cumplan los límites documentados de formato, dimensiones y cantidad de archivos de esta herramienta.
Una tarea pendiente todavía no ofrece un resultado final de imagen, vídeo o texto. Consulta la tarea existente en vez de enviar otra solicitud idéntica.
Paso 1 · Conectar
Conecta tu asistente de IA
Conecta un cliente MCP compatible a Nexscope y selecciona esta herramienta en tu asistente. Completa la autenticación en la configuración de conexión del cliente.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAutenticación
Usa el código de autorización OAuth 2.1 con PKCE y el ámbito mcp:tools. Las claves de API siguen siendo una opción de compatibilidad admitida.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxx¿Usas una clave de API? Obtén tu clave en Acceso a la API e inclúyela en el encabezado Authorization que se muestra arriba.
Llamar a esta herramienta MCP
nexscope_smart_image_edit_manipulation_v3https://api.nexscope.ai/mcptools/callInicializa una sesión HTTP Streamable MCP 2025-11-25 en https://api.nexscope.ai/mcp y después usa tools/call.
{
"jsonrpc": "2.0",
"id": "smart-image-edit-manipulation-v3-1",
"method": "tools/call",
"params": {
"name": "nexscope_smart_image_edit_manipulation_v3",
"arguments": {
"aspectRatio": "1:1",
"imageUrl": "https://example.com/product.jpg",
"needOptimize": true,
"outputNum": 1,
"prompt": "make the background pure white and keep the product unchanged",
"provider": "BANANA_PRO",
"quality": "medium",
"resolution": "1K",
"source": "api",
"supplyType": "stable",
"template": "white-background"
}
}
}MCP 2025-11-25 · Streamable HTTPLa respuesta SSE del POST inicial comunica el progreso. El flujo SSE por GET transmite notificaciones; si se restablece la conexión, consulta la tarea asíncrona existente en vez de enviarla de nuevo.
Flujo de tareas asíncronas
- 1. Crear una sola vez
Conserva el taskId devuelto.
- 2. Consultar con espera progresiva
Usa nexscope_media_task_result después de 5 segundos y luego de 10, 20 y 30 segundos.
- 3. Usar el resultado final
Detén las consultas al obtener éxito, fallo o tiempo de espera agotado.
{
"jsonrpc": "2.0",
"id": "smart-image-edit-manipulation-v3-result-1",
"method": "tools/call",
"params": {
"name": "nexscope_media_task_result",
"arguments": {
"skillSlug": "smart-image-edit-manipulation-v3",
"taskId": "TASK_ID_FROM_THE_GENERATION_RESULT"
}
}
}Argumentos
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
imageUrl | string | obligatorio | Público URL de la imagen para editar. La imagen debe estar entre 300 y 4096 píxeles tanto en ancho como en altura, y su relación de anchura a altura debe ser entre 0.4 y 2.5. Ejemplo: https://example.com/product.jpg |
prompt | string | obligatorio | Edición de instrucciones. Ejemplo: make the background pure white and keep the product unchanged |
provider | string | obligatorio | Modelo de imagen. Valores compatibles: BANANA, BANANA_2, BANANA_PRO, WAN2_7, QWEN_IMAGE_3_PRO, SEEDREAM5, GPT_2_IMAGEo AIDRAW_EDIT. Ejemplo: BANANA_PRO |
outputNum | integer | opcional | Número de imágenes para generar, de 1 a 4. Ejemplo: 1 |
resolution | string | opcional | Predeterminado de resolución de objetivos. Ejemplo: 1K |
aspectRatio | string | opcional | Relación de aspecto objetivo. Ejemplo: 1:1 |
supplyType | string | opcional | Ruta de generación. Valores compatibles: eco o estable. Defaults to stable. Ejemplo: stable |
needOptimize | boolean | opcional | Si el aviso debe ser optimizado hasta arriba. Ejemplo: true |
template | string | opcional | Facultativo Nexscope plantilla de edición. Valores compatibles: fondo-blanco, producto-main-image-retouching, escena-generación, poster-design, add-person-or-object, change-animal, plano-lay-apparel, 3d-apparel, mannequin-to-model, ilustración de dibujos animados, cuerpo-reshape, cambio-estilo, eliminación-texto, remove-watermark, add-watermark. Ejemplo: white-background |
source | string | opcional | Código de tráfico o fuente de producto opcional. Ejemplo: api |
quality | string | opcional | GPT Calidad de imagen solamente. Valores compatibles: bajo, mediano o alto. Defaults a medium. Ejemplo: medium |
Campos de respuesta
Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | integer | obligatorio | 0 indica que la solicitud se ha aceptado o se ha completado correctamente; cualquier valor distinto de cero indica un error de la plataforma. |
cost | string | obligatorio | Milliseconds pasados, nunca créditos; -1 solicitudes fuera de la web. |
data | any | obligatorio | Valor de Data usado por esta operación de API. |
msg | string | null | obligatorio | Valor de Msg usado por esta operación de API. |
time | string | obligatorio | Tiempo local del servidor: yyyy-MM- No. HH:mm:ss. |
traceId | string | null | obligatorio | Valor de Trace id usado por esta operación de API. |
ts | string | obligatorio | Época milisegundos. |
Opción 1 de cualquier alternativa — requiere taskId, status, result
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data | object | obligatorio | Valor de Data usado por esta operación de API. |
data.result | any | obligatorio | Producción completa de generación retenida del resultado de la tarea. Las esferas varían según la capacidad; el uso generado de los recursos Nexscope- hospedado URLs y cualquier cargo representa Nexscope créditos. Esta es la salida del negocio, no un recibo de creación de tareas. |
data.status | string | obligatorio | Valor de Status usado por esta operación de API. Permitidos: PENDING, RUNNING, SUCCEEDED, FAILED, TIMEOUT |
data.taskId | string | obligatorio | Valor de Task id usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result | object | obligatorio | Producción completa de generación retenida del resultado de la tarea. Las esferas varían según la capacidad; el uso generado de los recursos Nexscope- hospedado URLs y cualquier cargo representa Nexscope créditos. Esta es la salida del negocio, no un recibo de creación de tareas. |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result | null | obligatorio | Producción completa de generación retenida del resultado de la tarea. Las esferas varían según la capacidad; el uso generado de los recursos Nexscope- hospedado URLs y cualquier cargo representa Nexscope créditos. Esta es la salida del negocio, no un recibo de creación de tareas. |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data | null | obligatorio | Valor de Data usado por esta operación de API. |
Ilustración del formato
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
Pregunta ilustrativa
Utilice Smart Image Editar " Manipulation con el material de referencia suministrado para este breve: hacer el fondo blanco puro y mantener el producto sin cambios
Explicación ilustrativa de la respuesta
La solicitud del ejemplo se aceptó como tarea example-task y está en estado PENDING. Aún no hay un resultado final. Conserva el ID de la tarea y consulta su resultado; no vuelvas a enviarla solo porque sigue en curso.
Sobre esta muestra: Ejemplo de formato con valores ficticios; no procede de una llamada real a la herramienta. Sustituye los datos de ejemplo por recursos que tengas derecho a usar o identificadores públicos.
No hay datos de ejemplo publicados para esta página. Una ilustración del formato o una guía de flujo de trabajo no sustituye un resultado publicado.
Ver el formato de solicitud y respuesta MCP
Ejemplos
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
La estructura JSON-RPC siguiente muestra cómo se presentan en MCP los argumentos y los datos indicados. No procede de una captura de tráfico ni demuestra que la llamada se haya completado. Los ejemplos de flujo de trabajo no muestran un resultado.
Solicitud MCP
{
"jsonrpc": "2.0",
"id": "smart-image-edit-manipulation-v3-example",
"method": "tools/call",
"params": {
"name": "nexscope_smart_image_edit_manipulation_v3",
"arguments": {
"aspectRatio": "1:1",
"imageUrl": "https://example.com/product.jpg",
"needOptimize": true,
"outputNum": 1,
"prompt": "make the background pure white and keep the product unchanged",
"provider": "BANANA_PRO",
"resolution": "1K",
"source": "api",
"supplyType": "stable",
"template": "white-background"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "smart-image-edit-manipulation-v3-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"cost\":\"-1\",\"data\":{\"taskId\":\"example-task\",\"status\":\"PENDING\",\"result\":null},\"msg\":null,\"time\":\"2026-01-01 00:00:00\",\"traceId\":null,\"ts\":\"0\"}"
}
],
"structuredContent": {
"code": 0,
"cost": "-1",
"data": {
"taskId": "example-task",
"status": "PENDING",
"result": null
},
"msg": null,
"time": "2026-01-01 00:00:00",
"traceId": null,
"ts": "0"
},
"isError": false
}
}