Edición y variaciones de imágenes

API de reconstrucción de áreas de imágenes MCP

Reparar o regenerar una región de imagen local usando una máscara y un rápido.

CosteEst. 47–57 créditos por llamadaPrueba en línea

Prompts y casos de uso de API de reconstrucción de áreas 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. Redibujar una zona seleccionada de la imagen

Prompt: Redraw el área enmascarada de [base image] utilizando [mask image] y [editing brief]. Conserva el contexto fuera de la máscara.

2. Crear varias alternativas

Prompt: Redraw el área enmascarada de [base image] utilizando [mask image] y [editing brief]. Conserva el contexto fuera de la máscara. Crear [number of outputs within this tool’s supported limit] para su revisión, manteniendo el mismo material fuente y breve.

3. Reemplazar un fondo de producto enmascarado

Prompt: In [product image], reemplazar sólo el área de fondo marcada por [mask image] con [new background brief]. Mantener el producto desenmascarado sin cambios y devolver una imagen completa cuando esté listo. Revise el resultado de cambios de producto no deseados.

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.

Solicitar uno a cuatro salidas; el defecto es uno.

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/json

Autenticació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

Nombre de la herramienta MCP

nexscope_image_inpainting

Punto de conexión MCP

https://api.nexscope.ai/mcp

Método JSON-RPC

tools/call

Inicializa 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": "image-inpainting-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_image_inpainting",
    "arguments": {
      "imageUrl": "https://example.com/product.jpg",
      "maskUrl": "https://example.com/mask.png",
      "outputNum": 1,
      "prompt": "remove scratches and keep the product realistic"
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

La 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": "image-inpainting-result-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_media_task_result",
    "arguments": {
      "skillSlug": "image-inpainting",
      "taskId": "TASK_ID_FROM_THE_GENERATION_RESULT"
    }
  }
}

Argumentos

Nombre	Tipo	Obligatorio	Descripción
`imageUrl`	`string`	obligatorio	Público URL de la imagen base. 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	Prompt describiendo cómo redibujar el área enmascarada. Ejemplo: remove scratches and keep the product realistic
`maskUrl`	`string`	obligatorio	Público URL de la imagen de la máscara. Ejemplo: https://example.com/mask.png
`outputNum`	`integer`	opcional	Número de imágenes para generar, de 1 a 4. Defaults a 1. Ejemplo: 1

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

Use Image Inpainting con el material de referencia suministrado para este breve: eliminar los arañazos y mantener el producto realista

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": "image-inpainting-example",
  "method": "tools/call",
  "params": {
    "name": "nexscope_image_inpainting",
    "arguments": {
      "imageUrl": "https://example.com/product.jpg",
      "maskUrl": "https://example.com/mask.png",
      "outputNum": 1,
      "prompt": "remove scratches and keep the product realistic"
    }
  }
}

Formato de respuesta MCP

{
  "jsonrpc": "2.0",
  "id": "image-inpainting-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
  }
}

API de reconstrucción de áreas de imágenes MCP

Prompts y casos de uso de API de reconstrucción de áreas de imágenes

1. Redibujar una zona seleccionada de la imagen

2. Crear varias alternativas

3. Reemplazar un fondo de producto enmascarado

Qué debes proporcionar

Conecta tu asistente de IA

Autenticación

Llamar a esta herramienta MCP

Flujo de tareas asíncronas

Argumentos

Campos de respuesta

Opción 1 de cualquier alternativa — requiere taskId, status, result

Opción 1 de cualquier alternativa

Opción 2 de cualquier alternativa

Opción 2 de cualquier alternativa

Ilustración del formato

Pregunta ilustrativa

Explicación ilustrativa de la respuesta

Ejemplos

Solicitud MCP

Formato de respuesta MCP

Herramientas MCP relacionadas