简体中文 | English

Giggle Music

来源: giggle-official/skills · API: giggle.pro

通过 giggle.pro 生成 AI 音乐。支持简化模式与自定义模式。提交任务 → 就绪后查询。无需轮询（polling）或定时任务（Cron）。

API Key: 设置系统环境变量 GIGGLE_API_KEY。请登录 Giggle.pro，在账号设置中获取 API Key。

重要提示: 切勿通过 exec 的 env 参数传入 GIGGLE_API_KEY。API Key 始终从系统环境变量读取。

出错不重试: 若脚本执行发生错误，不得重试。应直接向用户报告错误并终止流程。

交互指南

模式选择（优先级由高到低）

核心规则: 若用户未提供歌词，则始终使用简化模式 A。将用户的原始描述原样作为 --prompt 参数值；不得添加、删减或改写。例如用户输入“女声，1 分钟，古风浪漫”，则直接使用 --prompt "female voice, 1 min, ancient romance"。

信息不足时的引导策略

仅当用户输入极度模糊（例如仅输入“生成音乐”，且无任何描述）时，才向用户提问：

Question: "What type of music would you like to generate?"
Options: AI compose (describe style) / Use my lyrics / Instrumental

执行流程：提交与查询

音乐生成为异步操作（通常耗时 1–3 分钟）。需先提交任务获取 task_id，再在用户需要时进行查询。

步骤 1：提交任务

首先向用户发送一条消息：“音乐生成任务已提交。通常需要 1–3 分钟。您可随时询问进度。”

A：简化模式

python3 scripts/giggle_music_api.py --prompt "user description"

B：自定义模式

python3 scripts/giggle_music_api.py --custom 
  --prompt "lyrics content" 
  --style "pop, ballad" 
  --title "Song Title" 
  --vocal-gender female

C：纯音乐模式

python3 scripts/giggle_music_api.py --prompt "user description" --instrumental

响应示例：

{"status": "started", "task_id": "xxx"}

将 task_id 存入内存（调用 addMemory）：

giggle-generation-music task_id: xxx (submitted: YYYY-MM-DD HH:mm)

步骤 2：用户主动询问时执行查询

当用户询问音乐进度（例如“我的音乐好了吗？”、“进度如何？”），执行：

python3 scripts/giggle_music_api.py --query --task-id 

输出处理规则：

链接返回规则: stdout 中的音频链接必须为完整签名 URL（包含 Policy、Key-Pair-Id、Signature 等查询参数）。正确示例：https://assets.giggle.pro/...?Policy=...&Key-Pair-Id=...&Signature=...。转发时保持原样，不做修改。

恢复机制

当用户询问此前音乐的生成进度时：

1. 内存中存在 task_id → 直接执行 --query --task-id xxx。禁止重新提交任务
2. 内存中无 task_id → 告知用户当前无可用任务 ID，并询问是否需要重新生成

参数参考