SoundBreak

Start a SoundBreak song generation with an AI artist. Prefer artist_name from the user (e.g. "Kevin") — the server resolves it when exactly one artist matches. Use ai_cowriter_id when known from list_artists. If ARTIST_AMBIGUOUS is returned, ask the user which match. Complimentary generations produce one song; a connected SoundBreak account produces two songs per generation. After this returns, IMMEDIATELY call get_song_generation_status once with the generation_id so the progress widget mounts — then stop polling (the widget refreshes itself and becomes the player when done). Do not share listen links until generation_status is complete. Anonymous ChatGPT users get two complimentary generations; after that they should sign in to SoundBreak (or create a free account) to keep writing. Never pitch paid plans, pricing, or subscriptions in ChatGPT.

create_song_generation

Get details for a specific SoundBreak AI artist by ai_cowriter_id, including opener message and write URL. No ChatGPT user account required.

get_artist_details

Mount/update the SoundBreak in-chat widget for a song generation. Call ONCE immediately after create_song_generation with the generation_id — this shows a compact progress UI that polls itself until complete, then swaps to the audio player. Do not keep calling this in a loop. Only share listen_url/embed_url when generation_status is complete and ready_to_share is true. If generation_id was lost, omit it to fetch this ChatGPT user's latest generation.

get_song_generation_status

Play a few recent SoundBreak chart songs written with one AI artist so the user can hear that sound. Use when they ask what an artist sounds like, want an example, or name an artist before writing. Pass artist_name or ai_cowriter_id. Do not use this to list the roster (list_artists) or songs this user made (list_my_songs). These songs belong to other writers. Do not offer to remove them or save them to My Tracks.

list_artist_examples

Play a short list of current popular SoundBreak chart songs. Use when the user asks what is popular, what is on SoundBreak, or wants to hear songs without naming an artist. Do not use this to list the roster (list_artists) or songs this user made (list_my_songs). These songs belong to other writers. Do not offer to remove them or save them to My Tracks.

list_top_tracks

List active SoundBreak AI artists (cowriters) available for co-writing. No ChatGPT user account required. For each bullet, print list_label (not name alone). The first row may be solo write (no_artist). Its list_label already has a short clause — print that clause with the bullet and do not add a longer explanation. Other rows format badges as Name (new) — active contest: …. Do not nest extra parentheses. Examples: On your own — your style, no cowriting artist; Graham Colton (new); Finesse2tymes — active contest: Finesse is looking for song ideas for his next album.

list_artists

List recent finished SoundBreak songs for this ChatGPT user (capped) and show the in-chat player. Includes tracks_url for their full library when signed in, and connect_url to add ChatGPT songs to their SoundBreak account so they do not lose them. Use when the user asks what songs they made, after generation completes if the player did not appear, when complimentary generations are used up, or when they say songs are missing from My Tracks. Only share listen_url/audio_url for songs with ready_to_share true. Those are preview links, not releases.

list_my_songs

App-only status poll used by the in-chat SoundBreak progress/player widget. Hidden from the model. Does not remount UI — returns structured status for the widget to apply in-place.

poll_song_generation_status

Take down the public SoundBreak preview page for a song this ChatGPT user created. Does not delete the recording. Use when they ask to take a song down, remove the listen page, or unlist a preview. Pass revision_id (preferred) or revision_hash from the current generation or list_my_songs. The server only allows songs created by this ChatGPT user. Songs on SoundBreak Radio or submitted for store distribution cannot be removed this way. After success, tell them the page is down, lyrics they wrote stay theirs, and the generated audio is kept only so it can be recognized if it shows up somewhere it shouldn't.

remove_song_preview