Nexscope

API de búsqueda de diseños similares

Encuentra posibles registros de diseño similares a partir de la imagen de un producto con filtros de región, clasificación de Locarno y estado legal. Revisa las pruebas mediante la API REST o MCP.

CosteRecent 11 credits / call
Probar en línea
POST · https://api.nexscope.ai/ai/designSimilaritySearchMCP · nexscope_design_similarity_search

Qué hace esta API

Encuentra candidatos similares de diseño-registro de una imagen del producto con los filtros región, Locarno y legal-status. API o MCP.

Casos de uso de API de búsqueda de diseños similares

Buscar desde una imagen URL

Suministrar al usuario seleccionado imageUrl y omitir imageBase64. Aplicar sólo la región solicitada, Locarno y los filtros legal-status.

Buscar desde bytes de imagen local

Codifique la imagen local como pura base64 y suministro imageBase64 sin imageUrl. Mantenga el texto codificado dentro del límite de caracteres documentado 16-20971520.

Reconsideración de los candidatos a la inscripción

Retener los ID de candidato, orden de origen, cobertura y advertencias. image_url Si el usuario solicita detalles, reutilizar design_registration_id valores en la operación de registro-detalles por separado.

Preguntas frecuentes sobre API de búsqueda de diseños similares

¿Qué hace la búsqueda de similitudes de diseño? API ¿Volver?

Encuentra candidatos similares de diseño-registro de una imagen del producto con los filtros región, Locarno y legal-status. API o MCP. El producto documentado incluye: `candidates.applicant_addresses.address`, `candidates.applicant_addresses.name`, `candidates.application_date`, `candidates.application_number`, `candidates.design_registration_id`, `candidates.designer_names`, `candidates.estimated_expiration_date`, `candidates.expiration_date_basis`. Corresponde a los parámetros proporcionados `imageUrl`, `imageBase64`, `title`, `topK`, `regions`. Los campos opcionales pueden estar ausentes; un valor que falta no debe interpretarse como un cero medido. Los valores de ejemplo ilustran la forma de respuesta, en lugar de los resultados reales de la cuenta.

¿Cuántos créditos tiene la Búsqueda de Similitud de Diseño API ¿costo?

El coste documentado actualmente es Recent 11 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 Búsqueda de Similitud de Diseño? API desde mi aplicación o un MCP ¿Cliente?

Enviar a POST solicitud a /ai/designSimilaritySearch 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_design_similarity_search. 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/designSimilaritySearch
Método MCP
nexscope_design_similarity_search

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

Ejecutar una API

Envía un cuerpo de solicitud JSON usando los parámetros descritos abajo.

Solicitud de ejemplo

Sustituye YOUR_API_KEY y ejecuta este comando en tu terminal.

curl -X POST 'https://api.nexscope.ai/ai/designSimilaritySearch' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "imageUrl": "https://example.com/product.png",
  "title": "Bottle",
  "topK": 20
}'

Ejemplo de código

{
  "imageUrl": "https://example.com/product.png",
  "title": "Bottle",
  "topK": 20
}

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/ Investigación de registros de diseño

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_design_similarity_search",
    "arguments": {
      "imageUrl": "https://example.com/product.png",
      "title": "Bottle",
      "topK": 20
    }
  }
}

¿Qué puedes hacer con esta API?

Datos explicados y casos de uso prácticos

AI Guide

Question

What results can Design Similarity Search provide, and how might I use them?

AI answer

Submit one image URL or Base64 image to find visually similar design-registration candidates. The result is a review list with similarity scores and available registration details, not a legal determination.

Data categoryDocumented fieldsWhat the values mean
Candidate identitydesign_registration_id, primary_identifier, title_enIdentifies a returned registration candidate and its available English title.
Similarity and review signalsimilarity, risk_levelA reported similarity score and risk label to help prioritize review; neither establishes infringement.
Jurisdiction and classificationjurisdiction_iso2, registration_jurisdiction_code, protected_jurisdictions, locarno_classesReported jurisdictions and design classifications for the candidate.
Ownership and statusholder_names, designer_names, simple_legal_statusAvailable holder, designer, and simplified status information; values may be null.
Dates and imagesapplication_date, registration_date, image_url, imagesAvailable dates and image links. Use image_url or images only when links are actually returned.
Result sizetotal, candidatesThe reported candidate count and candidate list.
  • Upload a product image and review the highest-scoring design candidates alongside their registration identifiers.
    • Prompt example: “I am researching products for an online store. I can provide a product image URL or Base64 value. Could you review the highest-scoring design candidates alongside their registration identifiers? Show the relevant returned evidence and tell me what input you need from me.”
  • Limit a search to selected regions or Locarno classes to focus a design research queue.
    • Prompt example: “I am researching products for an online store. Could you limit a search to selected regions or Locarno classes to focus a design research queue? Show matching records and source links where the API provides them; ask me for any required identifier or filter.”
  • Open returned candidate image links to compare specific visual features with the submitted image.
    • Prompt example: “I am researching products for an online store. Could you open returned candidate image links to compare specific visual features with the submitted image? Show the returned values behind the comparison, and mark missing data.”
  • Use holder, status, and jurisdiction fields to decide which candidates need deeper registration review.
    • Prompt example: “I am researching products for an online store. Could you use holder, status, and jurisdiction fields to decide which candidates need deeper registration review? Show the relevant returned evidence and tell me what input you need from me.”

A match, score, or risk label does not establish infringement or freedom to operate. Coverage and missing values should be considered when interpreting the results.

API relacionadas