Edición y variaciones de imágenes

API de reparación de manos con IA MCP

Mejorar la apariencia de la mano en las imágenes generadas modelo o estilo de vida.

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

Prompts y casos de uso de API de reparación de manos con IA

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. Reparar una mano en una imagen

Prompt: Repara la mano en [image] para [girl, boy, adult woman or adult man]. Mantenga la persona circundante y el producto visualmente consistente.

2. Crear varias alternativas

Prompt: Repara la mano en [image] para [girl, boy, adult woman or adult man]. Mantenga la persona circundante y el producto visualmente consistente. Crear [number of outputs within this tool’s supported limit] para su revisión, manteniendo el mismo material fuente y breve.

3. Reparación de mano límite a una máscara

Prompt: Repara la mano en [image] para [girl, boy, adult woman or adult man]. Mantenga la persona circundante y el producto visualmente consistente. Uso [hand-area mask] para guiar la región de reparación, preservando el resto de la imagen.

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

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": "ai-hand-repair-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_ai_hand_repair",
    "arguments": {
      "imageUrl": "https://example.com/model-reference.jpg",
      "maskUrl": "https://example.com/mask.png",
      "outputNum": 1,
      "personType": 2
    }
  }
}

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

Argumentos

Nombre	Tipo	Obligatorio	Descripción
`imageUrl`	`string`	obligatorio	Público URL de la imagen que requiere reparación manual. 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/model-reference.jpg
`personType`	`integer`	obligatorio	Tipo de persona. Valores compatibles: 0 (chica), 1 (chico), 2 (mujer adulta), 3 (hombre adulto). Ejemplo: 2
`maskUrl`	`string`	opcional	Máscara opcional URL para el área de reparación de manos. 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

Repara la mano en [image] para [girl, boy, adult woman or adult man]. Mantenga la persona circundante y el producto visualmente consistente.

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": "ai-hand-repair-example",
  "method": "tools/call",
  "params": {
    "name": "nexscope_ai_hand_repair",
    "arguments": {
      "imageUrl": "https://example.com/model-reference.jpg",
      "maskUrl": "https://example.com/mask.png",
      "outputNum": 1,
      "personType": 2
    }
  }
}

Formato de respuesta MCP

{
  "jsonrpc": "2.0",
  "id": "ai-hand-repair-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
  }
}