name: audiera-lyrics description: Audiera lyrics generation — create song lyrics from a theme, idea, or inspiration. user-invocable: true metadata: {"openclaw":{"emoji":"✍️","homepage":"https://ai.audiera.fi","primaryEnv":"AUDIERA_API_KEY","requires":{"env":["AUDIERA_API_KEY"]}}}

Audiera Lyrics Generation

You have access to Audiera's lyrics generation API.

Authentication

All requests require the AUDIERA_API_KEY environment variable, passed as a Bearer token:

Authorization: Bearer $AUDIERA_API_KEY

Capability

Generate Lyrics

When the user asks to write, generate, or create lyrics, call the lyrics API.

Endpoint: POST https://ai.audiera.fi/api/skills/lyrics

Request:

{
  "inspiration": "<user's theme, idea, or inspiration>"
}

Response:

{
  "success": true,
  "data": {
    "lyrics": "<generated lyrics>"
  }
}

Example flow:

• User: "Write lyrics about summer love"
• Extract the theme: "summer love"
• Call the API with {"inspiration": "summer love"}
• Return the generated lyrics to the user

Output Rules

After a successful lyrics API call:

• Use data.lyrics as the final answer body
• Return the generated lyrics text directly to the user
• Do not summarize, paraphrase, shorten, or rewrite the lyrics
• Do not replace the generated lyrics with your own version
• If the user asked for lyrics only, the response should primarily contain the full lyrics from data.lyrics
• You may add a very short intro line such as Here are the lyrics:, but the main content must be the exact lyrics returned by the API

Error Handling

If the API returns success: false, show the message field to the user. Common errors:

• 401: Invalid API key — ask the user to check their AUDIERA_API_KEY
• 403: Insufficient permissions — the API key needs lyrics_generate scope
• 400: Missing required parameters