[{"data":1,"prerenderedAt":510},["ShallowReactive",2],{"page-data-\u002Fen\u002Fai\u002Fassistant\u002F":3,"prose-edu-link:none":9,"breadcrumb#\u002Fen\u002Fai\u002Fassistant\u002F":508},{"page":4,"navigation":448,"relatedArticles":506,"relatedTutorials":507},{"id":5,"title":6,"articles":7,"author":8,"automaticallyTranslated":9,"body":10,"cardHighlight":7,"dateModified":432,"datePublished":433,"description":434,"englishFileHash":7,"extension":435,"layout":7,"locale":436,"meta":437,"nav":438,"navigation":439,"nexttext":440,"nexturl":43,"path":441,"permalink":442,"pid":443,"ptitle":444,"reviewedBy":7,"seo":445,"stem":446,"thumbnail":7,"tip":7,"tutorials":7,"__hash__":447},"content\u002Fen\u002Findiv\u002Fai\u002F2.in-flat\u002F2.score-assistant.md","The notation assistant",null,"vincent",false,{"type":11,"value":12,"toc":418},"minimark",[13,22,25,28,51,56,59,72,79,82,86,114,122,133,137,144,153,156,160,180,184,187,265,273,277,280,285,299,304,317,322,342,345,349,372,376,384,387,391,394,410],[14,15,16,17,21],"p",{},"Ask the notation assistant about your score, or tell it what to change, the way you'd ask a fellow\nmusician: \"add chord symbols over the melody\", \"is this too hard for a beginner flute player?\".\nOpen ",[18,19,20],"strong",{},"Notation assistant"," on the left of the editor to start.",[14,23,24],{},"It reads the score you have open, answers in plain words, and makes the edits for you with the same\ntools you use in the editor. One click undoes any change, and it checks with you before it removes\nanything from your score.",[14,26,27],{},"It runs on frontier AI models: a fast one for questions and quick edits, a larger one when it\nwrites music.",[29,30,33,46],"callout",{"label":31,"type":32},"Flat Power","reminder",[14,34,35,36,40,41,45],{},"The notation assistant is part of ",[37,38,31],"a",{"href":39},"https:\u002F\u002Fflat.io\u002Fpricing"," and uses the\n",[37,42,44],{"href":43},"\u002Fen\u002Fai\u002Fcredits","AI credits"," included in your subscription. You can buy more credits if you need\nthem.",[14,47,48],{},[18,49,50],{},"Not available in Flat for Education.",[52,53,55],"h2",{"id":54},"beta","Join or leave the beta",[14,57,58],{},"The assistant is in beta. Join or leave it here:",[60,61,66],"beta-toggle",{":individual-only":62,"beta":63,"leave-also":64,"plan-feature":65},"true","editor.assistant","beta.editor.rail-file-menu","aiAssistant",[14,67,68,71],{},[18,69,70],{},"Notation assistant beta",": the notation assistant, with the new editor layout. Turning it off\nturns both off.",[14,73,74,75,78],{},"Joining also switches you to the new editor layout. To go back, use the button above or choose\n",[18,76,77],{},"Back to the previous layout"," in the File menu.",[14,80,81],{},"For now, it works on the Flat website on a computer.",[52,83,85],{"id":84},"what-it-can-do","What you can ask",[87,88,89,96,102,108],"ul",{},[90,91,92,95],"li",{},[18,93,94],{},"Questions about the score",": the key and the harmony, a part's range, whether it is playable,\nwhat a transposing instrument really sounds.",[90,97,98,101],{},[18,99,100],{},"Clean-up over a passage",": chord symbols, dynamics, articulations, hairpins.",[90,103,104,107],{},[18,105,106],{},"Copying, transposing or simplifying"," bars, for example for a player's level.",[90,109,110,113],{},[18,111,112],{},"New music",": four-part harmonizations, bass lines, countermelodies, accompaniments and drum\ngrooves, written into the parts you name.",[14,115,116,117,121],{},"It may write a long passage in several steps. See the ",[37,118,120],{"href":119},"#examples","sample requests"," for ideas.",[123,124,127],"screenshot",{"alt":125,"src":126},"The Notation assistant panel next to a flute and piano score, answering that the piece is in G major and listing the chords measure by measure, each measure a link into the score","\u002Fimg\u002Findividual\u002Fai\u002Fscore-assistant-question.png",[14,128,129],{},[130,131,132],"em",{},"\"What key is this piece in, and how does the harmony move in the first eight measures?\"",[52,134,136],{"id":135},"undo","Undo and confirmations",[14,138,139,140,143],{},"Every reply that changes your score has an ",[18,141,142],{},"Undo"," button. It reverts everything that reply did.\nIt works on the latest change only, and only until you edit the score yourself: after that, use the\neditor's undo. It never reverts your own edits.",[123,145,148],{"alt":146,"src":147},"The Notation assistant after adding chord symbols over the melody of measures 1 to 16, with 1 change to your score and the Undo button","\u002Fimg\u002Findividual\u002Fai\u002Fscore-assistant-edit.png",[14,149,150],{},[130,151,152],{},"\"add chord symbols over the melody\"",[14,154,155],{},"Before it deletes bars, parts, staves or voices, or rewrites a lot of existing notes, the assistant\nshows you what will change and waits for your OK. If you do not answer within a few minutes,\nnothing changes.",[52,157,159],{"id":158},"limits","What it cannot do yet",[87,161,162,168,174],{},[90,163,164,167],{},[18,165,166],{},"Anything outside your score or music."," It only works on the score you have open.",[90,169,170,173],{},[18,171,172],{},"Final verdicts."," It can check ranges, voice leading and playability, but treat its review as a\nsecond opinion and check it, especially for wrong notes.",[90,175,176,179],{},[18,177,178],{},"Very long messages or conversations."," A message is limited to 4,000 characters. When a\nconversation gets too long, it asks you to start a new one.",[52,181,183],{"id":182},"credits","How much use per credit",[14,185,186],{},"The cost depends on the request and on the size of your score. A Flat Power subscription includes\n10 credits a month. Typical costs for one request, on a 16-bar score for flute and piano:",[188,189,190,206],"table",{},[191,192,193],"thead",{},[194,195,196,200,203],"tr",{},[197,198,199],"th",{},"Request",[197,201,202],{},"Credits",[197,204,205],{},"With 10 credits",[207,208,209,221,232,243,254],"tbody",{},[194,210,211,215,218],{},[212,213,214],"td",{},"Questions about the score, from a quick fact to a harmony analysis",[212,216,217],{},"0.02 to 0.15",[212,219,220],{},"60 to 500",[194,222,223,226,229],{},[212,224,225],{},"Edits and markings, including transposing the whole score",[212,227,228],{},"about 0.02",[212,230,231],{},"about 500",[194,233,234,237,240],{},[212,235,236],{},"Chord symbols over a 16-bar melody",[212,238,239],{},"about 0.3",[212,241,242],{},"about 30",[194,244,245,248,251],{},[212,246,247],{},"A new bass line, 8 bars",[212,249,250],{},"about 0.25",[212,252,253],{},"about 40",[194,255,256,259,262],{},[212,257,258],{},"A countermelody or a four-part harmonization",[212,260,261],{},"0.6 to 1.2",[212,263,264],{},"8 to 16",[14,266,267,268,272],{},"Each reply shows what it cost and how many credits you have left. One message never costs more\nthan 2 credits, and a reply that fails without changing anything is not charged, up to 2 credits\na day. ",[37,269,271],{"href":270},"\u002Fen\u002Fai\u002Fcredits#assistant","How the assistant uses your credits",".",[52,274,276],{"id":275},"examples","Sample requests",[14,278,279],{},"Type the way you would message a fellow musician. A few that save real work:",[14,281,282],{},[18,283,284],{},"Understand your score",[87,286,287,290,293,296],{},[90,288,289],{},"\"what key is this in, and how does the harmony move in the first 8 bars?\"",[90,291,292],{},"\"is the flute part too hard for a beginner?\"",[90,294,295],{},"\"what note does the clarinet actually sound in bar 3?\"",[90,297,298],{},"\"where does the cello sit too high?\"",[14,300,301],{},[18,302,303],{},"Clean up a passage",[87,305,306,308,311,314],{},[90,307,152],{},[90,309,310],{},"\"give the first phrase some dynamics, all parts\"",[90,312,313],{},"\"staccato on all the eighths in the bass, bars 1-4\"",[90,315,316],{},"\"fade out the last two bars\"",[14,318,319],{},[18,320,321],{},"Write and arrange",[87,323,324,327,330,333,336,339],{},[90,325,326],{},"\"harmonize this melody for four voices\"",[90,328,329],{},"\"walking bass in the LH, bars 21-24\"",[90,331,332],{},"\"countermelody for the 2nd violins under the 1sts, bars 6-9\"",[90,334,335],{},"\"fingerpicking pattern in the guitar tab, bars 1-8\"",[90,337,338],{},"\"basic rock beat on the drums, bars 5-8\"",[90,340,341],{},"\"my students struggle with this, can you make the violin part easier?\"",[14,343,344],{},"Then keep going from its reply: \"make it simpler\", \"same for the next phrase\", \"undo that\".",[52,346,348],{"id":347},"tips","Tips for good results",[87,350,351,357,363],{},[90,352,353,356],{},[18,354,355],{},"Say where."," Name the bars and the part, like \"bars 5 to 8, Violin I\". If you select notes\nfirst, still name the bars when the request goes beyond the selection.",[90,358,359,362],{},[18,360,361],{},"Ask for one new part at a time."," Ask for the bass line, check it, then ask for the\naccompaniment.",[90,364,365,368,369,371],{},[18,366,367],{},"Check what it writes",", especially new music. If it is not what you wanted, click ",[18,370,142],{}," and\nrephrase.",[52,373,375],{"id":374},"privacy","Privacy",[14,377,378,379,383],{},"To answer, the assistant sends your message, the conversation so far, an outline of the score and\nthe bars you are working on to the provider of the AI model that handles the request, such as\nOpenAI or Anthropic. They are listed in our ",[37,380,382],{"href":381},"\u002Fen\u002Fgeneral\u002Fdata-infrastructure#subprocessors","subprocessors","\nand do not use what is sent through their API to train their models. Flat does not train AI models\non your scores either.",[14,385,386],{},"Your conversations are saved with the score, so you can come back to them. A conversation you\ndelete disappears straight away and is permanently deleted after 30 days.",[52,388,390],{"id":389},"feedback","Give feedback",[14,392,393],{},"Each reply has a thumbs up and a thumbs down. With a thumbs down you can say what went wrong and\nadd a comment. We read every rating to improve the assistant, so rate the replies that surprised\nyou, good or bad.",[395,396,398],"faq",{"title":397},"Frequently asked questions",[399,400,402],"faq-item",{"question":401},"Why don't I see the assistant in my editor?",[14,403,404,405,409],{},"Check that your plan includes it, that you ",[37,406,408],{"href":407},"#beta","joined the beta",", and that you are on the Flat\nwebsite on a computer.",[14,411,412,413,417],{},"Still stuck? ",[37,414,416],{"href":415},"\u002Fen\u002Fsupport","Contact us"," - we are always one message away.",{"title":419,"searchDepth":420,"depth":420,"links":421},"",3,[422,424,425,426,427,428,429,430,431],{"id":54,"depth":423,"text":55},2,{"id":84,"depth":423,"text":85},{"id":135,"depth":423,"text":136},{"id":158,"depth":423,"text":159},{"id":182,"depth":423,"text":183},{"id":275,"depth":423,"text":276},{"id":347,"depth":423,"text":348},{"id":374,"depth":423,"text":375},{"id":389,"depth":423,"text":390},"2026-10-28T12:19:07Z","2026-10-28T11:41:04Z","What Flat's notation assistant can do in the editor, how many requests your AI credits cover, sample requests, and how your conversations are handled.","md","en",{},"indiv\u002Fai",{"title":20},"How AI credits work","\u002Fen\u002Findiv\u002Fai\u002Fin-flat\u002Fscore-assistant","\u002Fen\u002Fai\u002Fassistant\u002F","ai-notation-assistant","The notation assistant - ask about and edit your score in plain words",{"title":6,"description":434},"en\u002Findiv\u002Fai\u002F2.in-flat\u002F2.score-assistant","tCQ05InaOMaeu-D4F_c9-Ya_Z6XYRaQ-DRNXpJMIcbA",{"title":449,"path":450,"stem":451,"children":452,"page":9},"AI in Flat","\u002Fen\u002Findiv\u002Fai","en\u002Findiv\u002Fai",[453,461,477],{"title":454,"path":455,"stem":456,"children":457,"permalink":459,"pid":460,"nav":438},"Overview","\u002Fen\u002Findiv\u002Fai\u002Foverview","en\u002Findiv\u002Fai\u002F1.overview\u002F1.index",[458],{"title":454,"path":455,"stem":456,"permalink":459,"pid":460,"nav":438},"\u002Fen\u002Fai\u002F","ai-assistants-intro",{"title":462,"path":463,"stem":464,"children":465,"page":9},"In Flat","\u002Fen\u002Findiv\u002Fai\u002Fin-flat","en\u002Findiv\u002Fai\u002F2.in-flat",[466,471,472],{"title":467,"path":468,"stem":469,"permalink":7,"pid":7,"nav":7,"link":470},"PDF & image import","\u002Fen\u002Findiv\u002Fai\u002Fin-flat\u002Fpdf-image-import","en\u002Findiv\u002Fai\u002F2.in-flat\u002F1.pdf-image-import","\u002Fen\u002Fmusic-notation-software\u002Fomr",{"title":20,"path":441,"stem":446,"permalink":442,"pid":443,"nav":438},{"title":44,"path":473,"stem":474,"permalink":475,"pid":476,"nav":438},"\u002Fen\u002Findiv\u002Fai\u002Fin-flat\u002Fai-credits","en\u002Findiv\u002Fai\u002F2.in-flat\u002F3.ai-credits","\u002Fen\u002Fai\u002Fcredits\u002F","faq-ai-credits",{"title":478,"path":479,"stem":480,"children":481,"page":9},"Connect your AI assistant","\u002Fen\u002Findiv\u002Fai\u002Fsetup","en\u002Findiv\u002Fai\u002F3.setup",[482,488,494,500],{"title":483,"path":484,"stem":485,"permalink":486,"pid":487,"nav":438},"What it can do","\u002Fen\u002Findiv\u002Fai\u002Fsetup\u002Fconnect","en\u002Findiv\u002Fai\u002F3.setup\u002F1.connect","\u002Fen\u002Fai\u002Fconnect\u002F","ai-assistants-connect",{"title":489,"path":490,"stem":491,"permalink":492,"pid":493,"nav":438},"ChatGPT","\u002Fen\u002Findiv\u002Fai\u002Fsetup\u002Fchatgpt","en\u002Findiv\u002Fai\u002F3.setup\u002F2.chatgpt","\u002Fen\u002Fai\u002Fchatgpt\u002F","ai-assistants-chatgpt",{"title":495,"path":496,"stem":497,"permalink":498,"pid":499,"nav":438},"Claude","\u002Fen\u002Findiv\u002Fai\u002Fsetup\u002Fclaude","en\u002Findiv\u002Fai\u002F3.setup\u002F3.claude","\u002Fen\u002Fai\u002Fclaude\u002F","ai-assistants-claude",{"title":501,"path":502,"stem":503,"permalink":504,"pid":505,"nav":438},"Other MCP apps","\u002Fen\u002Findiv\u002Fai\u002Fsetup\u002Fother-mcp-clients","en\u002Findiv\u002Fai\u002F3.setup\u002F4.other-mcp-clients","\u002Fen\u002Fai\u002Fmcp-clients\u002F","ai-assistants-mcp",[],[],{"tree":509},[],1793190837892]