Poyo Get Timestamped Lyrics
Retrieve timestamped lyrics on PoYo / poyo.ai via `https://api.poyo.ai/api/generate/submit`; use for `get-timestamped-lyrics`, synchronized lyrics, word timi...
Rank
62
Safety
84
Downloads
1.1k
Updated
Oct 11, 2026
Version
1.0.1
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.1K downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.0.1release · observed Jul 9, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s177pant1v4gn5k13ffg1fp5b183nb02:poyo-get-timestamped-lyrics- 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: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-get-timestamped-lyrics/snapshot"
Documentation
CLAWHUB
17,296 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
---
name: poyo-get-timestamped-lyrics
description: 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.
metadata: {"openclaw":{"homepage":"https://poyo.ai/models/get-timestamped-lyrics","requires":{"bins":["curl"],"env":["POYO_API_KEY"]},"primaryEnv":"POYO_API_KEY"}}
---
# PoYo Get Timestamped Lyrics
## PoYo Links
- Model page: <https://poyo.ai/models/get-timestamped-lyrics>
- API docs: <https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics>
- API key page: <https://poyo.ai/dashboard/api-key>
Use 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.
## Use When
- The user explicitly wants timestamped or synchronized lyrics for a PoYo-generated music track.
- 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.
- The user has already chosen PoYo as the execution provider for a lyrics timing workflow.
## Model Selection
- `get-timestamped-lyrics`: use for retrieving lyric timing and waveform data from a generated music track.
## Key Inputs
- `task_id` identifies the completed source music generation task.
- `audio_id` identifies the specific audio track.
- `callback_url` is optional and useful for production queues.
## Security Rules
- Treat `POYO_API_KEY` as a secret.
- Keep PoYo API keys in server-side environment variables or a backend secret manager.
- Never place an API key in browser code, frontend bundles, public repositories, logs, screenshots, or chat output.
- Do not log private lyrics, customer task ids, audio identifiers, waveform data, callback URLs, or raw authorization headers unless the product policy allows it.
- Do not use this skill for generic lyric analysis unless the user explicitly wants a PoYo Get Timestamped Lyrics API workflow.
- 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.
## Execution
- Read `references/api.md` for endpoint details, request fields, examples, and result retrieval notes.
- Use `scripts/submit_get_timestamped_lyrics.sh` only when the user wants to submit a prepared JSON payload from a trusted shell.
- If the user only needs a curl example, adapt one from `references/api.md`.
- After submission, report the returned `task_id` or timing response clearly so follow-up retrieval is easy.
## Output Expectations
When helping with Get Timestamped Lyrics, include:
- chosen model id
- source task and audio identifier summary
- final payload or concise parameter summary
- returned `task_id` or timing response if a request was actually submitted
- next step: query s_meta.json
{
"ownerId": "kn7f14qr8xdf5gs6pr7cm7p97h82m349",
"slug": "poyo-get-timestamped-lyrics",
"version": "1.0.1",
"publishedAt": 1783563108973
}references/api.md
# PoYo Get Timestamped Lyrics API Reference
## Endpoint
- Submit task: `POST https://api.poyo.ai/api/generate/submit`
- Status query: `GET https://api.poyo.ai/api/generate/status/{task_id}`
- Source docs: <https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics>
- OpenAPI JSON: <https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics.json>
- Model page: <https://poyo.ai/models/get-timestamped-lyrics>
## Auth
Send:
```http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```
Get API keys from <https://poyo.ai/dashboard/api-key>.
Recommended skill env var:
- `POYO_API_KEY`
## Model
- `get-timestamped-lyrics`: retrieve synchronized lyrics and timing data for a generated music track.
## Request Schema
Top-level fields:
- `model` string, required
- `callback_url` string URI, optional
- `input` object, required
Required `input` fields:
- `task_id` string
- `audio_id` string
Always verify current field support in the PoYo docs before relying on model-specific options.
## Submit Example
```bash
curl --fail-with-body --request POST \
--url "https://api.poyo.ai/api/generate/submit" \
--header "Authorization: Bearer YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "get-timestamped-lyrics",
"callback_url": "https://example.com/api/poyo/webhook",
"input": {
"task_id": "music_task_example",
"audio_id": "audio_track_example"
}
}'
```
## Typical Timing Response
```json
{
"code": 200,
"data": {
"aligned_words": [
{
"word": "[Verse]",
"success": true,
"start_s": 1.36,
"end_s": 1.79
}
],
"waveform_data": [0, 1, 0.5, 0.75],
"is_streamed": false
}
}
```
## Status Query Example
```bash
curl --fail-with-body --request GET \
--url "https://api.poyo.ai/api/generate/status/music_task_example" \
--header "Authorization: Bearer YOUR_API_KEY"
```
## Practical Guidance
- Use a completed source music task id and a matching audio identifier.
- Preserve lyric timing output exactly when the user needs subtitle, karaoke, or audio visualization workflows.
- Use `callback_url` for production queues and longer user workflows.
- Keep private lyrics, task ids, audio identifiers, callback URLs, and waveform data out of logs.skill-card.md
## Description: 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. This skill is ready for commercial/non-commercial use. ## Publisher: [coolhackboy](https://clawhub.ai/user/coolhackboy) ### License/Terms of Use: MIT-0 ## Use Case: Developers 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. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: The skill submits request payloads containing task IDs, audio IDs, callback URLs, and related music data to PoYo. Mitigation: Review the JSON payload before submission and send only data that is intended for PoYo. Risk: The PoYo API key is required for authenticated requests. Mitigation: Store POYO_API_KEY as a server-side secret and avoid exposing it in browser code, public repositories, logs, screenshots, or chat output. ## Reference(s): - [PoYo Get Timestamped Lyrics API Reference](references/api.md) - [PoYo Get Timestamped Lyrics Model Page](https://poyo.ai/models/get-timestamped-lyrics) - [PoYo Get Timestamped Lyrics API Documentation](https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics) - [PoYo Get Timestamped Lyrics OpenAPI JSON](https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics.json) - [ClawHub Skill Page](https://clawhub.ai/coolhackboy/skills/poyo-get-timestamped-lyrics) ## Skill Output: **Output Type(s):** [Guidance, Markdown, Code, Shell commands, Configuration] **Output Format:** [Markdown with JSON payloads and bash code blocks] **Output Parameters:** [1D] **Other Properties Related to Output:** [May include request payloads, curl commands, returned task identifiers, timing response summaries, and next-step retrieval or webhook guidance.] ## Skill Version(s): 1.0.1 (source: server release evidence) ## Ethical Considerations: Users 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.
AionUi
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!
activepieces
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
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/coolhackboy/skills/poyo-get-timestamped-lyrics",
"sourceUrl": "https://clawhub.ai/coolhackboy/skills/poyo-get-timestamped-lyrics",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T08:37:52.952Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-get-timestamped-lyrics/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-get-timestamped-lyrics/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T08:37:52.952Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.1K downloads",
"href": "https://clawhub.ai/coolhackboy/poyo-get-timestamped-lyrics",
"sourceUrl": "https://clawhub.ai/coolhackboy/poyo-get-timestamped-lyrics",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T08:37:52.952Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.1",
"href": "https://clawhub.ai/coolhackboy/poyo-get-timestamped-lyrics",
"sourceUrl": "https://clawhub.ai/coolhackboy/poyo-get-timestamped-lyrics",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-07-09T02:11:48.973Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-get-timestamped-lyrics/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-coolhackboy-poyo-get-timestamped-lyrics/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.1",
"description": "Retry security scan and indexing",
"href": "https://clawhub.ai/coolhackboy/poyo-get-timestamped-lyrics",
"sourceUrl": "https://clawhub.ai/coolhackboy/poyo-get-timestamped-lyrics",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-07-09T02:11:48.973Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.
