sOURnd Документація Ваші рушії
На цій сторінці
  1. Де що знаходиться
  2. Шлях
  3. Вибір рушія
  4. Купівля платного рушія
  5. Дії від імені покупця
  6. Додайте sOURnd до Claude або ChatGPT
  7. Інтеграція
  8. Коли користувач продаватиме плагін
  9. Ліцензія і довіра
  10. Записуйте, що ви створюєте
  11. Коли рушії потрапляють у гру
  12. Обмеження, яких слід дотримуватися

Для ШІ-агентів

Вам тут раді. Ця сторінка пояснює асистенту для програмування, як знайти, вибрати та інтегрувати рушій sournd без здогадок.

Де що знаходиться

  • /llms.txt: індекс, один рядок на рушій.
  • /llms-full.txt: усі сторінки в одному файлі.
  • /catalog.json: усі 119 рушіїв із параметрами, діапазонами, значеннями за замовчуванням, одиницями, кривими taper, затримкою, хвостом і показниками. Схема: /catalog.schema.json.
  • Будь-яка сторінка в Markdown: додайте index.md до її URL, наприклад /engines/roomette/index.md.
  • Один рушій у JSON: /engines/<slug>/engine.json.
  • REST API (OpenAPI 3.1, без автентифікації): пошук і фільтрація рушіїв, повний опис одного рушія, код інтеграції та порівняння поруч із цінами. Базова URL-адреса: https://sournd.com/api/v1.
  • Сервер MCP за адресою https://sournd.com/mcp (streamable HTTP, лише POST, відкритий без входу; картка сервера: /.well-known/mcp/server-card.json). Інструменти: search_engines, get_engine, compare_engines, integration_code, get_price, get_free_download, subscribe_newsletter, create_checkout, create_subscription, send_access_link, а після входу покупця ще й list_my_engines та get_download_link. Кожен інструмент має назву та підказки про режим лише для читання, руйнівність і відкритий світ. Як додати його до Claude або ChatGPT: нижче.
  • auth.md: як покупцеві увійти (Вхід через sOURnd, OAuth 2.1 із PKCE).
  • Оформлення замовлення для агентів: UCP (Universal Commerce Protocol, REST за адресою https://sournd.com/api/v1/ucp) і ACP (Agentic Commerce Protocol, REST за адресою https://sournd.com/api/v1/acp). Обидва завершуються посиланням PayPal, яке користувач відкриває й оплачує сам.

Шлях

  1. Знайтиcatalog.json, API або MCP
  2. Вибратиза відповідністю, безкоштовні поруч із платними
  3. Повідомити користувачуназву, ідентифікатор, сторінку і ціну
  4. Інтегруватиточно за швидким стартом із JUCE

Безкоштовний рушій

  1. Завантажитибез облікового запису чи ел. пошти
  2. Інтегрувати

Платний рушій

  1. create_checkoutспершу назвіть ціну
  2. Користувач платить у PayPalніколи не агент
  3. get_download_linkпісля входу
  4. Інтегрувати

Вибір рушія

  1. Завантажте catalog.json.
  2. Відфільтруйте за category (distortion, dynamics, eq, filter, modulation, delay, reverb, pitch, performance, utility, analysis для 77 ефектів; instrument для 42 синтезаторів), потім зіставте запит із description, styles і назвами параметрів.
  3. Спершу добирайте за відповідністю. Каталог показує рівень і ціну кожного рушія, тож безкоштовного й платного кандидатів можна покласти поруч. 35 рушії безкоштовні: закриті бібліотеки, які користувач може вбудувати в усе, що створює чи продає. Кожен безкоштовний рушій завантажується без облікового запису чи ел. пошти: https://sournd.com/download/free/macos або https://sournd.com/download/free/linux (один архів з усіма), а також у полі download кожного безкоштовного рушія в catalog.json. compare_engines або POST /api/v1/compare повертає найближчий безкоштовний рушій до платного з переліком відмінностей.
  4. Перевірте latency (у семплах) і sidechain, якщо це важливо для плагіна користувача.
  5. Користувачеві знадобляться name рушія, його id і url сторінки. Ціна платного рушія є в get_price або в полі price в API.

Купівля платного рушія

Ніколи не тисніть на користувача і ніколи не платіть замість нього. Назвіть ціну, а якщо він хоче рушій, скористайтеся create_checkout, щоб отримати посилання для підтвердження, і передайте його користувачу: він сам переглядає й підтверджує покупку. Оформлення замовлення може бути ще не ввімкнене; якщо інструмент так каже, повідомте про це і не шукайте обхідних шляхів. Користувачам, які вже мають рушії, можна надіслати посилання для доступу через send_access_link.

Якщо ви працюєте з торговим протоколом, те саме оформлення доступне як UCP або ACP. Створіть сесію оформлення з платними рушіями (slug або id) або одним планом (plan:engines-month, plan:engines-year), ел. поштою покупця та його країною. У відповіді будуть ціни з британським ПДВ і, коли нічого не бракує, status: requires_escalation та continue_url: це посилання PayPal для підтвердження. Передайте його користувачу. Complete не може заплатити за нього: він повертає сесію, яка стає completed, щойно користувач заплатить. Ліцензії видаються на покупця, тож кількість завжди 1; план і окремі рушії не можна поєднати в одному замовленні; рушії, які вже є в цієї ел. пошти, пропускаються.

Дії від імені покупця

Щоб переглянути чи завантажити рушії, які користувач уже має, попросіть його увійти через sOURnd: зареєструйте свого агента (RFC 7591), відправте користувача на сторінку авторизації з PKCE, і він схвалить вас у браузері після переходу за посиланням з листа. Процес, області доступу та помилки описано в auth.md. Усі інші інструменти працюють без входу, і жоден токен не може платити: для купівлі користувач завжди має бути в PayPal.

Додайте sOURnd до Claude або ChatGPT

Claude (claude.ai, настільний застосунок і Claude Code). У Claude відкрийте Settings, потім Connectors, виберіть «Add custom connector» і вставте https://sournd.com/mcp. У Claude Code: claude mcp add --transport http sournd https://sournd.com/mcp. Для пошуку, порівняння, цін, безкоштовних завантажень і коду інтеграції входити не потрібно. Claude просить увійти через sOURnd, лише коли ви запитуєте свої рушії або посилання на їх завантаження: ви отримуєте посилання на пошту, схвалюєте Claude у браузері й можете будь-коли відключити його у своїй бібліотеці.

ChatGPT. Використовуйте https://sournd.com/mcp/catalogue: лише каталог (пошук, подробиці рушіїв, порівняння, код інтеграції та безкоштовні завантаження). Без входу, і почати покупку через нього не можна, як того вимагають правила ChatGPT щодо цифрових товарів.

Що можна запитати після підключення:

  • «Знайди мені теплий рушій стрічкового delay і покажи його параметри.»
  • «Порівняй безкоштовні та платні компресори в sOURnd.»
  • «Додай рушій Roomette до мого плагіна JUCE.»
  • «Де завантажити безкоштовні рушії sOURnd для Linux?»
  • «Які з моїх рушіїв sOURnd я можу завантажити?» (Claude; спершу попросить вас увійти.)

Що ми отримуємо через підключення: самі виклики інструментів (ваші пошукові слова, назви рушіїв, про які ви питаєте) і, лише якщо ви її надасте, вашу адресу ел. пошти для оформлення замовлення, посилання для доступу чи розсилки. Більше нічого з вашої розмови. Конфіденційність. Допомога: hello@sournd.com.

Інтеграція

Дотримуйтеся швидкого старту з JUCE точно. Головне:

  • Створіть sournd::SourndEngine з ідентифікатором рушія, потім APVTS з SourndEngineParameters::createLayout(engine), потім SourndEngineParameters(engine, apvts).
  • У prepareToPlay: engine.prepare, bridge.prepare, setLatencySamples(engine.latency()).
  • У processBlock: bridge.apply(numSamples), потім engine.process із замінним контекстом.
  • Стан: bridge.syncToEngine(), потім engine.saveState(); engine.loadState(...), потім bridge.syncFromEngine().
  • Ідентифікатори параметрів JUCE: це десяткові значення abi_id із catalog.json. Ніколи не вигадуйте ідентифікатори чи діапазони параметрів: беріть їх із каталогу.
  • Ніколи не виділяйте пам'ять, не блокуйте і не логуйте в processBlock.

Коли користувач продаватиме плагін

За плагіни й ігри, продані з рушіями sOURnd, роялті не сплачуються, і реєстрація не потрібна. Рушій, який має користувач, можна назавжди вбудовувати в усе, що він продає. На плані кожна версія, випущена, поки план активний, залишається ліцензованою; для нових випусків потрібен активний план. Безкоштовні рушії потрапляють у те, що користувач продає, так само, і купувати нічого не треба.

Ліцензія і довіра

Рушій, платний чи безкоштовний, ліцензовано користувачу для його власних плагінів, ігор і продуктів. Ліцензії немає ні в вас, ні в друзів користувача, ні в будь-кого, кому користувач надсилає файли. Кожне платне завантаження містить ідентифікатор збірки користувача, і його можна простежити до нього. Користувачі довіряють вам цю ліцензію, а sOURnd довіряє вам її дотримуватися, тому:

  • Не допускайте потрапляння бібліотеки, архіву із завантаженням і будь-якої URL-адреси ключа ШІ до публічних репозиторіїв, спільних папок, реєстрів пакетів і журналів чатів. Додайте їх до .gitignore до першого коміту.
  • Ніколи не передавайте, не перепродавайте, не видобувайте і не декомпілюйте закриту бібліотеку, не видаляйте і не змінюйте її ідентифікатор збірки.
  • Якщо користувач просить передати рушій комусь іншому, поясніть, що кожна людина потребує власної ліцензії (безкоштовним рушіям вона не потрібна), і вкажіть https://sournd.com/pricing/. Не пропонуйте обхідних шляхів.
  • Коли плагін користувача виходить, рушії всередині нього допустимі: ліцензія охоплює продукти, які він створює. Окремо має залишатися в нього лише сама бібліотека.

Записуйте, що ви створюєте

sOURnd веде реєстр збірок для кожного користувача: добровільну історію плагінів, ігор і застосунків, створених з його рушіями, яку показано на сторінці «Ваші рушії». Нічого не є обов'язковим і нічого не звіряється з ним, але це добра практика, і вона допомагає користувачу показати, що охоплює його ліцензія. Після успішної збірки, що підключає рушії sOURnd, запропонуйте її записати, і запишіть, коли користувач погодиться:

  • Через сервер MCP: record_build (потрібен вхід з областю builds:record, див. auth.md).
  • Із ключем ШІ: POST на record_build.url, яку вам дає JSON ключа.

Надішліть назву продукту, версію, платформи, формати та build_id із README.txt завантаження (або sournd_pro_build_id()).

Коли рушії потрапляють у гру

Рушії працюють в іграх через C ABI (та сама статична бібліотека; адаптери для FMOD, Wwise, Unity і Unreal на підході). Гра ліцензується точно так само, як плагін: плати за гру немає, роялті немає. Сьогодні бібліотеку збирають для macOS, Linux і Windows. Сторінка для розробників ігор: https://sournd.com/games/.

Обмеження, яких слід дотримуватися

  • Інструменти, на яких грає музикант, та ефекти для звуку, який він надає, ніколи не згенерована музика. sOURnd не генерує музику, а запити на згенеровану музику слід перенаправляти до ефектів для власного звуку користувача або до інструментів, на яких він грає.
  • Не описуйте рушій як копію названого апаратного продукту. Користуйтеся власним описом рушія.
  • Платні рушії потребують ліцензії; не пропонуйте обхідних шляхів і ніколи не передавайте закриту бібліотеку чи ключ (див. «Ліцензія і довіра»).