Edición y variaciones de imágenes
API de sustitución de modelos con IA MCP
Generar imágenes modelo combinando una imagen de producto fuente con una imagen de cabeza modelo, máscaras opcionales, referencias de escena y guía rápida.
Prompts y casos de uso de API de sustitución de modelos 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. Reemplazar el modelo en una imagen de producto
Prompt: Uso [source outfit image] y [target model head image] para crear una nueva presentación de modelos al tiempo que conserva los detalles del traje.
2. Crear varias alternativas
Prompt: Uso [source outfit image] y [target model head image] para crear una nueva presentación de modelos al tiempo que conserva los detalles del traje. Crear [number of outputs within this tool’s supported limit] para su revisión, manteniendo el mismo material fuente y breve.
3. Seguir una referencia de escena
Prompt: Uso [source outfit image] y [target model head image] para crear una nueva presentación de modelos al tiempo que conserva los detalles del traje. Uso [scene reference image] y [reference strength from zero to one] para guiar el escenario.
4. Mantener Resolución y Apariencia Modelo
Prompt: Uso [source outfit image] y [target model head image] para crear una nueva presentación de modelos al tiempo que conserva los detalles del traje. Elija si guardar la resolución original de la imagen y si prefiere una apariencia modelo realista.
5. Directa la apariencia modelo
Prompt: Uso [source outfit image] y [target model head image] para crear una nueva presentación de modelos al tiempo que conserva los detalles del traje. Seguir [model appearance and positive directions], y evitar [unwanted visual features]. Mantenga el traje suministrado consistente.
6. Mantenga el asunto seleccionado
Prompt: Uso [source outfit image] y [target model head image] para crear una nueva presentación de modelos al tiempo que conserva los detalles del traje. Uso [subject segmentation mask] para guiar qué parte de la imagen original debe seguir siendo el tema.
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_ai_model_swaphttps://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": "ai-model-swap-1",
"method": "tools/call",
"params": {
"name": "nexscope_ai_model_swap",
"arguments": {
"customNegPrompt": "blur, distorted hands",
"customPrompt": "clean ecommerce catalog photo",
"genOriRes": false,
"imageSegUrl": "https://example.com/mask.png",
"imageUrl": "https://example.com/source-image.jpg",
"modelHeadImageUrl": "https://example.com/model-reference.jpg",
"modelPrompt": "smile, slim",
"outputNum": 1,
"realModel": true,
"sceneImgUrl": "https://example.com/scene.jpg",
"sceneStrength": 0.7
}
}
}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": "ai-model-swap-result-1",
"method": "tools/call",
"params": {
"name": "nexscope_media_task_result",
"arguments": {
"skillSlug": "ai-model-swap",
"taskId": "TASK_ID_FROM_THE_GENERATION_RESULT"
}
}
}Argumentos
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
imageUrl | string | obligatorio | Público URL del producto fuente o imagen de atuendo. La imagen debe ser de hasta 20 MB y entre 385 y 8192 píxeles en ancho y altura. Ejemplo: https://example.com/source-image.jpg |
modelHeadImageUrl | string | obligatorio | Público URL de la imagen de la cabeza modelo objetivo. La imagen debe ser de hasta 5 MB y entre 512 y 2048 píxeles en ancho y altura. Ejemplo: https://example.com/model-reference.jpg |
imageSegUrl | string | opcional | Máscara de segmentación opcional URL para la imagen fuente. Ejemplo: https://example.com/mask.png |
sceneImgUrl | string | opcional | Imagen de referencia de escena opcional URL. La imagen debe ser hasta 10 MB y entre 768 y 4096 píxeles en ancho y altura. Ejemplo: https://example.com/scene.jpg |
sceneStrength | number | opcional | Fuerza de referencia de 0 a 1. Defaults a 0.7. Ejemplo: 0.7 |
modelPrompt | string | opcional | Los términos de apariencia modelo separados por comma, tales como sonrisa, risa, sentarse, mentir, grasa, plomería, delgado, laterales, perfil, espalda o calvo. Ejemplo: smile, slim |
customPrompt | string | opcional | Generación positiva, hasta 600 caracteres. Ejemplo: clean ecommerce catalog photo |
customNegPrompt | string | opcional | Incitación negativa para evitar artefactos no deseados. Ejemplo: blur, distorted hands |
genOriRes | boolean | opcional | Ya sea para generar la resolución original. Defaults to false. Ejemplo: false |
realModel | boolean | opcional | Ya sea para preferir un estilo de modelo realista. Ejemplo: true |
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
Uso [source outfit image] y [target model head image] para crear una nueva presentación de modelos al tiempo que conserva los detalles del traje.
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-model-swap-example",
"method": "tools/call",
"params": {
"name": "nexscope_ai_model_swap",
"arguments": {
"customNegPrompt": "blur, distorted hands",
"customPrompt": "clean ecommerce catalog photo",
"genOriRes": false,
"imageSegUrl": "https://example.com/mask.png",
"imageUrl": "https://example.com/source-image.jpg",
"modelHeadImageUrl": "https://example.com/model-reference.jpg",
"modelPrompt": "smile, slim",
"outputNum": 1,
"realModel": true,
"sceneImgUrl": "https://example.com/scene.jpg",
"sceneStrength": 0.7
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "ai-model-swap-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
}
}