API de sustitución de modelos con IA

Coloca una imagen de producto de comercio electrónico sobre un modelo de destino. Revisa la autenticación, los parámetros de solicitud, los campos de respuesta y el uso de MCP.

CosteCredit usage unavailable

Probar en línea

POST · https://api.nexscope.ai/ai/modelSwapMCP · nexscope_ai_model_swap

Se requiere suscripción. Las API de IA creativa solo están disponibles para usuarios con una suscripción activa. Los créditos de prueba no habilitan el acceso con clave de API. Ver planes de suscripción.

Qué hace esta API

Generar imágenes de modelos combinando una imagen de producto de origen con una imagen de cabeza de modelo, máscaras opcionales, referencias de escena y prompt.

Casos de uso de API de sustitución de modelos con IA

Investigar el intercambio de modelos de IA

Para investigar el intercambio de modelos ai, un editor de contenido presenta imageUrl y modelHeadImageUrl Los resultados de generación completados devueltos ayudan a investigar la operación solicitada.

Recopilar evidencia de intercambio de modelos de IA

Un editor de contenido utiliza el intercambio de modelos de IA con imageUrl y modelHeadImageUrl Los resultados de generación completados devueltos ayudan a comparar la evidencia para el alcance solicitado.

Revisión de los resultados del intercambio de modelos de IA

Para este flujo de trabajo, un editor de contenido llama a IA Model Swap con imageUrl y modelHeadImageUrl El resultado ayuda a revisar los hechos devueltos con el equipo.

Preguntas frecuentes sobre API de sustitución de modelos con IA

¿Qué hace el intercambio de modelo de IA? API ¿Volver?

Generar imágenes de modelo combinando una imagen de producto de origen con una imagen de cabeza de modelo, máscaras opcionales, referencias de escena y prompt. `imageUrl`, `modelHeadImageUrl`, `imageSegUrl`, `sceneImgUrl`, `sceneStrength`. La respuesta inicial puede contener un ID de tarea y el estado; el resultado de la tarea completa contiene la salida generada. Los valores de ejemplo ilustran la forma de respuesta, en lugar de los resultados reales de la cuenta.

¿Cuántos créditos tiene el modelo de IA Swap API ¿costo?

El coste documentado actualmente es Credit usage unavailable. Es el mismo que figura en la parte superior de esta página. Si se muestra un intervalo o una estimación, el cargo final depende de la solicitud. Antes de llamar a la API, revisa los créditos disponibles y la página de precios. Consulta el registro de uso de la API para comprobar el cargo aplicado.

¿Cómo llamo al intercambio de modelos de IA? API desde mi aplicación o un MCP ¿Cliente?

Enviar a POST solicitud a /ai/modelSwap con tu API como un símbolo de portador y la JSON datos de entrada API En una MCP cliente como Claude o Cursor, conectar Nexscope y llamar nexscope_ai_model_swap. Utilice el MCP argumentos mostrados en el MCP guía, o cambiar la prueba en línea a MCP para revisar su solicitud antes de añadirla a tu aplicación.

Ver planes y créditos Conecta esta API con MCP (en inglés)

Prueba esta API

Endpoint

https://api.nexscope.ai/ai/modelSwap

Método MCP

nexscope_ai_model_swap

Paso 1 de 3 · Autenticarse

Autenticación

Todos los endpoints de ejecución requieren una clave de API de usuario. Envíala como token bearer en la cabecera Authorization .

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

Las claves de API ausentes o no válidas devuelven un error de autenticación. Gestiona las claves desde .

Paso 2 de 3 · Enviar una solicitud

POSThttps://api.nexscope.ai/ai/modelSwap

Ejecutar una API

Genera imágenes de modelos combinando una imagen de producto de origen con una imagen de cabeza de modelo, máscaras opcionales, referencias de escenas y guía rápida.

Solicitud de ejemplo

Sustituye YOUR_API_KEY y ejecuta este comando en tu terminal.

curl -X POST 'https://api.nexscope.ai/ai/modelSwap' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "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
}'

