Voor AI-agents
Je bent hier welkom. Deze pagina vertelt een codeerassistent hoe je een sournd-engine vindt, kiest en integreert zonder te gokken.
Waar alles staat
- /llms.txt: de index, één regel per engine.
- /llms-full.txt: alle pagina's in één bestand.
- /catalog.json: alle 119 engines met parameters, bereiken, standaardwaarden, eenheden, curves, latency, tail en uitlezingen. Schema op /catalog.schema.json.
- Elke pagina als Markdown: voeg
index.mdtoe aan de URL, bijvoorbeeld/engines/roomette/index.md. - Eén engine als JSON:
/engines/<slug>/engine.json. - REST API (OpenAPI 3.1, zonder authenticatie): zoek en filter engines, haal één engine volledig op, integratiecode en een vergelijking naast elkaar met prijzen. Basis-URL
https://sournd.com/api/v1. - MCP-server op
https://sournd.com/mcp(streamable HTTP, alleen POST, open zonder inloggen; servercard op /.well-known/mcp/server-card.json). Tools:search_engines,get_engine,compare_engines,integration_code,get_price,get_free_download,subscribe_newsletter,create_checkout,create_subscription,send_access_linken, zodra de koper inlogt,list_my_enginesenget_download_link. Elke tool heeft een titel en hints voor alleen-lezen, destructief en open-world. Zo voeg je hem toe aan Claude of ChatGPT: hieronder. - auth.md: hoe een koper inlogt (Sign in with sOURnd, OAuth 2.1 met PKCE).
- Agent-checkout: UCP (Universal Commerce Protocol, REST op
https://sournd.com/api/v1/ucp) en ACP (Agentic Commerce Protocol, REST ophttps://sournd.com/api/v1/acp). Beide eindigen in een PayPal-link die de gebruiker zelf opent en betaalt.
Het pad
- Zoeken
catalog.json, de API of MCP - Kiezenop geschiktheid, gratis naast betaald
- Vertel de gebruikernaam, id, pagina en prijs
- Integrerende JUCE quick start, precies
Gratis engine
- Downloadengeen account of e-mailadres
- Integreren
Betaalde engine
create_checkoutnoem eerst de prijs- De gebruiker betaalt bij PayPalnooit de agent
get_download_linkzodra ze inloggen- Integreren
Een engine kiezen
- Laad
catalog.json. - Filter op
category(distortion, dynamics, eq, filter, modulation, delay, reverb, pitch, performance, utility, analysis voor de 77 effecten; instrument voor de 42 synths), en vergelijk het verzoek dan metdescription,stylesen parameternamen. - Kies eerst op geschiktheid. De catalogus geeft van elke engine de categorie en de prijs, zodat een gratis en een betaalde kandidaat naast elkaar kunnen. 35 engines zijn gratis: closed libraries die de gebruiker kan inbouwen in alles wat hij of zij maakt of verkoopt. Elke gratis engine downloadt zonder account of e-mailadres:
https://sournd.com/download/free/macosofhttps://sournd.com/download/free/linux(één archief met alle engines), ook te vinden in het velddownloadvan elke gratis engine in catalog.json.compare_enginesofPOST /api/v1/comparegeeft de dichtstbijzijnde gratis engine bij een betaalde, met de verschillen. - Controleer
latency(in samples) ensidechainals dat voor de plugin van de gebruiker telt. - De gebruiker wil de
namevan de engine, deiden de pagina-url. De prijs van een betaalde engine staat inget_price, of inpricein de API.
Een betaalde engine kopen
Zet de gebruiker nooit onder druk en betaal nooit namens hem of haar. Noem de prijs, en als de gebruiker de engine wil, gebruik dan create_checkout om een goedkeuringslink te maken en geef die door: de gebruiker bekijkt en keurt de aankoop zelf goed. Checkout staat misschien nog niet aan; als de tool dat meldt, geef dat door en zoek geen omwegen. Gebruikers die al engines bezitten kun je een toegangslink sturen met send_access_link.
Als je een commerceprotocol spreekt, is dezelfde checkout er als UCP of ACP. Maak een checkoutsessie met betaalde engines (slug of id) of één abonnement (plan:engines-month, plan:engines-year), het e-mailadres van de koper en hun land. Het antwoord bevat de prijzen inclusief Britse btw en, zodra er niets meer ontbreekt, status: requires_escalation en een continue_url: dat is de PayPal-goedkeuringslink. Geef die aan de gebruiker. Complete kan niet voor hen betalen: het antwoordt met de sessie, die completed wordt zodra ze betaald hebben. Licenties zijn per koper, dus de hoeveelheid is altijd 1; een abonnement en losse engines kunnen niet in dezelfde checkout; engines die het e-mailadres al bezit worden weggelaten.
Namens een koper handelen
Om de engines op te sommen of te downloaden die een gebruiker al bezit, vraag je diegene in te loggen met sOURnd: registreer je agent (RFC 7591), stuur de gebruiker met PKCE naar de autorisatiepagina, en diegene keurt je goed in de browser na een e-maillink. De flow, scopes en fouten staan in auth.md. Elke andere tool werkt zonder inloggen, en geen enkel token kan betalen: kopen vraagt altijd dat de gebruiker zelf bij PayPal is.
sOURnd toevoegen aan Claude of ChatGPT
Claude (claude.ai, de desktop-app en Claude Code). Open in Claude Instellingen, dan Connectors, kies “Add custom connector” en plak https://sournd.com/mcp. In Claude Code: claude mcp add --transport http sournd https://sournd.com/mcp. Er is niets om in te loggen voor zoeken, vergelijken, prijzen, gratis downloads en integratiecode. Claude vraagt je alleen in te loggen met sOURnd als je vraagt naar de engines die je bezit of hun downloadlink: je krijgt een e-maillink, keurt Claude goed in je browser en kunt de koppeling op elk moment loskoppelen vanuit je bibliotheek.
ChatGPT. Gebruik https://sournd.com/mcp/catalogue: alleen de catalogus (zoeken, enginedetails, vergelijken, integratiecode en de gratis downloads). Er is geen login en je kunt er geen aankoop mee starten, zoals de regels van ChatGPT voor digitale goederen vereisen.
Dit kun je vragen zodra de koppeling werkt:
- “Zoek een warme tape-delay-engine voor me en toon de parameters.”
- “Vergelijk de gratis en betaalde compressors in sOURnd.”
- “Voeg de engine Roomette toe aan mijn JUCE-plugin.”
- “Waar download ik de gratis sOURnd-engines voor Linux?”
- “Welke van mijn sOURnd-engines kan ik downloaden?” (Claude; laat je eerst inloggen.)
Wat de koppeling naar ons stuurt: de toolaanroepen zelf (je zoekwoorden, de enginenamen waar je naar vraagt) en, alleen als je het opgeeft, je e-mailadres voor een checkout, een toegangslink of de nieuwsbrief. Verder niets uit je gesprek. Privacy. Hulp: hello@sournd.com.
Integreren
Volg de JUCE quick start precies. De hoofdzaken:
- Maak
sournd::SourndEngineaan met de engine-id, dan de APVTS uitSourndEngineParameters::createLayout(engine), danSourndEngineParameters(engine, apvts). - In
prepareToPlay:engine.prepare,bridge.prepare,setLatencySamples(engine.latency()). - In
processBlock:bridge.apply(numSamples), danengine.processmet een replacing context. - State:
bridge.syncToEngine()en danengine.saveState();engine.loadState(...)en danbridge.syncFromEngine(). - JUCE-parameter-id's zijn de decimale
abi_id-waarden incatalog.json. Verzin nooit parameter-id's of bereiken: lees ze uit de catalogus. - Alloceer, lock of log nooit in
processBlock.
Als de gebruiker de plugin gaat verkopen
Plugins en games die met sOURnd-engines worden verkocht, kennen geen royalty en hoeven niet te worden geregistreerd. Een engine die de gebruiker bezit mag voorgoed in alles wat diegene verkoopt. Met een abonnement blijft elke versie die de gebruiker uitbrengt terwijl het actief is gelicentieerd; nieuwe releases vragen een actief abonnement. Gratis engines mag de gebruiker op dezelfde manier in alles wat hij of zij verkoopt gebruiken, zonder iets te hoeven kopen.
Licentie en vertrouwen
Een engine, betaald of gratis, is gelicentieerd aan de gebruiker voor eigen plugins, games en producten. Hij is niet gelicentieerd aan jou, aan vrienden van de gebruiker, of aan wie dan ook naar wie de gebruiker bestanden stuurt. Elke betaalde download draagt de build-id van de gebruiker en is naar hem of haar te herleiden. Gebruikers vertrouwen je die licentie toe, en sOURnd vertrouwt erop dat je hem bewaakt, dus:
- Houd de bibliotheek, de download-zip en elke AI-sleutel-URL uit openbare repositories, gedeelde mappen, pakketregisters en chatlogs. Zet ze in
.gitignorevóór de eerste commit. - Deel, verkoop door, extraheer of decompileer nooit een closed library, en verwijder of wijzig nooit de build-id.
- Als de gebruiker je vraagt een engine aan iemand anders door te geven, leg dan uit dat iedereen een eigen licentie nodig heeft (gratis engines hebben er geen nodig) en verwijs naar https://sournd.com/pricing/. Stel geen omwegen voor.
- Als de plugin van de gebruiker uitkomt, zijn de engines erin geen probleem: de licentie dekt de producten die de gebruiker maakt. Alleen de bibliotheek zelf moet bij de gebruiker blijven.
Leg vast wat je bouwt
sOURnd houdt voor elke gebruiker een buildregister bij: een vrijwillige geschiedenis van de plugins, games en apps die met hun engines zijn gebouwd, te zien onder Jouw engines. Er is niets verschuldigd en er wordt niets tegen gecontroleerd, maar het is goede gewoonte en het helpt de gebruiker aan te tonen wat de licentie dekt. Bied na een geslaagde build die sOURnd-engines linkt aan om die vast te leggen, en leg hem vast zodra de gebruiker akkoord is:
- Met de MCP-server:
record_build(vereist inloggen met de scopebuilds:record, zie auth.md). - Met een AI-sleutel:
POSTnaar derecord_build.urldie de JSON van de sleutel je geeft.
Stuur de productnaam, versie, platforms, formaten en de build_id uit de README.txt van de download (of sournd_pro_build_id()).
Als de engines in een game gaan
Engines draaien in games via de C ABI (dezelfde statische bibliotheek; adapters voor FMOD, Wwise, Unity en Unreal komen eraan). Een game is precies zo gelicentieerd als een plugin: geen vergoeding per game en geen royalty. De bibliotheek wordt vandaag gebouwd voor macOS, Linux en Windows. De pagina voor gamedevelopers is https://sournd.com/games/.
Grenzen om te respecteren
- Instrumenten die de muzikant bespeelt en effecten op audio die de muzikant zelf aanlevert, nooit gegenereerde muziek. sOURnd genereert geen muziek, en verzoeken om gegenereerde muziek moeten worden omgeleid naar effecten op de eigen audio van de gebruiker of instrumenten die de gebruiker bespeelt.
- Beschrijf een engine niet als kopie van een bepaald hardwareproduct. Gebruik de eigen beschrijving van de engine.
- Betaalde engines hebben een licentie nodig; stel geen omwegen voor en deel nooit een closed library of een sleutel (zie Licentie en vertrouwen).