Developers
Pull your Note-orious songs into shows, games and apps, or make new ones from code. StreamBeam and SOFT-WHERE Arcade use the same API to add your music to productions and games.
Your API keys
Get started in 3 steps
- 1. Make a key
Name it after the app it's for, then copy it. It's only shown once.
- 2. Paste it in
For StreamBeam or SOFT-WHERE Arcade, ask Claude to connect Note-orious music and give it the key. In your own code, send it as a bearer token.
- 3. Use your songs
List your songs, pull the MP3s, or make new ones from a prompt (1 token each).
Sign requests
Send your key as a bearer token. A key acts as you: it sees your songs and spends your tokens.
Authorization: Bearer nto_…
Your songs
GET https://note-orious.com/api/v1/music?q=storm&instrumental=true&limit=25
{ "songs": [ { "id", "title", "instrumental", "duration_sec", "audio_url", "cover_url",
"lyrics", "description", "page_url", "status", "ready" } ],
"next_offset": 25 }audio_url is an MP3 you can download and use in your own work.
Make a song
POST https://note-orious.com/api/v1/music
{ "prompt": "tense, driving orchestral chase cue with taiko drums", "instrumental": true, "title": "Rooftop Chase" }
→ 202 { "song": { "id", "status": "queued", … } } (1 token, about a minute)
GET https://note-orious.com/api/v1/music/{id} poll until "ready": trueMake a song from an arrangement
Send an arrangement instead of a prompt for exact control: tempo, key, time signature, the band, and parts in order with bars, dynamics, chords (one bar per |), melody, lyrics and tempo or key changes. It becomes timestamped directions for the model, and play-along shows your chart. In Claude, the Note-orious connector's arrangement_guide, arrangement_check and song_arrange tools do the same.
POST https://note-orious.com/api/v1/music
{
"title": "Prairie Shuffle",
"arrangement": {
"v": 1, "style": "Gritty electric blues", "bpm": 84, "key": "A", "mode": "blues",
"timeSig": "4/4", "feel": "shuffle", "vocals": "male", "ending": "hard stop",
"instruments": ["Electric guitar (crunch)", "Electric bass (fingered)", "Acoustic drum kit"],
"sections": [
{ "id": "a", "type": "Intro", "bars": 4, "energy": 2, "chords": "E7 | D7 | A7 | E7" },
{ "id": "b", "type": "Verse", "bars": 12, "energy": 3,
"chords": "A7 | D7 | A7 | A7 | D7 | D7 | A7 | A7 | E7 | D7 | A7 | E7",
"lyrics": "Woke up this morning…" }
]
}
}Your account
GET https://note-orious.com/api/v1/me → { "handle", "tokens", "unlimited" }Errors come back as { "error": "…" }: 401 bad key, 402 out of tokens, 404 not yours or not found.