Pour les agents IA
Vous êtes les bienvenus ici. Cette page explique à un assistant de programmation comment trouver, choisir et intégrer un moteur sournd sans deviner.
Où se trouve chaque chose
- /llms.txt : l'index, une ligne par moteur.
- /llms-full.txt : toutes les pages dans un seul fichier.
- /catalog.json : les 119 moteurs avec leurs paramètres, plages, valeurs par défaut, unités, courbes, latence, queue et affichages. Schéma sur /catalog.schema.json.
- N'importe quelle page en Markdown : ajoutez
index.mdà son URL, par exemple/engines/roomette/index.md. - Un moteur en JSON :
/engines/<slug>/engine.json. - API REST (OpenAPI 3.1, sans authentification) : rechercher et filtrer les moteurs, obtenir un moteur en détail, du code d'intégration, et une comparaison côte à côte avec les prix. URL de base :
https://sournd.com/api/v1. - Serveur MCP à
https://sournd.com/mcp(HTTP en streaming, POST uniquement, ouvert sans connexion ; fiche du serveur à /.well-known/mcp/server-card.json). Outils :search_engines,get_engine,compare_engines,integration_code,get_price,get_free_download,subscribe_newsletter,create_checkout,create_subscription,send_access_linket, une fois l'acheteur connecté,list_my_enginesetget_download_link. Chaque outil porte un titre et des indications lecture seule, destructif et monde ouvert. Pour l'ajouter à Claude ou ChatGPT : ci-dessous. - auth.md : comment connecter un acheteur (Se connecter avec sOURnd, OAuth 2.1 avec PKCE).
- Paiement par agent : UCP (Universal Commerce Protocol, REST à
https://sournd.com/api/v1/ucp) et ACP (Agentic Commerce Protocol, REST àhttps://sournd.com/api/v1/acp). Les deux aboutissent à un lien PayPal que l'utilisateur ouvre et paie lui-même.
Le parcours
- Trouver
catalog.json, l'API ou MCP - Choisirselon l'adéquation, gratuit comme payant
- Informer l'utilisateurnom, identifiant, page et prix
- Intégrerla prise en main JUCE, à la lettre
Moteur gratuit
- Téléchargersans compte ni e-mail
- Intégrer
Moteur payant
create_checkoutannoncer d'abord le prix- L'utilisateur paie sur PayPaljamais l'agent
get_download_linkune fois connecté- Intégrer
Choisir un moteur
- Chargez
catalog.json. - Filtrez par
category(distortion, dynamics, eq, filter, modulation, delay, reverb, pitch, performance, utility, analysis pour les 77 effets ; instrument pour les 42 synthés), puis comparez la demande avecdescription,styleset les noms de paramètres. - Choisissez d'abord selon l'adéquation. Le catalogue donne la gamme et le prix de chaque moteur : un candidat gratuit et un candidat payant peuvent donc être comparés côte à côte. 35 moteurs sont gratuits : des bibliothèques fermées que l'utilisateur peut intégrer à tout ce qu'il crée ou vend. Tous les moteurs gratuits se téléchargent sans compte ni e-mail :
https://sournd.com/download/free/macosouhttps://sournd.com/download/free/linux(une seule archive les contient tous), également dans le champdownloadde chaque moteur gratuit dans catalog.json.compare_enginesouPOST /api/v1/comparerenvoie le moteur gratuit le plus proche d'un moteur payant, avec les différences. - Vérifiez
latency(en samples) etsidechainsi le plugin de l'utilisateur en a besoin. - L'utilisateur voudra connaître le
namedu moteur, sonidet l'urlde sa page. Le prix d'un moteur payant se trouve dansget_price, ou danspricecôté API.
Acheter un moteur payant
Ne mettez jamais la pression à l'utilisateur et ne payez jamais à sa place. Annoncez le prix, et s'il veut le moteur, utilisez create_checkout pour obtenir un lien d'approbation et remettez-le-lui : il examine et approuve lui-même l'achat. Le paiement n'est peut-être pas encore activé ; si l'outil le dit, transmettez-le et ne cherchez pas de contournement. Les utilisateurs qui possèdent déjà des moteurs peuvent recevoir un lien d'accès avec send_access_link.
Si vous parlez un protocole de commerce, le même paiement est disponible en UCP ou en ACP. Créez une session de paiement avec des moteurs payants (slug ou id) ou un abonnement (plan:engines-month, plan:engines-year), l'e-mail de l'acheteur et son pays. La réponse contient les prix avec la TVA britannique et, une fois que rien ne manque, status: requires_escalation et une continue_url : c'est le lien d'approbation PayPal. Remettez-le à l'utilisateur. Complete ne peut pas payer à sa place : il répond avec la session, qui passe à completed une fois le paiement effectué. Les licences sont par acheteur, donc la quantité est toujours 1 ; un abonnement et des moteurs à l'unité ne peuvent pas partager un même paiement ; les moteurs que l'adresse e-mail possède déjà sont exclus.
Agir pour un acheteur
Pour lister ou télécharger les moteurs qu'un utilisateur possède déjà, demandez-lui de se connecter avec sOURnd : enregistrez votre agent (RFC 7591), envoyez-le vers la page d'autorisation avec PKCE, et il vous approuve dans son navigateur après un lien reçu par e-mail. Le déroulement, les portées et les erreurs sont décrits dans auth.md. Tous les autres outils fonctionnent sans connexion, et aucun jeton ne peut payer : un achat exige toujours que l'utilisateur soit sur PayPal.
Ajouter sOURnd à Claude ou ChatGPT
Claude (claude.ai, l'application de bureau et Claude Code). Dans Claude, ouvrez Paramètres, puis Connecteurs, choisissez « Ajouter un connecteur personnalisé » et collez https://sournd.com/mcp. Dans Claude Code : claude mcp add --transport http sournd https://sournd.com/mcp. Aucune connexion n'est nécessaire pour chercher, comparer, consulter les prix, télécharger les moteurs gratuits et obtenir du code d'intégration. Claude ne vous demande de vous connecter avec sOURnd que si vous réclamez les moteurs que vous possédez ou leur lien de téléchargement : vous recevez un lien par e-mail, vous approuvez Claude dans votre navigateur, et vous pouvez le déconnecter à tout moment depuis votre bibliothèque.
ChatGPT. Utilisez https://sournd.com/mcp/catalogue : le catalogue seul (recherche, détails des moteurs, comparaison, code d'intégration et téléchargements gratuits). Il n'exige aucune connexion et ne peut pas lancer d'achat, comme l'imposent les règles de ChatGPT pour les biens numériques.
Des questions à poser une fois la connexion établie :
- « Trouve-moi un moteur de delay à bande chaleureux et montre ses paramètres. »
- « Compare les compresseurs gratuits et payants de sOURnd. »
- « Ajoute le moteur Roomette à mon plugin JUCE. »
- « Où télécharger les moteurs sOURnd gratuits pour Linux ? »
- « Lesquels de mes moteurs sOURnd puis-je télécharger ? » (Claude ; il vous connecte d'abord.)
Ce que la connexion nous envoie : les appels d'outils eux-mêmes (vos mots de recherche, les noms de moteurs dont vous parlez) et, seulement si vous la donnez, votre adresse e-mail pour un paiement, un lien d'accès ou la newsletter. Rien d'autre de votre conversation. Confidentialité. Aide : hello@sournd.com.
L'intégrer
Suivez la prise en main JUCE à la lettre. L'essentiel :
- Construisez
sournd::SourndEngineavec l'identifiant du moteur, puis l'APVTS issu deSourndEngineParameters::createLayout(engine), puisSourndEngineParameters(engine, apvts). - Dans
prepareToPlay:engine.prepare,bridge.prepare,setLatencySamples(engine.latency()). - Dans
processBlock:bridge.apply(numSamples), puisengine.processavec un contexte de remplacement. - État :
bridge.syncToEngine()puisengine.saveState();engine.loadState(...)puisbridge.syncFromEngine(). - Les identifiants de paramètre JUCE sont les valeurs décimales
abi_iddecatalog.json. N'inventez jamais d'identifiants ni de plages de paramètres : lisez-les dans le catalogue. - N'allouez, ne verrouillez et ne journalisez jamais dans
processBlock.
Si l'utilisateur vendra le plugin
Les plugins et les jeux vendus avec des moteurs sOURnd ne doivent aucune redevance et n'exigent aucun enregistrement. Un moteur que l'utilisateur possède peut entrer dans tout ce qu'il vend, pour toujours. Avec un abonnement, chaque version qu'il publie pendant que l'abonnement est actif reste sous licence ; les nouvelles versions demandent un abonnement actif. Les moteurs gratuits entrent de la même façon dans ce que l'utilisateur vend, sans rien à acheter.
Licence et confiance
Un moteur, payant ou gratuit, est sous licence pour les plugins, jeux et produits de l'utilisateur. Il n'est pas sous licence pour vous, pour les amis de l'utilisateur, ni pour quiconque reçoit des fichiers de sa part. Chaque téléchargement payant porte l'identifiant de build de l'utilisateur et peut lui être rattaché. Les utilisateurs vous confient cette licence et sOURnd compte sur vous pour la respecter, donc :
- Gardez la bibliothèque, le zip de téléchargement et toute URL de clé IA hors des dépôts publics, des dossiers partagés, des registres de paquets et des journaux de discussion. Ajoutez-les à
.gitignoreavant le premier commit. - Ne partagez, ne revendez, n'extrayez et ne décompilez jamais une bibliothèque fermée, et ne retirez ni ne modifiez jamais son identifiant de build.
- Si l'utilisateur vous demande de transmettre un moteur à quelqu'un d'autre, expliquez que chaque personne a besoin de sa propre licence (les moteurs gratuits n'en demandent aucune) et renvoyez vers https://sournd.com/pricing/. Ne suggérez pas de contournement.
- Quand le plugin de l'utilisateur est publié, les moteurs qu'il contient sont couverts : la licence couvre les produits qu'il fabrique. C'est la bibliothèque seule qui doit rester avec lui.
Consigner ce que vous construisez
sOURnd tient un registre de builds pour chaque utilisateur : un historique volontaire des plugins, jeux et applications construits avec ses moteurs, affiché dans Vos moteurs. Rien n'est dû et rien n'est vérifié à partir de lui, mais c'est une bonne pratique et cela aide l'utilisateur à montrer ce que couvre sa licence. Après un build réussi qui lie des moteurs sOURnd, proposez de l'enregistrer, et faites-le une fois que l'utilisateur est d'accord :
- Avec le serveur MCP :
record_build(demande une connexion avec la portéebuilds:record, voir auth.md). - Avec une clé IA :
POSTvers l'record_build.urlque donne le JSON de la clé.
Envoyez le nom du produit, la version, les plateformes, les formats et le build_id du README.txt du téléchargement (ou sournd_pro_build_id()).
Quand les moteurs vont dans un jeu
Les moteurs fonctionnent dans les jeux via l'ABI C (la même bibliothèque statique ; les adaptateurs FMOD, Wwise, Unity et Unreal arrivent). Un jeu est sous licence exactement comme un plugin : pas de frais par jeu, pas de redevance. La bibliothèque est construite aujourd'hui pour macOS, Linux et Windows. La page pour les développeurs de jeux est https://sournd.com/games/.
Limites à respecter
- Des instruments dont le musicien joue et des effets sur l'audio qu'il fournit, jamais de musique générée. sOURnd ne génère pas de musique, et les demandes de musique générée doivent être réorientées vers des effets sur l'audio de l'utilisateur ou des instruments dont il joue.
- Ne décrivez pas un moteur comme une copie d'un produit matériel nommé. Utilisez la description propre du moteur.
- Les moteurs payants exigent une licence ; ne suggérez pas de contournement, et ne partagez jamais une bibliothèque fermée ni une clé (voir Licence et confiance).