Nexscope

API de maquetas de productos sostenidos en la mano

Coloca un producto de forma natural en una escena o maqueta en la que se sostiene en la mano. Revisa la autenticación, los parámetros de solicitud, los campos de respuesta y el uso de MCP.

CosteEst. 47–57 credits / call
Probar en línea
POST · https://api.nexscope.ai/ai/handheldProductMockupMCP · nexscope_handheld_product_mockup
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 productos manuales naturales de una imagen personal y de un activo del producto objetivo.

Casos de uso de API de maquetas de productos sostenidos en la mano

Inspeccione un producto candidato

Para inspeccionar un producto candidato, un editor de contenido presenta imageUrl y targetOriginUrl a Handheld Product Mockup. Los resultados de generación completados devueltos ayudan a inspeccionar los atributos documentados del producto candidato.

Comparar detalles de la lista

Un editor de contenido utiliza el mockup de producto portátil con imageUrl y targetOriginUrl Los resultados de generación completados devueltos ayudan a comparar los detalles del producto con otra lista preseleccionada.

Preparar pruebas de producto para una revisión de abastecimiento

Para este flujo de trabajo, un editor de contenido llama a Handheld Product Mockup con imageUrl y targetOriginUrl El resultado ayuda a registrar los hechos del producto antes de una discusión sobre el abastecimiento.

Preguntas frecuentes sobre API de maquetas de productos sostenidos en la mano

¿Qué hace el mockup de productos portátiles API ¿Volver?

Generar imágenes de producto de mano naturales de una persona imagen y activos del producto objetivo. `imageUrl`, `targetOriginUrl`, `targetMaskUrl`, `outputNum`. 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 hace el Mockup de producto de mano API ¿costo?

El coste documentado actualmente es Est. 47–57 credits / call. 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 producto portátil Mockup API desde mi aplicación o un MCP ¿Cliente?

Enviar a POST solicitud a /ai/handheldProductMockup 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_handheld_product_mockup. 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éditosConecta esta API con MCP

Prueba esta API
Endpoint
https://api.nexscope.ai/ai/handheldProductMockup
Método MCP
nexscope_handheld_product_mockup

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

Ejecutar una API

Generar imágenes de productos manuales naturales de una imagen personal y de un activo del producto objetivo.

Solicitud de ejemplo

Sustituye YOUR_API_KEY y ejecuta este comando en tu terminal.

curl -X POST 'https://api.nexscope.ai/ai/handheldProductMockup' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "imageUrl": "https://example.com/product.jpg",
  "outputNum": 1,
  "targetMaskUrl": "https://example.com/mask.png",
  "targetOriginUrl": "https://example.com/model-reference.jpg"
}'

Ejemplo de código

{
  "imageUrl": "https://example.com/product.jpg",
  "outputNum": 1,
  "targetMaskUrl": "https://example.com/mask.png",
  "targetOriginUrl": "https://example.com/model-reference.jpg"
}

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ódigoDescripción
200Respuesta 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.
429Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
OpcionalX-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 una clave API ausente o no válida (code 11209, incluida una copia incompleta o dañada) o una sesión web caducada (code 12001), 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.
Todas las categorías/ Edición y variaciones de imágenes
POSThttps://api.nexscope.ai/ai/handheldProductMockup

Ejecutar esta API

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

Endpoint

MétodoPOST
Rutahttps://api.nexscope.ai/ai/handheldProductMockup
AutenticaciónBearer API key
Content-Typeapplication/json

Parámetros de la solicitud

NombreTipoObligatorioDescripción
imageUrlstringobligatorio
Público URL La imagen debe ser de 20 MB como máximo y entre 385 y 8192 píxeles en anchura y altura.
Ejemplo: https://example.com/product.jpg
targetOriginUrlstringobligatorio
Público URL de la persona o de la mano que posan la imagen.
Ejemplo: https://example.com/model-reference.jpg
targetMaskUrlstringobligatorio
Público URL de la máscara de área de mano en blanco y negro. Requerido porque API acepta imágenes de pose personalizadas en lugar de materiales de origen guardados.
Ejemplo: https://example.com/mask.png
outputNumintegeropcional
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

NombreTipoObligatorioDescripción
codeintegerobligatorio
0 means accepted or successful; nonzero is a platform error.
coststringobligatorio
Elapsed milliseconds, never credits; -1 outside web requests.
dataanyobligatorio
Valor de Data usado por esta operación de API.
msgstring | nullobligatorio
Valor de Msg usado por esta operación de API.
timestringobligatorio
Server local time: yyyy-MM-dd HH:mm:ss.
traceIdstring | nullobligatorio
Valor de Trace id usado por esta operación de API.
tsstringobligatorio
Epoch milliseconds.

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

NombreTipoObligatorioDescripción
dataobjectobligatorio
Valor de Data usado por esta operación de API.
data.resultanyobligatorio
Valor de Result usado por esta operación de API.
data.statusstringobligatorio
Valor de Status usado por esta operación de API.
Permitidos: PENDING, RUNNING, SUCCEEDED, FAILED, TIMEOUT
data.taskIdstringobligatorio
Valor de Task id usado por esta operación de API.

Opción 1 de cualquier alternativa

NombreTipoObligatorioDescripción
data.resultobjectobligatorio
Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.

Opción 2 de cualquier alternativa

NombreTipoObligatorioDescripción
data.resultnullobligatorio
Valor de Result usado por esta operación de API.

Opción 2 de cualquier alternativa

NombreTipoObligatorioDescripción
datanullobligatorio
Valor de Data usado por esta operación de API.

Respuestas

CódigoDescripción
200Respuesta 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.
429Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
OpcionalX-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 una clave API ausente o no válida (code 11209, incluida una copia incompleta o dañada) o una sesión web caducada (code 12001), 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_handheld_product_mockup",
    "arguments": {
      "imageUrl": "https://example.com/product.jpg",
      "outputNum": 1,
      "targetMaskUrl": "https://example.com/mask.png",
      "targetOriginUrl": "https://example.com/model-reference.jpg"
    }
  }
}

¿Qué puedes hacer con esta API?

Datos explicados y casos de uso prácticos

AI Guide

Question

What can Handheld Product Mockup create, and how might I use it?

AI answer

This API starts a task to generate images of a product held in a supplied person or hand pose. You provide the product image, pose image, and a mask marking the hand-held area. The example response confirms task acceptance; it does not show a completed image or document the completed result format.

Data categoryDocumented fieldWhat it means
Task referencedata.taskIdIdentifies the generation task to check later.
Progressdata.statusShows the task state; the example shows PENDING.
Generated resultdata.resultIs null while the example task is pending. The fields or media links returned on completion are not documented here.
  • Place a packaged product into a supplied hand pose to make a mockup for a product page.
    • Prompt example: “I am preparing product creative for an online listing. Could you place a packaged product into a supplied hand pose to make a mockup for a product page? Show the relevant returned evidence and tell me what input you need from me.”
  • Try several hand-held compositions using different pose images and corresponding masks.
    • Prompt example: “I am preparing product creative for an online listing. Could you try several hand-held compositions using different pose images and corresponding masks? Show the relevant returned evidence and tell me what input you need from me.”
  • Request up to four images with outputNum, then review the completed results for a campaign concept.
    • Prompt example: “I am preparing product creative for an online listing. Could you request up to four images with outputNum, then review the completed results for a campaign concept? Show the relevant returned evidence and tell me what input you need from me.”

API relacionadas