Songwriter
Prepare a song from a vibe
Prepare Studio fields, tagged lyrics and artwork from text, an image or a recording.
POST
/
api
/
vibe
/
Prepare Studio fields, tagged lyrics and artwork from text, an image or a recording.
Paid requests accept USDC session or Credits headers. Use the selected account consistently in headers and creator fields.
For Credits, send
string
For USDC:
Bearer followed by the complete issued session token.x-wallet-auth-token and x-credit-source (card or promo). A stable x-idempotency-key of at most 80 characters identifies a paid service operation.
JSON body
string
At least two characters unless an image or audio is supplied.
string
Image URL or image data URL.
string
Audio data URL or base64 recording.
string
Accepted
turbo or sft; audio mode is chosen on the generation request.NDJSON response
| Field | Type | Use |
|---|---|---|
status | event | step describes preparation. |
field | event | field and value update a Studio control. |
lyrics_start | event | Clear the previous lyric buffer. |
lyrics_delta | event | Append delta to the lyrics. |
cover_start | event | Artwork preparation started. |
songwriter_ready | event | Musical fields and lyrics are ready; artwork may still be running. |
cover | event | imageUrl supplies completed artwork. |
done | event | The full run finished. |
error | event | message describes a failed run. |
Draft fields
field events can set title, prompt, instrumental, vocalLanguage, tags, bpm, keyScale and audioDuration. Instrumental drafts skip vocal lyrics. Integrate Songwriter.⌘I