Ejemplo de código

{
  "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
}

Paso 3 de 3 · Inspeccionar el resultado

Comprueba la respuesta

Consulta code para ver el estado de la solicitud y data para ver el resultado. Abre la referencia de parámetros y respuestas para consultar las definiciones completas de los campos.

Códigos de estado HTTP

Código	Descripción
200	Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado.
429	Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503	La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
Opcional	X-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200.

Ver parámetros y respuesta Probar en línea

Todas las categorías/ IA multimodal

POSThttps://api.nexscope.ai/ai/modelSwap

Ejecutar esta API

Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.

Abrir área de pruebas

Endpoint

Método	`POST`
Ruta	`https://api.nexscope.ai/ai/modelSwap`
Autenticación	`Bearer API key`
Content-Type	`application/json`

Parámetros de la solicitud

Nombre	Tipo	Obligatorio	Descripción
`imageUrl`	`string`	obligatorio	Público URL La imagen debe ser de hasta 20 MB y entre 385 y 8192 píxeles en anchura y altura. Ejemplo: https://example.com/source-image.jpg
`modelHeadImageUrl`	`string`	obligatorio	Público URL La imagen debe ser de hasta 5 MB y entre 512 y 2048 píxeles en anchura y altura. Ejemplo: https://example.com/model-reference.jpg
`imageSegUrl`	`string`	opcional	Máscara de segmentación opcional URL para la imagen de origen. Ejemplo: https://example.com/mask.png
`sceneImgUrl`	`string`	opcional	Imagen de referencia opcional de la escena URL. La imagen debe ser de hasta 10 MB y entre 768 y 4096 píxeles tanto en ancho como en altura. Ejemplo: https://example.com/scene.jpg
`sceneStrength`	`number`	opcional	Resistencia de referencia de la escena de 0 a 1. Por defecto a 0.7. Ejemplo: 0.7
`modelPrompt`	`string`	opcional	Términos de apariencia del modelo separados por coma, como sonrisa, risa, sentarse, mentir, gordo, regordete, delgado, lateral, perfil, espalda o calvo. Ejemplo: smile, slim
`customPrompt`	`string`	opcional	Generación positiva, hasta 600 caracteres. Ejemplo: clean ecommerce catalog photo
`customNegPrompt`	`string`	opcional	Preaviso negativo para evitar artefactos no deseados. Ejemplo: blur, distorted hands
`genOriRes`	`boolean`	opcional	Si se debe generar la resolución original. Defaults to false. Ejemplo: false
`realModel`	`boolean`	opcional	Si prefieres un modelo realista. Ejemplo: true
`outputNum`	`integer`	opcional	Número de imágenes a generar, de 1 a 4. Por defecto a 1. Ejemplo: 1

Respuesta de ejemplo

Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.

{
  "code": 0,
  "cost": "-1",
  "data": {
    "result": null,
    "status": "PENDING",
    "taskId": "example-task"
  },
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "0"
}

Campos de respuesta

