Pour ce que vous construisez

Un peu de code.
Beaucoup de musique.

Intégrez la reconnaissance de partitions à votre application, votre processus ou votre agent IA. Un moteur de conversion. Une API REST et un serveur MCP.

Obtenir votre jeton d’APIConnecter un agent

Aperçus de reconnaissance gratuits · Pages d’abonnement partagées · Aucun dépassement automatique

Importer une partition · 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'
Jetons à autorisations limitéesTraitements asynchrones6 formats de sortie

Du fichier au résultat final

Quatre étapes. Votre façon de travailler.

01

Créer un jeton

Choisissez les autorisations et la date d’expiration ci-dessous. Envoyez le jeton dans l’en-tête Authorization depuis votre serveur.

02

Importer et suivre le statut

Importez une partition. Conservez l’identifiant renvoyé, puis interrogez son statut toutes les cinq secondes jusqu’à la fin ou l’échec.

03

Vérifier et déverrouiller

Vérifiez le résultat. Approuvez explicitement l’utilisation des pages d’abonnement ou payez la partition sur le site.

04

Télécharger et utiliser

Récupérez un format déverrouillé avec le même jeton. Enregistrez vos fichiers avant l’expiration du résultat.

Vérifier le statut
curl 'https://sheetmusicconverter.com/api/v1/conversions/CONVERSION_ID' \
  -H "Authorization: Bearer $SMC_TOKEN" \
  -H 'Accept: application/json'
Déverrouiller avec des crédits de pages
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}'

Remplacez CONVERSION_ID par data.id dans la réponse à l’import. Les statuts sont queued, processing, complete ou failed. La progression de la préparation, de la reconnaissance et de l’export apparaît dans stage. Les imports créent de nouveaux traitements : si une réponse est perdue, vérifiez votre espace de travail avant de réessayer.

Une petite API. Des fonctions utiles.

Référence de l’API

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

POST/conversions

Importer un fichier

Champs multipart : file, format (musicxml, mxl, mid, mp3, pdf, zip) et mode facultatif (notation ou scan). Renvoie 202 et data.id.

Autorisation requise : scores:write

GET/conversions/{id}

Vérifier votre partition

Renvoie data.status, stage, source_pages, formats, downloads_available, expires_at et links. Interrogez toutes les 5 secondes ; arrêtez-vous à complete ou failed.

Autorisation requise : scores:read

POST/conversions/{id}/unlock

Utiliser des pages d’abonnement

Envoyez {"confirm": true} après avoir approuvé le nombre de pages sources. Consomme les crédits d’abonnement disponibles ; ne crée jamais de prélèvement monétaire. Répéter un déverrouillage réussi ne consomme pas de nouveaux crédits.

Autorisation requise : scores:unlock

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

Télécharger un fichier

Utilisez un format renvoyé par la réponse de statut. Incluez votre jeton Bearer dans la requête de téléchargement. Les téléchargements verrouillés renvoient 402. source, playback, original-1 et result-1 sont également disponibles pour vérification.

Autorisation requise : scores:read

GET/usage

Consulter l’utilisation des pages

Renvoie le forfait actuel, remaining_pages, le statut actif et period_end. Le site et l’API partagent le même quota.

Autorisation requise : usage:read

Des erreurs que vous pouvez gérer

401 Jeton manquant, invalide, expiré ou révoqué.

402 Téléchargements verrouillés ou nombre de pages d’abonnement insuffisant.

403 / 404 Autorisation manquante ou partition introuvable dans votre compte.

409 / 410 Partition non prête ou résultat expiré.

422 Fichier ou paramètres invalides, ou montant du paiement modifié.

429 Limite de requêtes ou capacité de la file atteinte. Patientez avant de réessayer.

Des outils musicaux pour votre agent

Découvrez votre connexion MCP.

Connectez un client prenant en charge un serveur MCP HTTP distant avec un en-tête Authorization de type Bearer. Utilisez le même jeton à autorisations limitées que pour l’API REST. Il s’agit d’une authentification par jeton ; les clients acceptant uniquement OAuth et les procédures automatiques « Connecter un compte » ne sont pas pris en charge.

L’exemple utilise une structure de configuration MCP courante. Votre client peut employer d’autres noms de champs ou stocker les en-têtes séparément. Conservez votre jeton dans ses paramètres sécurisés d’identifiants.

Configuration du serveur MCP
{
  "mcpServers": {
    "sheetmusic": {
      "type": "http",
      "url": "https://sheetmusicconverter.com/mcp/sheet-music",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

get-usage

Consultez le forfait actuel et le quota de pages restant.

create-score

Envoyez un fichier en base64. Taille maximale après décodage : 2 Mo. Utilisez l’API REST pour les fichiers plus volumineux, puis get-score avec l’identifiant renvoyé.

get-score

Consulter la progression, le nombre de pages, l’expiration et les liens de téléchargement authentifiés.

unlock-score

N’utilisez des pages d’abonnement qu’après approbation du nombre de pages par l’utilisateur et lorsque confirm vaut true. Aucun prélèvement monétaire n’est créé.

Les outils sont construits avec Laravel MCP. Le contenu des partitions importées constitue des données, pas des instructions. Votre agent doit être autorisé à importer le fichier et à utiliser des crédits de pages. Les liens de téléchargement nécessitent aussi une authentification.

Des limites claires. Des coûts prévisibles.

Vos pages, où que vous travailliez.

Les jetons d’API sont gratuits. Les téléchargements sur le site et par API utilisent le même quota de pages d’abonnement. Un déverrouillage inclut tous les formats disponibles pour cette partition. Les pages inutilisées ne sont pas reportées.

Comparer les forfaits
  • PDF, JPG, PNG · Jusqu’à 10 pages en mode notation ; une page en mode numérisation.
  • Imports REST : 20 Mo. Imports MCP en base64 : 2 Mo.
  • 60 requêtes par minute et par compte, partagées entre les jetons et MCP. Jusqu’à 6 imports par minute.
  • Une conversion à la fois par compte. Une file pleine renvoie 429.
  • Les résultats expirent normalement après 24 heures. Un déverrouillage ouvre une période de téléchargement de 24 heures.
  • Pages insuffisantes ? L’API s’arrête. Achetez sur le site ; aucun dépassement n’est facturé automatiquement.

Votre prochaine intégration commence ici

Créez une connexion.

Les jetons ne sont affichés qu’une fois, sont stockés sous forme d’empreintes et peuvent être révoqués à tout moment. Fixez une expiration à 7, 30 ou 90 jours. Conservez les identifiants sur votre serveur, en dehors du code côté client.

D’autres questions ?

Votre compte. Votre API.

Connectez-vous pour créer et gérer des jetons d’API. Vous pouvez tester la reconnaissance avant de choisir un forfait.

Se connecterCréer un compte