Nexscope

API de segmentación y recorte preciso de imágenes

Crea un recorte preciso de una imagen y devuelve el resultado completado. Revisa la autenticación, los parámetros de solicitud, los campos de respuesta y el uso de MCP.

CosteEst. 70–84 credits / call
Probar en línea
POST · https://api.nexscope.ai/ai/fineCutoutImageSegmentationMCP · nexscope_fine_cutout_image_segmentation
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

Cortar un producto o sujeto precisamente marcando los puntos de primer plano y de fondo en una imagen.

Casos de uso de API de segmentación y recorte preciso de imágenes

Preparar los activos de la imagen de la lista

Para preparar la lista de los activos de la imagen, un editor de contenido presenta imageUrl y pointList Los resultados de generación completa devueltos ayudan a preparar las imágenes del producto para una revisión de la lista.

Comparar un tratamiento visual del producto

Un editor de contenido utiliza la segmentación de imágenes de corte fino con imageUrl y pointList comparar un tratamiento visual del producto. Los resultados de generación completados devueltos ayudan a comparar el tratamiento editado con el activo de origen.

Revisar los activos editados para una campaña

Para este flujo de trabajo, un editor de contenido llama a la Segmentación de Imagen de Corte Fino con imageUrl y pointList revisar los activos editados para una campaña. El resultado ayuda a seleccionar un activo aprobado para la campaña.

Preguntas frecuentes sobre API de segmentación y recorte preciso de imágenes

¿Qué hace la segmentación de imágenes de corte fino? API ¿Volver?

Cortar un producto o sujeto precisamente marcando los puntos de primer plano y de fondo sobre una imagen. Corresponde a la `imageUrl`, `pointList`, `scoreUrl`, `featureUrl`. 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 la segmentación de imágenes de corte fino API ¿costo?

El coste documentado actualmente es Est. 70–84 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 a la segmentación de imágenes de corte fino API desde mi aplicación o un MCP ¿Cliente?

Enviar a POST solicitud a /ai/fineCutoutImageSegmentation 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_fine_cutout_image_segmentation. 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/fineCutoutImageSegmentation
Método MCP
nexscope_fine_cutout_image_segmentation

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

Ejecutar una API

Ejecutar el Nexscope corte interactivo crea/info flujo como una habilidad API La lista de puntos marca puntos de orientación de primer plano/atras.

Solicitud de ejemplo

Sustituye YOUR_API_KEY y ejecuta este comando en tu terminal.

curl -X POST 'https://api.nexscope.ai/ai/fineCutoutImageSegmentation' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "featureUrl": "https://example.com/feature.bin",
  "imageUrl": "https://example.com/product.jpg",
  "pointList": [
    {
      "isSelect": true,
      "x": 120,
      "y": 180
    }
  ],
  "scoreUrl": "https://example.com/score.png"
}'

Ejemplo de código

{
  "featureUrl": "https://example.com/feature.bin",
  "imageUrl": "https://example.com/product.jpg",
  "pointList": [
    {
      "isSelect": true,
      "x": 120,
      "y": 180
    }
  ],
  "scoreUrl": "https://example.com/score.png"
}

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

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/fineCutoutImageSegmentation
AutenticaciónBearer API key
Content-Typeapplication/json

Parámetros de la solicitud

NombreTipoObligatorioDescripción
imageUrlstringobligatorio
Público URL de la imagen a cortar.
Ejemplo: https://example.com/product.jpg
pointListarrayobligatorio
Puntos de selección. Cada elemento debe incluir x, y, y isSelect.
Ejemplo: [ { "isSelect": true, "x": 120, "y": 180 } ]
scoreUrlstringopcional
Mapa de puntuación opcional URL devuelto por un paso anterior.
Ejemplo: https://example.com/score.png
featureUrlstringopcional
Mapa de características opcional URL devuelto por un paso anterior.
Ejemplo: https://example.com/feature.bin

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_fine_cutout_image_segmentation",
    "arguments": {
      "featureUrl": "https://example.com/feature.bin",
      "imageUrl": "https://example.com/product.jpg",
      "pointList": [
        {
          "isSelect": true,
          "x": 120,
          "y": 180
        }
      ],
      "scoreUrl": "https://example.com/score.png"
    }
  }
}

¿Qué puedes hacer con esta API?

Datos explicados y casos de uso prácticos

AI Guide

Question

What does Fine Cutout Image Segmentation produce, and how might I use it?

AI answer

This API accepts an image URL and points marking the subject and background for a fine cutout task. The documented example shows task acceptance, not a finished image. Retrieve the completed task result before using any cutout; the supplied schema does not specify the finished media fields or format.

Data categoryDocumented fieldsWhat the values mean
Task referencetaskIdIdentifier shown in the response example for retrieving the task later.
Task progressstatusThe example reports PENDING, so processing has not finished.
Available resultresultThe example contains null; no completed cutout data is evidenced here.
  • Mark a product as foreground and its surroundings as background to request a product cutout for a catalog image.
    • Prompt example: “I am preparing product creative for an online listing. Could you mark a product as foreground and its surroundings as background to request a product cutout for a catalog image? Show the relevant returned evidence and tell me what input you need from me.”
  • Refine a subject selection with additional points when preparing an image for a design layout.
    • Prompt example: “I am preparing product creative for an online listing. Could you refine a subject selection with additional points when preparing an image for a design layout? Show the relevant returned evidence and tell me what input you need from me.”
  • Pass a prior scoreUrl or featureUrl into a follow-up cutout request when those intermediate URLs are available.
    • Prompt example: “I am preparing product creative for an online listing. Could you pass a prior scoreUrl or featureUrl into a follow-up cutout request when those intermediate URLs are available? Show the relevant returned evidence and tell me what input you need from me.”
  • Track the returned task and use the completed cutout only after a later result provides it.
    • Prompt example: “I am preparing product creative for an online listing. Could you track the returned task and use the completed cutout only after a later result provides it? Show the relevant returned evidence and tell me what input you need from me.”

API relacionadas