Nombre	Tipo	Obligatorio	Descripción
`code`	`integer`	obligatorio	0 significa aceptado o exitoso; no cero es un error de plataforma.
`cost`	`string`	obligatorio	Se pasó milisegundos, nunca créditos; -1 peticiones externas 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	Hora local del servidor: aaaa-mm-dd HH:mm:ss.
`traceId`	`string \| null`	obligatorio	Valor de Trace id usado por esta operación de API.
`ts`	`string`	obligatorio	Epoch 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	Valor de Result usado por esta operación de API.
`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 de generación completa retenida del resultado de la tarea. Los campos varían según la capacidad; uso de recursos generados Nexscope-organiza URLs y cualquier cuenta representa carga Nexscope créditos. Este es el resultado 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	Valor de Result usado por esta operación de API.

Opción 2 de cualquier alternativa

Nombre	Tipo	Obligatorio	Descripción
`data`	`null`	obligatorio	Valor de Data usado por esta operación de API.

Respuestas

Código	Descripción
200	Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado.
429	Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503	La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
Opcional	X-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200.

Paso 1 de 2 · Conectar tu cliente MCP

MCP

Usa el endpoint MCP cuando un agente necesite descubrir y llamar a herramientas de API con JSON-RPC.

GET /mcp/legacy

POST /mcp/legacy
Authorization: Bearer nk-xxxxxxxxxxxxxxxxx
Content-Type: application/json

Paso 2 de 2 · Llamar a la herramienta

Llamar a una herramienta

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

Prueba en línea

Ejecuta la API actual con tu clave de API y la carga JSON. Las pruebas en línea usan el entorno de API configurado de este sitio; el Endpoint y los ejemplos que puedes copiar usan la dirección de integración pública.

Crear una imagen

Imagen de origen*Obligatorio

Sube la imagen del producto o atuendo que quieras colocar en un modelo.

JPG, PNG, WEBP · 1 imagen · 20 MB · 385–8192 px por lado

0/1

Referencia del modelo*Obligatorio

Sube la referencia del modelo que debe orientar la persona generada.

JPG, PNG, WEBP · 1 imagen · 5 MB · 512–2048 px por lado

0/1

Imagen de máscaraOpcional

Si lo deseas, sube una máscara para controlar qué parte de la imagen de origen se usa.

JPG, PNG, WEBP · 1 imagen · 20 MB

0/1

Referencia de escenaOpcional

Si lo deseas, sube una referencia de escena para orientar el fondo.

JPG, PNG, WEBP · 1 imagen · 10 MB · 768–4096 px por lado

0/1

Ajustes de imagen

Intensidad de la escena

Controla cuánto se ajusta el resultado a la escena de referencia.

Descripción del modelo

Describe el aspecto, la pose y la expresión del modelo. Separa los atributos con comas.

Instrucciones adicionales

Añade instrucciones para la imagen final. Hasta 600 caracteres.

Qué evitar

Describe lo que quieres evitar en el resultado.

Mantener la resolución original

Genera la salida con la resolución original de la imagen de origen.

Estilo realista

Genera el modelo con un aspecto más realista.

Imágenes

Las claves de API requieren una suscripción activa. Los créditos de prueba no incluyen acceso a la API. Ver planes.

Estimación de uso no disponible

Los créditos finales se muestran junto al resultado.

Vista previa

Aquí aparecerá tu imagen

Generaciones recientes

Guardadas en este navegador durante 24 horas

Tus generaciones aparecerán aquí.

Probar con una clave API o MCP

Pruébalo

Envía una solicitud real con el mismo contrato que se muestra en la referencia.

Endpoint

/ai/modelSwap

Task result endpoint

/ai/modelSwap/tasks/{taskId}

Método de MCP

nexscope_ai_model_swap

Clave de API*

Contenido JSON*

cURL

curl -X POST \
  https://api.nexscope.ai/ai/modelSwap \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "customNegPrompt": "blur, distorted hands", "customPrompt": "clean ecommerce catalog photo", "genOriRes": false, "imageSegUrl": "", "imageUrl": "", "modelHeadImageUrl": "", "modelPrompt": "smile, slim", "outputNum": 1, "realModel": true, "sceneImgUrl": "", "sceneStrength": 0.7 }'

Respuesta

Todavía no hay respuesta. Ejecuta la solicitud para ver la respuesta aquí.

Resultado de la tarea

Los resultados se consultan automáticamente después de ejecutar la solicitud. También puedes introducir un ID de tarea y consultarlo manualmente; los recursos completados usan URL de Nexscope y muestran los créditos realmente cobrados.

Task ID

Respuesta del resultado

No task result yet. Query the task to see the generated output here.

API relacionadas

AI Apparel Image Set & Photography v3

Create apparel ecommerce image sets from clothing images with optional model and scene references.

AI Background Generator

Create product or lifestyle scene images from text prompts and optional reference images.

AI Clothes Changer for Tops & Bottoms

Dress a model image with upper and/or lower garment assets, supporting optional masks and original garment references.

AI Hand Repair

Improve hand appearance in generated model or lifestyle images.