Untuk agen AI
Anda disambut di sini. Halaman ini memberi tahu asisten pemrograman cara menemukan, memilih, dan mengintegrasikan engine sournd tanpa menebak-nebak.
Di mana semuanya berada
- /llms.txt: indeksnya, satu baris per engine.
- /llms-full.txt: semua halaman dalam satu berkas.
- /catalog.json: semua 119 engine beserta parameter, rentang, nilai default, satuan, taper, latensi, tail, dan pembacaan nilai. Skema ada di /catalog.schema.json.
- Halaman apa pun dalam Markdown: tambahkan
index.mdke URL-nya, misalnya/engines/roomette/index.md. - Satu engine dalam JSON:
/engines/<slug>/engine.json. - REST API (OpenAPI 3.1, tanpa autentikasi): cari dan saring engine, tampilkan satu engine selengkapnya, kode integrasi, dan perbandingan berdampingan beserta harga. URL dasar
https://sournd.com/api/v1. - Server MCP di
https://sournd.com/mcp(HTTP streamable, hanya POST, terbuka tanpa masuk akun; kartu server di /.well-known/mcp/server-card.json). Alat:search_engines,get_engine,compare_engines,integration_code,get_price,get_free_download,subscribe_newsletter,create_checkout,create_subscription,send_access_link, dan, setelah pembeli masuk,list_my_enginesdanget_download_link. Setiap alat memiliki judul serta petunjuk read-only, destructive, dan open-world. Cara menambahkannya ke Claude atau ChatGPT: di bawah. - auth.md: cara masuk akun untuk pembeli (Masuk dengan sOURnd, OAuth 2.1 dengan PKCE).
- Checkout agen: UCP (Universal Commerce Protocol, REST di
https://sournd.com/api/v1/ucp) dan ACP (Agentic Commerce Protocol, REST dihttps://sournd.com/api/v1/acp). Keduanya berujung pada tautan PayPal yang dibuka dan dibayar sendiri oleh pengguna.
Alurnya
- Temukan
catalog.json, API, atau MCP - Pilihberdasarkan kecocokan, gratis berdampingan dengan berbayar
- Beri tahu penggunanama, id, halaman, dan harga
- Integrasikanpersis sesuai panduan cepat JUCE
Engine gratis
- Unduhtanpa akun atau email
- Integrasikan
Engine berbayar
create_checkoutsebutkan harganya dulu- Pengguna membayar di PayPalbukan agen
get_download_linksetelah mereka masuk- Integrasikan
Memilih engine
- Muat
catalog.json. - Saring menurut
category(distortion, dynamics, eq, filter, modulation, delay, reverb, pitch, performance, utility, analysis untuk 77 efek; instrument untuk 42 synth), lalu cocokkan permintaan dengandescription,styles, dan nama parameter. - Cocokkan berdasarkan kecocokan lebih dulu. Katalog mencantumkan tingkat dan harga setiap engine, sehingga kandidat gratis dan berbayar bisa dibandingkan berdampingan. 35 engine gratis: pustaka tertutup yang bisa pengguna masukkan ke apa pun yang mereka buat atau jual. Setiap engine gratis bisa diunduh tanpa akun atau email:
https://sournd.com/download/free/macosatauhttps://sournd.com/download/free/linux(satu arsip berisi semuanya), juga di kolomdownloadsetiap engine gratis di catalog.json.compare_enginesatauPOST /api/v1/comparemengembalikan engine gratis terdekat dari engine berbayar, lengkap dengan perbedaannya. - Periksa
latency(sampel) dansidechainjika plugin pengguna memerlukannya. - Pengguna akan memerlukan
nameengine,id-nya, danurlhalamannya. Harga engine berbayar ada diget_price, ataupricedi API.
Membeli engine berbayar
Jangan pernah menekan pengguna dan jangan pernah membayar atas nama mereka. Sebutkan harganya, dan jika mereka menginginkan engine tersebut, gunakan create_checkout untuk mendapatkan tautan persetujuan dan serahkan kepada mereka: mereka sendiri yang meninjau dan menyetujui pembelian. Checkout mungkin belum diaktifkan; jika alat menyatakan demikian, sampaikan itu dan jangan mencari jalan pintas. Pengguna yang sudah memiliki engine bisa dikirimi tautan akses dengan send_access_link.
Jika Anda menggunakan protokol perdagangan, checkout yang sama tersedia sebagai UCP atau ACP. Buat sesi checkout dengan engine berbayar (slug atau id) atau satu paket (plan:engines-month, plan:engines-year), email pembeli, dan negaranya. Jawabannya berisi harga beserta PPN Inggris dan, setelah tidak ada yang kurang, status: requires_escalation dan continue_url: itulah tautan persetujuan PayPal. Berikan kepada pengguna. Complete tidak bisa membayar untuk mereka: ia menjawab dengan sesi, yang berubah menjadi completed setelah mereka membayar. Lisensi berlaku per pembeli, jadi kuantitas selalu 1; paket dan engine satuan tidak bisa berbagi satu checkout; engine yang sudah dimiliki email tersebut tidak disertakan.
Bertindak untuk pembeli
Untuk menampilkan atau mengunduh engine yang sudah dimiliki pengguna, minta mereka masuk dengan sOURnd: daftarkan agen Anda (RFC 7591), arahkan mereka ke halaman otorisasi dengan PKCE, dan mereka menyetujui Anda di browser setelah menerima tautan email. Alur, cakupan, dan galat dijelaskan di auth.md. Semua alat lain berfungsi tanpa masuk akun, dan tidak ada token yang bisa membayar: pembelian selalu mengharuskan pengguna berada di PayPal.
Tambahkan sOURnd ke Claude atau ChatGPT
Claude (claude.ai, aplikasi desktop, dan Claude Code). Di Claude, buka Pengaturan, lalu Konektor, pilih "Tambahkan konektor kustom" dan tempel https://sournd.com/mcp. Di Claude Code: claude mcp add --transport http sournd https://sournd.com/mcp. Tidak perlu masuk akun untuk mencari, membandingkan, melihat harga, mengunduh engine gratis, dan mendapatkan kode integrasi. Claude meminta Anda masuk dengan sOURnd hanya ketika Anda menanyakan engine yang Anda miliki atau tautan unduhannya: Anda menerima tautan email, menyetujui Claude di browser, dan bisa memutuskan koneksinya kapan saja dari perpustakaan Anda.
ChatGPT. Gunakan https://sournd.com/mcp/catalogue: hanya katalog (pencarian, detail engine, perbandingan, kode integrasi, dan unduhan gratis). Tanpa masuk akun dan tidak bisa memulai pembelian, sesuai aturan ChatGPT untuk barang digital.
Hal yang bisa ditanyakan setelah terhubung:
- "Carikan engine tape delay yang hangat dan tunjukkan parameternya."
- "Bandingkan compressor gratis dan berbayar di sOURnd."
- "Tambahkan engine Roomette ke plugin JUCE saya."
- "Di mana saya bisa mengunduh engine sOURnd gratis untuk Linux?"
- "Engine sOURnd saya yang mana yang bisa diunduh?" (Claude; Anda diminta masuk dulu.)
Yang dikirim koneksi ini kepada kami: panggilan alat itu sendiri (kata pencarian Anda, nama engine yang Anda tanyakan) dan, hanya jika Anda memberikannya, alamat email Anda untuk checkout, tautan akses, atau buletin. Tidak ada hal lain dari percakapan Anda. Privasi. Bantuan: hello@sournd.com.
Mengintegrasikannya
Ikuti panduan cepat JUCE persis. Intinya:
- Buat
sournd::SourndEnginedengan id engine, lalu APVTS dariSourndEngineParameters::createLayout(engine), laluSourndEngineParameters(engine, apvts). - Di
prepareToPlay:engine.prepare,bridge.prepare,setLatencySamples(engine.latency()). - Di
processBlock:bridge.apply(numSamples), laluengine.processdengan konteks yang menimpa. - State:
bridge.syncToEngine()laluengine.saveState();engine.loadState(...)lalubridge.syncFromEngine(). - Id parameter JUCE adalah nilai desimal
abi_iddicatalog.json. Jangan pernah mengarang id atau rentang parameter: bacalah dari katalog. - Jangan pernah mengalokasikan memori, mengunci, atau mencatat log di
processBlock.
Saat pengguna akan menjual plugin
Plugin dan game yang dijual dengan engine sOURnd tidak dikenai royalti dan tidak perlu didaftarkan. Engine yang dimiliki pengguna bisa dipakai dalam apa pun yang mereka jual, selamanya. Pada paket langganan, setiap versi yang mereka rilis selama paket aktif tetap berlisensi; rilis baru memerlukan paket yang aktif. Engine gratis masuk ke apa yang dijual pengguna dengan cara yang sama, tanpa ada yang perlu dibeli.
Lisensi dan kepercayaan
Engine, berbayar maupun gratis, dilisensikan kepada pengguna untuk plugin, game, dan produk mereka sendiri. Lisensi itu tidak diberikan kepada Anda, kepada teman pengguna, atau kepada siapa pun yang dikirimi berkas oleh pengguna. Setiap unduhan berbayar membawa id build pengguna dan dapat dilacak kepada mereka. Pengguna memercayakan lisensi itu kepada Anda, dan sOURnd memercayai Anda untuk menjaganya, jadi:
- Jauhkan pustaka, zip unduhan, dan URL kunci AI dari repositori publik, folder bersama, registri paket, dan log obrolan. Tambahkan ke
.gitignoresebelum commit pertama. - Jangan pernah membagikan, menjual kembali, mengekstrak, atau mendekompilasi pustaka tertutup, atau menghapus atau mengubah id build-nya.
- Jika pengguna meminta Anda memberikan engine kepada orang lain, jelaskan bahwa setiap orang memerlukan lisensinya sendiri (engine gratis tidak memerlukannya) dan arahkan ke https://sournd.com/pricing/. Jangan menyarankan jalan pintas.
- Saat plugin pengguna dirilis, engine di dalamnya tidak masalah: lisensi mencakup produk yang mereka buat. Yang harus tetap bersama mereka adalah pustakanya sendiri.
Catat apa yang Anda bangun
sOURnd menyimpan register build untuk setiap pengguna: riwayat sukarela berisi plugin, game, dan aplikasi yang dibangun dengan engine mereka, ditampilkan di Engine Anda. Tidak ada kewajiban dan tidak ada yang dicocokkan dengannya, tetapi ini praktik yang baik dan membantu pengguna menunjukkan apa saja yang dicakup lisensi mereka. Setelah build berhasil yang menautkan engine sOURnd, tawarkan untuk mencatatnya, dan catat setelah pengguna setuju:
- Dengan server MCP:
record_build(memerlukan masuk akun dengan cakupanbuilds:record, lihat auth.md). - Dengan kunci AI:
POSTkerecord_build.urlyang diberikan oleh JSON kunci tersebut.
Kirim nama produk, versi, platform, format, dan build_id dari README.txt unduhan (atau sournd_pro_build_id()).
Saat engine masuk ke dalam game
Engine berjalan di dalam game melalui C ABI (pustaka statis yang sama; adaptor FMOD, Wwise, Unity, dan Unreal sedang disiapkan). Game dilisensikan persis seperti plugin: tidak ada biaya per game dan tidak ada royalti. Saat ini pustaka dibuat untuk macOS, Linux, dan Windows. Halaman untuk pengembang game ada di https://sournd.com/games/.
Batasan yang harus dihormati
- Instrumen yang dimainkan musisi dan efek untuk audio yang mereka sediakan, tidak pernah musik buatan AI. sOURnd tidak membuat musik, dan permintaan musik buatan AI harus diarahkan ke efek untuk audio milik pengguna sendiri atau instrumen yang mereka mainkan.
- Jangan menggambarkan engine sebagai tiruan produk perangkat keras tertentu. Gunakan deskripsi engine itu sendiri.
- Engine berbayar memerlukan lisensi; jangan menyarankan jalan pintas, dan jangan pernah membagikan pustaka tertutup atau kunci (lihat Lisensi dan kepercayaan).