Abracadabrax Birthday Song

Return the status and saved output URLs of an existing song job owned by the linked account. A queued or running job older than ten minutes can be marked failed and its credits refunded once. This changes job and credit records; it never starts a generation.

get_song_job

Render the prepared song in the linked Abracadabrax account. Call this only after the user explicitly asked to generate, never on your own initiative: it spends the user's credits and sends the generation inputs to the configured model provider. Optional settings overwrite the saved project. Repeating with unchanged settings reuses a running or completed job, but a failed job can start a new paid attempt. Returns the job id and status; poll get_song_job for the audio. Without a linked account nothing is generated: the result has state account_required and dashboard_url, the Abracadabrax link where the user signs in or creates the account and finishes this exact song; present that link. Use this only to create a new song from a style description and (optional) lyrics. Do not use it for uploaded or existing audio: covers, remixes, extending or editing a track, stem separation, voice cloning or transcription.

generate_song

Prepare a personalized birthday song with Abracadabrax: the person's name, lyrics written in the conversation with the name and personal details, the music style and the voice. Returns the settings and the credits required; nothing is generated and no credits are spent. No sign-in is needed to prepare. New tracks only: do not use it for uploaded or existing audio (covers, remixes, extensions, stem separation, voice cloning); for those, point the user to the Abracadabrax music studio.

prepare_birthday_song

Show a saved Abracadabrax song project and its existing job. A queued or running job older than ten minutes can be marked failed and its credits refunded once. This changes job and credit records; it never starts a generation. Requires a project_id returned by prepare_song_project.

render_song_widget

Overwrite the saved widget settings (title, style, lyrics, instrumental, length, model) to a prepared song before generating. Changing generation settings detaches the prior job from this project without deleting that job or its media. Intended for the widget UI; no credits are spent. Use this only to create a new song from a style description and (optional) lyrics. Do not use it for uploaded or existing audio: covers, remixes, extending or editing a track, stem separation, voice cloning or transcription.

update_song_project