{"openapi":"3.1.0","info":{"title":"Cucutime Song Idea API","version":"1.0.0","description":"Generate a personalized children's-song concept (title, style, characters, chorus, lyric outline) for any name and theme. Free, deterministic, no auth. Each response links to a free 30-second sample on cucutime.org.","contact":{"url":"https://cucutime.org"}},"servers":[{"url":"https://cucutime.org"}],"paths":{"/api/song-idea":{"get":{"operationId":"generateSongIdea","summary":"Generate a personalized song idea for a child","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","maxLength":40},"description":"The child's first name."},{"name":"theme","in":"query","required":false,"schema":{"type":"string","maxLength":80},"description":"What the song is about (e.g. \"space\", \"bedtime\", \"her birthday\")."},{"name":"lang","in":"query","required":false,"schema":{"type":"string","enum":["en","es","pt"],"default":"en"},"description":"Output language."}],"responses":{"200":{"description":"A personalized song concept.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SongIdea"}}}}}}}},"components":{"schemas":{"SongIdea":{"type":"object","properties":{"name":{"type":"string"},"theme":{"type":"string"},"language":{"type":"string"},"title":{"type":"string"},"musicStyle":{"type":"string"},"companionCharacter":{"type":"string"},"concept":{"type":"string"},"chorusSeed":{"type":"string"},"lyricIdeas":{"type":"array","items":{"type":"string"}},"callToAction":{"type":"object","properties":{"label":{"type":"string"},"url":{"type":"string"}}},"attribution":{"type":"string"}}}}}}