{"id":"0649c112-8135-4ff1-9e08-1064097addff","entityType":"agent","slug":"clawhub-coolhackboy-poyo-get-timestamped-lyrics","name":"Poyo Get Timestamped Lyrics","canonicalUrl":"https://www.xpersona.co/agent/clawhub-coolhackboy-poyo-get-timestamped-lyrics","canonicalPath":"/agent/clawhub-coolhackboy-poyo-get-timestamped-lyrics","generatedAt":"2026-10-11T10:51:29.184Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T08:37:52.952Z","emptyReason":null},"description":"Retrieve timestamped lyrics on PoYo / poyo.ai via `https://api.poyo.ai/api/generate/submit`; use for `get-timestamped-lyrics`, synchronized lyrics, word timi...","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s177pant1v4gn5k13ffg1fp5b183nb02:poyo-get-timestamped-lyrics","sourceUrl":"https://clawhub.ai/coolhackboy/poyo-get-timestamped-lyrics","homepage":"https://clawhub.ai/coolhackboy/skills/poyo-get-timestamped-lyrics","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/coolhackboy/poyo-get-timestamped-lyrics","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/coolhackboy/skills/poyo-get-timestamped-lyrics","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Poyo Get Timestamped Lyrics technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T08:37:52.952Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T08:37:52.952Z","emptyReason":null},"stars":null,"forks":null,"downloads":1110,"packageName":null,"latestVersion":"1.0.1","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T08:37:52.941Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T08:37:52.952Z","lastCrawledAt":"2026-10-11T08:37:52.941Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T08:37:52.941Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.1","createdAt":"2026-07-09T02:11:48.973Z","changelog":"Retry security scan and indexing","fileCount":5,"zipByteSize":4564},{"version":"1.0.0","createdAt":"2026-07-09T01:24:13.618Z","changelog":"Initial release","fileCount":5,"zipByteSize":4708}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s177pant1v4gn5k13ffg1fp5b183nb02:poyo-get-timestamped-lyrics","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s177pant1v4gn5k13ffg1fp5b183nb02:poyo-get-timestamped-lyrics` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/coolhackboy/poyo-get-timestamped-lyrics before using production credentials."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-get-timestamped-lyrics/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-get-timestamped-lyrics/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-get-timestamped-lyrics/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-get-timestamped-lyrics/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-get-timestamped-lyrics/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-get-timestamped-lyrics/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T10:51:29.184Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-get-timestamped-lyrics/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-get-timestamped-lyrics/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-get-timestamped-lyrics/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-get-timestamped-lyrics/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T08:37:52.952Z","emptyReason":null},"readme":"Skill: Poyo Get Timestamped Lyrics\n\nOwner: coolhackboy\n\nSummary: Retrieve timestamped lyrics on PoYo / poyo.ai via `https://api.poyo.ai/api/generate/submit`; use for `get-timestamped-lyrics`, synchronized lyrics, word timi...\n\nTags: latest:1.0.1\n\nVersion history:\n\nv1.0.1 | 2026-07-09T02:11:48.973Z | user\n\nRetry security scan and indexing\n\nv1.0.0 | 2026-07-09T01:24:13.618Z | user\n\nInitial release\n\nArchive index:\n\nArchive v1.0.1: 5 files, 4564 bytes\n\nFiles: references/api.md (2325b), scripts/submit_get_timestamped_lyrics.sh (396b), skill-card.md (2411b), SKILL.md (3026b), _meta.json (146b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: poyo-get-timestamped-lyrics\ndescription: Retrieve timestamped lyrics on PoYo / poyo.ai via `https://api.poyo.ai/api/generate/submit`; use for `get-timestamped-lyrics`, synchronized lyrics, word timing, waveform data, task_id plus audio_id inputs, callbacks, and music detail retrieval.\nmetadata: {\"openclaw\":{\"homepage\":\"https://poyo.ai/models/get-timestamped-lyrics\",\"requires\":{\"bins\":[\"curl\"],\"env\":[\"POYO_API_KEY\"]},\"primaryEnv\":\"POYO_API_KEY\"}}\n---\n\n# PoYo Get Timestamped Lyrics\n\n## PoYo Links\n\n- Model page: <https://poyo.ai/models/get-timestamped-lyrics>\n- API docs: <https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics>\n- API key page: <https://poyo.ai/dashboard/api-key>\n\nUse this skill for `get-timestamped-lyrics` jobs on PoYo. It helps agents prepare synchronized-lyrics payloads from a generated music track, submit async requests, and explain timing results.\n\n## Use When\n\n- The user explicitly wants timestamped or synchronized lyrics for a PoYo-generated music track.\n- The user has a completed PoYo music `task_id` and `audio_id` and asks for a request payload, server-side curl command, callback setup, or result retrieval.\n- The user has already chosen PoYo as the execution provider for a lyrics timing workflow.\n\n## Model Selection\n\n- `get-timestamped-lyrics`: use for retrieving lyric timing and waveform data from a generated music track.\n\n## Key Inputs\n\n- `task_id` identifies the completed source music generation task.\n- `audio_id` identifies the specific audio track.\n- `callback_url` is optional and useful for production queues.\n\n## Security Rules\n\n- Treat `POYO_API_KEY` as a secret.\n- Keep PoYo API keys in server-side environment variables or a backend secret manager.\n- Never place an API key in browser code, frontend bundles, public repositories, logs, screenshots, or chat output.\n- Do not log private lyrics, customer task ids, audio identifiers, waveform data, callback URLs, or raw authorization headers unless the product policy allows it.\n- Do not use this skill for generic lyric analysis unless the user explicitly wants a PoYo Get Timestamped Lyrics API workflow.\n- Do not make live API calls unless the user explicitly asks, confirms the payload should be sent to PoYo, and provides a safe server-side environment.\n\n## Execution\n\n- Read `references/api.md` for endpoint details, request fields, examples, and result retrieval notes.\n- Use `scripts/submit_get_timestamped_lyrics.sh` only when the user wants to submit a prepared JSON payload from a trusted shell.\n- If the user only needs a curl example, adapt one from `references/api.md`.\n- After submission, report the returned `task_id` or timing response clearly so follow-up retrieval is easy.\n\n## Output Expectations\n\nWhen helping with Get Timestamped Lyrics, include:\n\n- chosen model id\n- source task and audio identifier summary\n- final payload or concise parameter summary\n- returned `task_id` or timing response if a request was actually submitted\n- next step: query status or wait for webhook\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn7f14qr8xdf5gs6pr7cm7p97h82m349\",\n  \"slug\": \"poyo-get-timestamped-lyrics\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1783563108973\n}\n\nFile v1.0.1:references/api.md\n\n# PoYo Get Timestamped Lyrics API Reference\n\n## Endpoint\n\n- Submit task: `POST https://api.poyo.ai/api/generate/submit`\n- Status query: `GET https://api.poyo.ai/api/generate/status/{task_id}`\n- Source docs: <https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics>\n- OpenAPI JSON: <https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics.json>\n- Model page: <https://poyo.ai/models/get-timestamped-lyrics>\n\n## Auth\n\nSend:\n\n```http\nAuthorization: Bearer YOUR_API_KEY\nContent-Type: application/json\n```\n\nGet API keys from <https://poyo.ai/dashboard/api-key>.\n\nRecommended skill env var:\n\n- `POYO_API_KEY`\n\n## Model\n\n- `get-timestamped-lyrics`: retrieve synchronized lyrics and timing data for a generated music track.\n\n## Request Schema\n\nTop-level fields:\n\n- `model` string, required\n- `callback_url` string URI, optional\n- `input` object, required\n\nRequired `input` fields:\n\n- `task_id` string\n- `audio_id` string\n\nAlways verify current field support in the PoYo docs before relying on model-specific options.\n\n## Submit Example\n\n```bash\ncurl --fail-with-body --request POST \\\n  --url \"https://api.poyo.ai/api/generate/submit\" \\\n  --header \"Authorization: Bearer YOUR_API_KEY\" \\\n  --header \"Content-Type: application/json\" \\\n  --data '{\n    \"model\": \"get-timestamped-lyrics\",\n    \"callback_url\": \"https://example.com/api/poyo/webhook\",\n    \"input\": {\n      \"task_id\": \"music_task_example\",\n      \"audio_id\": \"audio_track_example\"\n    }\n  }'\n```\n\n## Typical Timing Response\n\n```json\n{\n  \"code\": 200,\n  \"data\": {\n    \"aligned_words\": [\n      {\n        \"word\": \"[Verse]\",\n        \"success\": true,\n        \"start_s\": 1.36,\n        \"end_s\": 1.79\n      }\n    ],\n    \"waveform_data\": [0, 1, 0.5, 0.75],\n    \"is_streamed\": false\n  }\n}\n```\n\n## Status Query Example\n\n```bash\ncurl --fail-with-body --request GET \\\n  --url \"https://api.poyo.ai/api/generate/status/music_task_example\" \\\n  --header \"Authorization: Bearer YOUR_API_KEY\"\n```\n\n## Practical Guidance\n\n- Use a completed source music task id and a matching audio identifier.\n- Preserve lyric timing output exactly when the user needs subtitle, karaoke, or audio visualization workflows.\n- Use `callback_url` for production queues and longer user workflows.\n- Keep private lyrics, task ids, audio identifiers, callback URLs, and waveform data out of logs.\n\nFile v1.0.1:skill-card.md\n\n## Description:\n\nRetrieve timestamped lyrics on PoYo / poyo.ai via `https://api.poyo.ai/api/generate/submit`; use for `get-timestamped-lyrics`, synchronized lyrics, word timing, waveform data, task_id plus audio_id inputs, callbacks, and music detail retrieval.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[coolhackboy](https://clawhub.ai/user/coolhackboy)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and engineers use this skill to prepare and submit PoYo get-timestamped-lyrics requests for completed music tracks, then interpret synchronized word timing and waveform responses for subtitles, karaoke, or audio visualization workflows.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill submits request payloads containing task IDs, audio IDs, callback URLs, and related music data to PoYo.\n\nMitigation: Review the JSON payload before submission and send only data that is intended for PoYo.\n\nRisk: The PoYo API key is required for authenticated requests.\n\nMitigation: Store POYO_API_KEY as a server-side secret and avoid exposing it in browser code, public repositories, logs, screenshots, or chat output.\n\n## Reference(s):\n\n- [PoYo Get Timestamped Lyrics API Reference](references/api.md)\n- [PoYo Get Timestamped Lyrics Model Page](https://poyo.ai/models/get-timestamped-lyrics)\n- [PoYo Get Timestamped Lyrics API Documentation](https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics)\n- [PoYo Get Timestamped Lyrics OpenAPI JSON](https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics.json)\n- [ClawHub Skill Page](https://clawhub.ai/coolhackboy/skills/poyo-get-timestamped-lyrics)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Markdown, Code, Shell commands, Configuration]\n\n**Output Format:** [Markdown with JSON payloads and bash code blocks]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include request payloads, curl commands, returned task identifiers, timing response summaries, and next-step retrieval or webhook guidance.]\n\n## Skill Version(s):\n\n1.0.1 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.0: 5 files, 4708 bytes\n\nFiles: references/api.md (2325b), scripts/submit_get_timestamped_lyrics.sh (396b), skill-card.md (2899b), SKILL.md (3026b), _meta.json (146b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: poyo-get-timestamped-lyrics\ndescription: Retrieve timestamped lyrics on PoYo / poyo.ai via `https://api.poyo.ai/api/generate/submit`; use for `get-timestamped-lyrics`, synchronized lyrics, word timing, waveform data, task_id plus audio_id inputs, callbacks, and music detail retrieval.\nmetadata: {\"openclaw\":{\"homepage\":\"https://poyo.ai/models/get-timestamped-lyrics\",\"requires\":{\"bins\":[\"curl\"],\"env\":[\"POYO_API_KEY\"]},\"primaryEnv\":\"POYO_API_KEY\"}}\n---\n\n# PoYo Get Timestamped Lyrics\n\n## PoYo Links\n\n- Model page: <https://poyo.ai/models/get-timestamped-lyrics>\n- API docs: <https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics>\n- API key page: <https://poyo.ai/dashboard/api-key>\n\nUse this skill for `get-timestamped-lyrics` jobs on PoYo. It helps agents prepare synchronized-lyrics payloads from a generated music track, submit async requests, and explain timing results.\n\n## Use When\n\n- The user explicitly wants timestamped or synchronized lyrics for a PoYo-generated music track.\n- The user has a completed PoYo music `task_id` and `audio_id` and asks for a request payload, server-side curl command, callback setup, or result retrieval.\n- The user has already chosen PoYo as the execution provider for a lyrics timing workflow.\n\n## Model Selection\n\n- `get-timestamped-lyrics`: use for retrieving lyric timing and waveform data from a generated music track.\n\n## Key Inputs\n\n- `task_id` identifies the completed source music generation task.\n- `audio_id` identifies the specific audio track.\n- `callback_url` is optional and useful for production queues.\n\n## Security Rules\n\n- Treat `POYO_API_KEY` as a secret.\n- Keep PoYo API keys in server-side environment variables or a backend secret manager.\n- Never place an API key in browser code, frontend bundles, public repositories, logs, screenshots, or chat output.\n- Do not log private lyrics, customer task ids, audio identifiers, waveform data, callback URLs, or raw authorization headers unless the product policy allows it.\n- Do not use this skill for generic lyric analysis unless the user explicitly wants a PoYo Get Timestamped Lyrics API workflow.\n- Do not make live API calls unless the user explicitly asks, confirms the payload should be sent to PoYo, and provides a safe server-side environment.\n\n## Execution\n\n- Read `references/api.md` for endpoint details, request fields, examples, and result retrieval notes.\n- Use `scripts/submit_get_timestamped_lyrics.sh` only when the user wants to submit a prepared JSON payload from a trusted shell.\n- If the user only needs a curl example, adapt one from `references/api.md`.\n- After submission, report the returned `task_id` or timing response clearly so follow-up retrieval is easy.\n\n## Output Expectations\n\nWhen helping with Get Timestamped Lyrics, include:\n\n- chosen model id\n- source task and audio identifier summary\n- final payload or concise parameter summary\n- returned `task_id` or timing response if a request was actually submitted\n- next step: query status or wait for webhook\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn7f14qr8xdf5gs6pr7cm7p97h82m349\",\n  \"slug\": \"poyo-get-timestamped-lyrics\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1783560253618\n}\n\nFile v1.0.0:references/api.md\n\n# PoYo Get Timestamped Lyrics API Reference\n\n## Endpoint\n\n- Submit task: `POST https://api.poyo.ai/api/generate/submit`\n- Status query: `GET https://api.poyo.ai/api/generate/status/{task_id}`\n- Source docs: <https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics>\n- OpenAPI JSON: <https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics.json>\n- Model page: <https://poyo.ai/models/get-timestamped-lyrics>\n\n## Auth\n\nSend:\n\n```http\nAuthorization: Bearer YOUR_API_KEY\nContent-Type: application/json\n```\n\nGet API keys from <https://poyo.ai/dashboard/api-key>.\n\nRecommended skill env var:\n\n- `POYO_API_KEY`\n\n## Model\n\n- `get-timestamped-lyrics`: retrieve synchronized lyrics and timing data for a generated music track.\n\n## Request Schema\n\nTop-level fields:\n\n- `model` string, required\n- `callback_url` string URI, optional\n- `input` object, required\n\nRequired `input` fields:\n\n- `task_id` string\n- `audio_id` string\n\nAlways verify current field support in the PoYo docs before relying on model-specific options.\n\n## Submit Example\n\n```bash\ncurl --fail-with-body --request POST \\\n  --url \"https://api.poyo.ai/api/generate/submit\" \\\n  --header \"Authorization: Bearer YOUR_API_KEY\" \\\n  --header \"Content-Type: application/json\" \\\n  --data '{\n    \"model\": \"get-timestamped-lyrics\",\n    \"callback_url\": \"https://example.com/api/poyo/webhook\",\n    \"input\": {\n      \"task_id\": \"music_task_example\",\n      \"audio_id\": \"audio_track_example\"\n    }\n  }'\n```\n\n## Typical Timing Response\n\n```json\n{\n  \"code\": 200,\n  \"data\": {\n    \"aligned_words\": [\n      {\n        \"word\": \"[Verse]\",\n        \"success\": true,\n        \"start_s\": 1.36,\n        \"end_s\": 1.79\n      }\n    ],\n    \"waveform_data\": [0, 1, 0.5, 0.75],\n    \"is_streamed\": false\n  }\n}\n```\n\n## Status Query Example\n\n```bash\ncurl --fail-with-body --request GET \\\n  --url \"https://api.poyo.ai/api/generate/status/music_task_example\" \\\n  --header \"Authorization: Bearer YOUR_API_KEY\"\n```\n\n## Practical Guidance\n\n- Use a completed source music task id and a matching audio identifier.\n- Preserve lyric timing output exactly when the user needs subtitle, karaoke, or audio visualization workflows.\n- Use `callback_url` for production queues and longer user workflows.\n- Keep private lyrics, task ids, audio identifiers, callback URLs, and waveform data out of logs.\n\nFile v1.0.0:skill-card.md\n\n## Description: <br>\nRetrieve timestamped lyrics on PoYo / poyo.ai via `https://api.poyo.ai/api/generate/submit`; use for `get-timestamped-lyrics`, synchronized lyrics, word timing, waveform data, task_id plus audio_id inputs, callbacks, and music detail retrieval. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[coolhackboy](https://clawhub.ai/user/coolhackboy) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nDevelopers and operators use this skill to prepare and submit PoYo `get-timestamped-lyrics` requests for completed music tracks, then summarize timing results for subtitle, karaoke, or audio visualization workflows. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: POYO_API_KEY could be exposed through client code, logs, screenshots, chat output, or public repositories. <br>\nMitigation: Keep POYO_API_KEY in server-side environment variables or a backend secret manager, and never echo authorization headers or secrets in generated commands or responses. <br>\nRisk: Private lyrics, task IDs, audio IDs, callback URLs, or waveform data could be logged or shared unintentionally. <br>\nMitigation: Review payloads before submission and avoid logging private lyrics, task IDs, audio IDs, callback URLs, authorization headers, or raw timing data unless the deployment policy explicitly allows it. <br>\nRisk: A live PoYo request could be sent with the wrong payload or without user intent. <br>\nMitigation: Submit requests only after the user confirms the payload and execution environment, and use the included shell helper only from a trusted shell with a server-side POYO_API_KEY. <br>\n\n\n## Reference(s): <br>\n- [PoYo Get Timestamped Lyrics API Reference](references/api.md) <br>\n- [PoYo Get Timestamped Lyrics model page](https://poyo.ai/models/get-timestamped-lyrics) <br>\n- [PoYo Get Timestamped Lyrics API docs](https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics) <br>\n- [PoYo Get Timestamped Lyrics OpenAPI JSON](https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics.json) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance] <br>\n**Output Format:** [Markdown guidance with JSON payload examples and bash/curl commands] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May include a returned task_id or timing response only when the user explicitly confirms live submission from a trusted shell.] <br>\n\n## Skill Version(s): <br>\n1.0.0 (source: ClawHub release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>","readmeExcerpt":"Skill: Poyo Get Timestamped Lyrics Owner: coolhackboy Summary: Retrieve timestamped lyrics on PoYo / poyo.ai via https://api.poyo.ai/api/generate/submit; use for get-timestamped-lyrics, synchronized lyrics, word timi... Tags: latest:1.0.1 Version history: v1.0.1 | 2026-07-09T02:11:48.973Z | user Retry security scan and indexing v1.0.0 | 2026-07-09T01:24:13.618Z | user Initial release Archive index: Archive v1.0.1: 5 ","codeSnippets":[],"executableExamples":[{"language":"http","snippet":"Authorization: Bearer YOUR_API_KEY\nContent-Type: application/json"},{"language":"bash","snippet":"curl --fail-with-body --request POST \\\n  --url \"https://api.poyo.ai/api/generate/submit\" \\\n  --header \"Authorization: Bearer YOUR_API_KEY\" \\\n  --header \"Content-Type: application/json\" \\\n  --data '{"},{"language":"bash","snippet":"curl --fail-with-body --request POST \\\n  --url \"https://api.poyo.ai/api/generate/submit\" \\\n  --header \"Authorization: Bearer YOUR_API_KEY\" \\\n  --header \"Content-Type: application/json\" \\\n  --data '{\n    \"model\": \"get-timestamped-lyrics\",\n    \"callback_url\": \"https://example.com/api/poyo/webhook\",\n    \"input\": {\n      \"task_id\": \"music_task_example\",\n      \"audio_id\": \"audio_track_example\"\n    }\n  }'"},{"language":"json","snippet":"{\n  \"code\": 200,\n  \"data\": {\n    \"aligned_words\": [\n      {\n        \"word\": \"[Verse]\",\n        \"success\": true,\n        \"start_s\": 1.36,\n        \"end_s\": 1.79\n      }\n    ],\n    \"waveform_data\": [0, 1, 0.5, 0.75],\n    \"is_streamed\": false\n  }\n}"},{"language":"bash","snippet":"curl --fail-with-body --request GET \\\n  --url \"https://api.poyo.ai/api/generate/status/music_task_example\" \\\n  --header \"Authorization: Bearer YOUR_API_KEY\""},{"language":"bash","snippet":"curl --fail-with-body --request GET \\\n  --url \"https://api.poyo.ai/api/generate/status/music_task_example\" \\\n  --header \"Authorization: Bearer YOUR_API_KEY\""}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: poyo-get-timestamped-lyrics\ndescription: Retrieve timestamped lyrics on PoYo / poyo.ai via `https://api.poyo.ai/api/generate/submit`; use for `get-timestamped-lyrics`, synchronized lyrics, word timing, waveform data, task_id plus audio_id inputs, callbacks, and music detail retrieval.\nmetadata: {\"openclaw\":{\"homepage\":\"https://poyo.ai/models/get-timestamped-lyrics\",\"requires\":{\"bins\":[\"curl\"],\"env\":[\"POYO_API_KEY\"]},\"primaryEnv\":\"POYO_API_KEY\"}}\n---\n\n# PoYo Get Timestamped Lyrics\n\n## PoYo Links\n\n- Model page: <https://poyo.ai/models/get-timestamped-lyrics>\n- API docs: <https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics>\n- API key page: <https://poyo.ai/dashboard/api-key>\n\nUse this skill for `get-timestamped-lyrics` jobs on PoYo. It helps agents prepare synchronized-lyrics payloads from a generated music track, submit async requests, and explain timing results.\n\n## Use When\n\n- The user explicitly wants timestamped or synchronized lyrics for a PoYo-generated music track.\n- The user has a completed PoYo music `task_id` and `audio_id` and asks for a request payload, server-side curl command, callback setup, or result retrieval.\n- The user has already chosen PoYo as the execution provider for a lyrics timing workflow.\n\n## Model Selection\n\n- `get-timestamped-lyrics`: use for retrieving lyric timing and waveform data from a generated music track.\n\n## Key Inputs\n\n- `task_id` identifies the completed source music generation task.\n- `audio_id` identifies the specific audio track.\n- `callback_url` is optional and useful for production queues.\n\n## Security Rules\n\n- Treat `POYO_API_KEY` as a secret.\n- Keep PoYo API keys in server-side environment variables or a backend secret manager.\n- Never place an API key in browser code, frontend bundles, public repositories, logs, screenshots, or chat output.\n- Do not log private lyrics, customer task ids, audio identifiers, waveform data, callback URLs, or raw authorization headers unless the product policy allows it.\n- Do not use this skill for generic lyric analysis unless the user explicitly wants a PoYo Get Timestamped Lyrics API workflow.\n- Do not make live API calls unless the user explicitly asks, confirms the payload should be sent to PoYo, and provides a safe server-side environment.\n\n## Execution\n\n- Read `references/api.md` for endpoint details, request fields, examples, and result retrieval notes.\n- Use `scripts/submit_get_timestamped_lyrics.sh` only when the user wants to submit a prepared JSON payload from a trusted shell.\n- If the user only needs a curl example, adapt one from `references/api.md`.\n- After submission, report the returned `task_id` or timing response clearly so follow-up retrieval is easy.\n\n## Output Expectations\n\nWhen helping with Get Timestamped Lyrics, include:\n\n- chosen model id\n- source task and audio identifier summary\n- final payload or concise parameter summary\n- returned `task_id` or timing response if a request was actually submitted\n- next step: query s"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7f14qr8xdf5gs6pr7cm7p97h82m349\",\n  \"slug\": \"poyo-get-timestamped-lyrics\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1783563108973\n}"},{"path":"references/api.md","content":"# PoYo Get Timestamped Lyrics API Reference\n\n## Endpoint\n\n- Submit task: `POST https://api.poyo.ai/api/generate/submit`\n- Status query: `GET https://api.poyo.ai/api/generate/status/{task_id}`\n- Source docs: <https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics>\n- OpenAPI JSON: <https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics.json>\n- Model page: <https://poyo.ai/models/get-timestamped-lyrics>\n\n## Auth\n\nSend:\n\n```http\nAuthorization: Bearer YOUR_API_KEY\nContent-Type: application/json\n```\n\nGet API keys from <https://poyo.ai/dashboard/api-key>.\n\nRecommended skill env var:\n\n- `POYO_API_KEY`\n\n## Model\n\n- `get-timestamped-lyrics`: retrieve synchronized lyrics and timing data for a generated music track.\n\n## Request Schema\n\nTop-level fields:\n\n- `model` string, required\n- `callback_url` string URI, optional\n- `input` object, required\n\nRequired `input` fields:\n\n- `task_id` string\n- `audio_id` string\n\nAlways verify current field support in the PoYo docs before relying on model-specific options.\n\n## Submit Example\n\n```bash\ncurl --fail-with-body --request POST \\\n  --url \"https://api.poyo.ai/api/generate/submit\" \\\n  --header \"Authorization: Bearer YOUR_API_KEY\" \\\n  --header \"Content-Type: application/json\" \\\n  --data '{\n    \"model\": \"get-timestamped-lyrics\",\n    \"callback_url\": \"https://example.com/api/poyo/webhook\",\n    \"input\": {\n      \"task_id\": \"music_task_example\",\n      \"audio_id\": \"audio_track_example\"\n    }\n  }'\n```\n\n## Typical Timing Response\n\n```json\n{\n  \"code\": 200,\n  \"data\": {\n    \"aligned_words\": [\n      {\n        \"word\": \"[Verse]\",\n        \"success\": true,\n        \"start_s\": 1.36,\n        \"end_s\": 1.79\n      }\n    ],\n    \"waveform_data\": [0, 1, 0.5, 0.75],\n    \"is_streamed\": false\n  }\n}\n```\n\n## Status Query Example\n\n```bash\ncurl --fail-with-body --request GET \\\n  --url \"https://api.poyo.ai/api/generate/status/music_task_example\" \\\n  --header \"Authorization: Bearer YOUR_API_KEY\"\n```\n\n## Practical Guidance\n\n- Use a completed source music task id and a matching audio identifier.\n- Preserve lyric timing output exactly when the user needs subtitle, karaoke, or audio visualization workflows.\n- Use `callback_url` for production queues and longer user workflows.\n- Keep private lyrics, task ids, audio identifiers, callback URLs, and waveform data out of logs."},{"path":"skill-card.md","content":"## Description:\n\nRetrieve timestamped lyrics on PoYo / poyo.ai via `https://api.poyo.ai/api/generate/submit`; use for `get-timestamped-lyrics`, synchronized lyrics, word timing, waveform data, task_id plus audio_id inputs, callbacks, and music detail retrieval.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[coolhackboy](https://clawhub.ai/user/coolhackboy)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and engineers use this skill to prepare and submit PoYo get-timestamped-lyrics requests for completed music tracks, then interpret synchronized word timing and waveform responses for subtitles, karaoke, or audio visualization workflows.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill submits request payloads containing task IDs, audio IDs, callback URLs, and related music data to PoYo.\n\nMitigation: Review the JSON payload before submission and send only data that is intended for PoYo.\n\nRisk: The PoYo API key is required for authenticated requests.\n\nMitigation: Store POYO_API_KEY as a server-side secret and avoid exposing it in browser code, public repositories, logs, screenshots, or chat output.\n\n## Reference(s):\n\n- [PoYo Get Timestamped Lyrics API Reference](references/api.md)\n- [PoYo Get Timestamped Lyrics Model Page](https://poyo.ai/models/get-timestamped-lyrics)\n- [PoYo Get Timestamped Lyrics API Documentation](https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics)\n- [PoYo Get Timestamped Lyrics OpenAPI JSON](https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics.json)\n- [ClawHub Skill Page](https://clawhub.ai/coolhackboy/skills/poyo-get-timestamped-lyrics)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Markdown, Code, Shell commands, Configuration]\n\n**Output Format:** [Markdown with JSON payloads and bash code blocks]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include request payloads, curl commands, returned task identifiers, timing response summaries, and next-step retrieval or webhook guidance.]\n\n## Skill Version(s):\n\n1.0.1 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1347,"uniquenessScore":40,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T08:37:52.952Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T08:37:52.952Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T10:51:29.184Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}