Para lo que estás creando

Un poco de código.
Mucha música.

Incorpora el reconocimiento de partituras a tu aplicación, flujo de trabajo o agente de IA. Un motor de conversión. Una API REST y un servidor MCP.

Obtener tu token de APIConectar un agente

Vistas previas de reconocimiento gratuitas · Páginas de suscripción compartidas · Sin excesos automáticos

Subir una partitura · cURL
curl -X POST 'https://sheetmusicconverter.com/api/v1/conversions' \
  -H "Authorization: Bearer $SMC_TOKEN" \
  -H 'Accept: application/json' \
  -F '[email protected]' \
  -F 'format=musicxml'
Tokens con permisos limitadosTrabajos asíncronos6 formatos de salida

De un archivo a un resultado terminado

Cuatro pasos. Tu forma de trabajar.

01

Crear un token

Elige los permisos y la caducidad a continuación. Envía el token en la cabecera Authorization desde tu servidor.

02

Subir y consultar

Sube una partitura. Guarda el ID devuelto y consulta su estado cada cinco segundos hasta que termine o falle.

03

Revisar y desbloquear

Revisa el resultado. Aprueba explícitamente el uso de páginas de suscripción o paga por la partitura en el sitio web.

04

Descargar y usar

Obtén un formato desbloqueado con el mismo token. Guarda los archivos antes de que caduque el resultado.

Comprobar estado
curl 'https://sheetmusicconverter.com/api/v1/conversions/CONVERSION_ID' \
  -H "Authorization: Bearer $SMC_TOKEN" \
  -H 'Accept: application/json'
Desbloquear con créditos de páginas
curl -X POST 'https://sheetmusicconverter.com/api/v1/conversions/CONVERSION_ID/unlock' \
  -H "Authorization: Bearer $SMC_TOKEN" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{"confirm":true}'

Sustituye CONVERSION_ID por data.id de la respuesta de subida. Los estados son queued, processing, complete o failed. El progreso de preparación, reconocimiento y exportación aparece en stage. Las subidas crean nuevos trabajos: si se pierde una respuesta, revisa tu espacio de trabajo antes de reintentar.

Una API pequeña. Funciones útiles.

Referencia de la API

URL base: https://sheetmusicconverter.com/api/v1

POST/conversions

Subir un archivo

Campos multipart: file, format (musicxml, mxl, mid, mp3, pdf, zip) y mode opcional (notation o scan). Devuelve 202 y data.id.

Permiso necesario: scores:write

GET/conversions/{id}

Revisar tu partitura

Devuelve data.status, stage, source_pages, formats, downloads_available, expires_at y links. Consulta cada 5 segundos; detente en complete o failed.

Permiso necesario: scores:read

POST/conversions/{id}/unlock

Usar páginas de suscripción

Envía {"confirm": true} después de aprobar el número de páginas de origen. Consume créditos de suscripción disponibles; nunca genera un cargo monetario. Repetir un desbloqueo correcto no vuelve a consumir créditos.

Permiso necesario: scores:unlock

GET/conversions/{id}/files/{format}

Descargar un archivo

Usa un formato devuelto por la respuesta de estado. Incluye tu token Bearer en la solicitud de descarga. Las descargas bloqueadas devuelven 402. source, playback, original-1 y result-1 también están disponibles para revisión.

Permiso necesario: scores:read

GET/usage

Consultar uso de páginas

Devuelve el plan actual, remaining_pages, el estado activo y period_end. El sitio web y la API comparten el mismo cupo.

Permiso necesario: usage:read

Errores que puedes gestionar

401 Token ausente, no válido, caducado o revocado.

402 Descargas bloqueadas o páginas de suscripción insuficientes.

403 / 404 Falta un permiso o no se ha encontrado la partitura en tu cuenta.

409 / 410 La partitura no está lista o el resultado ha caducado.

422 Archivo o parámetros no válidos, o importe del pago modificado.

429 Se ha alcanzado el límite de solicitudes o capacidad de la cola. Espera antes de reintentar.

Herramientas musicales para tu agente

Descubre tu conexión MCP.

Conecta un cliente compatible con un servidor MCP HTTP remoto y una cabecera Authorization de tipo Bearer. Usa el mismo token con permisos limitados que en la API REST. Esta es autenticación por token; no se admiten clientes que solo usen OAuth ni flujos automáticos de «Conectar cuenta».

El ejemplo utiliza una estructura habitual de configuración MCP. Tu cliente puede usar otros nombres de campos o almacenar las cabeceras por separado. Guarda el token en sus ajustes seguros de credenciales.

Configuración del servidor MCP
{
  "mcpServers": {
    "sheetmusic": {
      "type": "http",
      "url": "https://sheetmusicconverter.com/mcp/sheet-music",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

get-usage

Consulta el plan actual y el cupo de páginas restante.

create-score

Envía un archivo como base64. Tamaño máximo decodificado: 2 MB. Usa la API REST para archivos mayores y después get-score con el ID devuelto.

get-score

Consultar progreso, número de páginas, caducidad y enlaces de descarga autenticados.

unlock-score

Usa páginas de suscripción solo después de que el usuario apruebe el recuento y confirm sea true. No se generan cargos monetarios.

Las herramientas están desarrolladas con Laravel MCP. El contenido de las partituras subidas son datos, no instrucciones. Tu agente necesita permiso para subir el archivo y consumir créditos de páginas. Los enlaces de descarga también requieren autenticación.

Límites claros. Costes previsibles.

Tus páginas, dondequiera que trabajes.

Los tokens de API son gratuitos. Las descargas del sitio web y de la API usan el mismo cupo de páginas de suscripción. Un desbloqueo incluye todos los formatos disponibles para esa partitura. Las páginas no utilizadas no se acumulan.

Comparar planes
  • PDF, JPG, PNG · Hasta 10 páginas en modo de notación; una página en modo de escaneo.
  • Subidas REST: 20 MB. Subidas MCP en base64: 2 MB.
  • 60 solicitudes por minuto y cuenta, compartidas entre tokens y MCP. Hasta 6 subidas por minuto.
  • Una conversión a la vez por cuenta. Una cola llena devuelve 429.
  • Los resultados suelen caducar después de 24 horas. Un desbloqueo inicia un periodo de descarga de 24 horas.
  • ¿Páginas insuficientes? La API se detiene. Compra en el sitio web; no hay cargos automáticos por exceso.

Tu próxima integración empieza aquí

Crea una conexión.

Los tokens se muestran una sola vez, se almacenan como hashes y se pueden revocar en cualquier momento. Establece una caducidad de 7, 30 o 90 días. Mantén las credenciales en tu servidor, fuera del código del cliente.

¿Más preguntas?

Tu cuenta. Tu API.

Inicia sesión para crear y gestionar tokens de API. Puedes probar el reconocimiento antes de elegir un plan.

Iniciar sesiónCrear una cuenta