360 Secure SkillHub
360 安全技能中心

Poyo Get Timestamped Lyrics

该技能对接PoYo的get-timestamped-lyrics API，核心功能是获取带时间戳的同步歌词及波形数据，支持异步任务提交、回调设置与结果查询。典型场景为用户持有PoYo生成音乐的task_id和audio_id，需同步歌词或相关请求协助。输入需task_id、audio_id（可选callback_url），输出包含模型ID、任务标识、参数总结、返回结果及后续操作指引，使用需配置POYO_API_KEY并遵循安全规则。

coolhackboy
coolhackboy
热度 20.87
最近更新 2026-07-09 10:11:48
分类：开发依赖：第三方 API / 代码执行 / 读写文件应用场景：API 集成 / 数据处理

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add poyo-get-timestamped-lyrics
Metadata
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

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 status or wait for webhook