跳到安装步骤

Agent Skills

让智能体
为项目创作

直接在项目中生成和编辑图像、视频与音乐。有 16 个产品 Skill 可选,由智能体完成操作流程。

安装免费,生成内容会扣除 TTAPI 账户余额。

查看 8 个图像、6 个视频和 2 个音乐 Skill
提示词

为街头服饰制作一张宣传图,配上标语「Yours to Create」。

可以开始创作
OpenAI Image 生成的街头服饰宣传图
TTAPI 展示样例OpenAI Image使用 Skill 生成自己的素材
  • 图像8 个产品 Skill
  • 视频6 个产品 Skill
  • 音乐2 个产品 Skill

支持的功能

你的智能体可以做什么

用编程智能体为项目制作图像、视频和音乐。Skills 提供操作流程,API 文档列出可用模型、请求参数和支持的操作。

01

模型与 API 文档

调用前查看 TTAPI 文档,确认可用模型和请求参数。

查看 API 文档
02

图像生成

生成商品图、插画和网站素材。部分产品支持编辑、融合或重新设计图像纹理。

查看 8 个图像 Skill
03

视频生成

用提示词或图像生成视频,按产品支持的功能进行续写或编辑,并跟踪任务、将结果保存到项目。

查看 6 个视频 Skill
04

音乐生成

生成歌曲、纯音乐和歌词。支持时,还可续写、翻唱或分离音轨。

查看 2 个音乐 Skill

为项目生成素材

选好产品并安装对应的 Skill,配置 TTAPI 密钥,再告诉智能体要制作什么素材、用在项目的哪里。

开始前,请准备支持 Skills 且可访问项目、终端和网络的智能体、运行安装程序所需的 Node.js 22.20 或更高版本,以及 TTAPI API 密钥。

01

选择并安装 Skill

勾选需要的产品,再任选一种安装方式。

图像 8
视频 6
音乐 2
已选择 3 个 Skill
方式 A 通过智能体对话

打开项目后,将提示词粘贴到智能体对话中。

从 https://github.com/ttapi-io/ttapi-skills 安装 ttapi-openai-imagettapi-wan-videottapi-suno 到这个项目,并为我正在使用的客户端配置。检查已安装的文件并报告路径。通过 https://docs.ttapi.io/llms.txt 查阅相关 API 文档。安装时不要生成素材。

Skill 文件来自 GitHub。llms.txt 帮助智能体找到对应的 API 文档。

方式 B 在项目终端中安装

在项目目录执行命令,再在安装器中选择你使用的客户端。

npx skills add ttapi-io/ttapi-skills --skill ttapi-openai-image ttapi-wan-video ttapi-suno

两种方式安装的 Skill 相同,选一种即可。

生成素材前,请让智能体确认已安装的 Skill 名称和文件路径。
02

配置 API 密钥

在本地设置密钥,再检查智能体能否读取。

在本地终端或客户端设置中操作

获取密钥后,在智能体运行脚本的环境中设置 TTAPI_API_KEY。请在本地输入密钥,避免发到对话中。

获取 API 密钥
  • 终端智能体:设置密钥后,在同一终端运行 codex、claude、agent 或 gemini。
  • Cursor 编辑器:使用 Agent 模式,并确保其命令环境可读取密钥。

在智能体对话中检查配置

检查用于运行 TTAPI 脚本的环境中是否设置了非空的 TTAPI_API_KEY。只报告已配置或未配置,不要输出密钥。如果未配置,请说明如何在当前客户端本地设置。不要发起 API 请求。

此检查只确认智能体能否读取密钥,不验证密钥是否有效,也不查询余额。

03

生成素材并添加到项目

选择一个产品,按项目需要改写示例。智能体会查阅文档、生成素材,并把素材添加到项目中。

OpenAI Image 生成的街头服饰宣传图OpenAI Image · TTAPI 展示样例 放大查看
ttapi-openai-image
第 1 步已勾选此 Skill,请先完成安装再生成素材。

粘贴到项目的智能体对话中

先检查当前项目。提交前通过 https://docs.ttapi.io/llms.txt 查阅相关 API 文档,然后用 ttapi-openai-image 和 GPT Image 2 制作一张街头服饰宣传图,标语为「Yours to Create」。将结果保存到现有素材目录,在合适的页面引用并检查效果。

智能体会完成哪些操作

检查项目,并阅读相关 API 文档。 使用本地密钥生成图像,保存到项目中,在合适的页面引用并检查效果。

安装和本地密钥检查不消耗 TTAPI 额度。生成素材时,费用会从 TTAPI 余额扣除。查看安装指南

常见问题

开始前常见的问题

需要安装全部 16 个产品 Skill 吗?

只需安装项目用得到的 Skill。目录有 8 个图像、6 个视频和 2 个音乐 Skill,每个产品 Skill 可以包含多款模型或多个版本。以后需要其他产品时,可以回来勾选并生成安装提示词。

已经在用 ttapi-image、ttapi-video 或 ttapi-audio,还需要安装吗?

原有的综合 Skill 可以继续使用,但它们未覆盖全部新增产品。需要新产品或流程时再安装对应的 Skill。同一流程无需同时安装综合 Skill 和产品 Skill。

安装会消耗额度吗?

安装和阅读 Skills 不收费。生成或编辑素材会扣除 TTAPI 余额,费用取决于模型和具体操作,请在生成前查看当前价格。

生成的文件保存在哪里?

告诉智能体要把结果下载到哪个项目目录,并让它返回保存路径。视频和音乐任务请保留任务 ID,便于之后取回同一结果。

生成任务等待超时怎么办?

等待超时后,任务可能仍在运行。请让智能体用已保存的任务 ID 继续查询。如果提交时没有返回 ID,先到 TTAPI 控制台确认任务状态,再决定是否重新生成。