Quick Start
Get music playing in your Roblox experience in under 5 minutes.
Get your API key
Create an API key from the API Keys page. Copy it — you'll paste it into your script in Step 3.
Install the SDK
Option A — Wally (recommended if you use Wally):
[dependencies] AudioScape = "this-fifo/audioscape-sdk@0.7.0"
Then run wally install.
Option B — Roblox Model (no tooling needed):
Download AudioScape.rbxm and drag it into ServerStorage in Roblox Studio.
Prerequisite: Enable Allow HTTP Requests in Game Settings → Security.
Paste this script
Create a Script in ServerScriptService. Replace "your-api-key" with the key you copied in Step 1.
local ServerStorage = game:GetService("ServerStorage")
local SoundService = game:GetService("SoundService")
local AudioScape = require(ServerStorage.AudioScape)
local client = AudioScape.new("your-api-key")
-- Search for music
local result, err = client:search({ query = "chill lo-fi beats" })
if not result then warn("Search failed:", err) return end
-- Play the first track
local track = result.tracks[1]
print("Playing:", track.artist, "—", track.name)
local sound = Instance.new("Sound", SoundService)
sound.SoundId = "rbxassetid://" .. track.asset_id
sound:Play()Hit Play in Studio
Press Play in Roblox Studio. Check the Output window — you should see the track name printed, and hear music playing. That's it.
What's next?
SDK Reference
Browse, similar tracks, playlists, analytics tracking, and more.
Search API
Filters, pagination, response schema, and search features.
Build a Playlist
Pick genres, set a track count, and fetch it in-game with one call.
Example Scripts
Search boxes, genre browsers, auto-playlists, and more — ready to drop in.