Poyo Generate Lyrics

Generate song lyrics on PoYo / poyo.ai via https://api.poyo.ai/api/generate/submit; use for generate-lyrics, lyric drafts, verses and choruses, theme-based songwriting, mood or genre guidance, music-generation preparation, callbacks, and music detail retrieval.

PoYo Links

• Model page: https://poyo.ai/models/generate-lyrics
• API docs: https://docs.poyo.ai/api-manual/music-series/generate-lyrics
• API key page: https://poyo.ai/dashboard/api-key

Use this skill to turn a theme, mood, genre, or story direction into a PoYo generate-lyrics request and retrieve the resulting lyric text.

Use When

• The user asks for generated lyrics, lyric ideas, verses, choruses, a song theme, or generate-lyrics.
• The output will feed a later Generate Music request.
• The workflow needs an async task, callback, or music-detail lookup.

Key Inputs

• model must be generate-lyrics.
• input.prompt is required and should state the theme, mood, genre feel, language, or story direction.
• Keep the prompt within the current documented limit of 200 words.
• callback_url is optional and useful for production workflows.

Security Rules

• Keep POYO_API_KEY server-side and out of browser code, repositories, logs, screenshots, and chat output.
• Do not include private customer information, unreleased lyrics, or confidential campaign text unless sharing it with PoYo is acceptable.
• Make live calls only when the user explicitly asks in a trusted environment.

Execution

• Read references/api.md for the request and result flow.
• Use scripts/submit_generate_lyrics.sh with a reviewed payload file.
• Save the returned task_id and query music detail or wait for the callback.
• Treat generated lyrics as a draft that may need originality, rights, and policy review before publication.

Output Expectations

Include the final prompt or payload summary, returned task_id when submitted, result retrieval method, and whether the lyrics will be passed into a music-generation workflow.