Note-orious

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

Sign in or sign up free to make an API key.

Get started in 3 steps

  1. 1. Make a key

    Name it after the app it's for, then copy it. It's only shown once.

  2. 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. 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": true

Make 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.