TTAPI Skill 将重复操作整理为项目工作流。在示例中,Codex 读取 ttapi-suno,用 chirp-v6 提交一个任务,取回两份 MP3,接入项目的 Suno 播放器并检查播放。
TTAPI Skills 在 Codex 里做什么
TTAPI Skills 给可操作终端、文件和网页文档的编程智能体提供项目指引。ttapi-suno 说明如何检查项目、阅读当前 API 文档、提交异步任务、取回结果并保存音频。
Skill 组织流程,Suno 是音乐产品,chirp-v6 是请求里填写的模型。安装时不会生成音乐,实际生成按所选操作扣除 TTAPI 余额。
- 确认客户端支持 Skills,且可访问项目终端
- 只安装项目需要的 Skill
- 密钥留在智能体使用的本地环境
为歌曲创作选择 ttapi-suno
本例需要明确风格、节奏和模型的短歌曲,因此选择 ttapi-suno。同一个 Skill 也支持纯音乐、歌词、翻唱和音轨操作,请求字段随操作而变。
第一次只给 Codex 一个创意要求、一款模型和一个输出目录,方便验证流程。
| 输入 | 示例 |
|---|---|
| Skill | ttapi-suno |
| 模型 | chirp-v6 |
| 输出 | 一次生成返回两份 MP3 |
下方示例演示从提交一条 Suno 请求到保存音频的过程。
在项目里安装 ttapi-suno
从项目目录运行安装命令,再让智能体确认 Skill 名称和安装路径。此步骤只准备工作流,不发送音乐请求或扣生成额度。
可以请 Codex 用英文报告安装位置和支持的操作。
npx skills add ttapi-io/ttapi-skills --skill ttapi-suno- 在目标项目目录执行命令
- 开始生成前确认 Skill 文件的路径
- 检查安装过程中不发起付费任务
在本地设置 TTAPI_API_KEY
将密钥设在启动 Codex、Claude Code、Cursor 或 Gemini CLI 的同一个终端或命令环境中。不要将真实密钥放进对话或代码。
让 Codex 只报告已配置或未配置。本地检查不会验证余额,也不需要发送请求。
# PowerShell
$taskKey = Read-Host 'TTAPI API key' -AsSecureString
$env:TTAPI_API_KEY = [System.Net.NetworkCredential]::new('', $taskKey).Password
Remove-Variable taskKey
# Bash
read -rsp 'TTAPI API key: ' TTAPI_API_KEY
export TTAPI_API_KEY
printf '\n'- 使用隐藏的终端输入或客户端环境变量设置
- 设置后再启动智能体
- 不要把真实密钥放进截图、日志、提交和提示词
给 Codex 一段英文音乐需求
用下方提示词请 Codex 执行一项任务:通过 ttapi-suno 生成短歌曲,保存两个版本,并在项目的 Suno 播放器中验证。
只提交一次生成,保存任务 ID,便于等待过久时查询原任务。
Use the installed ttapi-suno Skill to create a short cinematic electronic-soul song with warm Rhodes piano, deep bass and low male vocals. Use chirp-v6. Read the TTAPI docs, submit one task, save both MP3 results and add them to this project's Suno player. Verify playback. Reply in English and keep the API key private.
确认只提交一个 Suno 任务
Codex 的简短回复只需列出 Skill、模型、接口、状态与下一步。截图里不应显示密钥。
任务是异步的,提交后应查询现有任务。
- Skill:ttapi-suno
- 模型:chirp-v6
- 接口:/suno/v1/music
- 状态:已提交
试听保存的 MP3
示例中的一项任务完成后返回了两份 MP3。可以播放下方第一份结果,确认是否合适。
- 一个任务返回两份 MP3
- 播放器由用户主动点击后播放
- 在产品中使用前先试听