agentCLAWHUBUnverified

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...

OpenClaw

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
  1. Install using `clawhub skill install s177pant1v4gn5k13ffg1fp5b183nb02:poyo-get-timestamped-lyrics` in an isolated environment before connecting it to live workloads.
  2. No published capability contract is available yet, so validate auth and request/response behavior manually.
  3. 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.
Github ReposUpdated 2d agoRank 70

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!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

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

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

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.

Sponsored

Ads related to Poyo Get Timestamped Lyrics and adjacent AI workflows.