← 返回首页进入画布 →

Skill 使用说明

一行指令，让草料屋进入你的 Agent 工作流。官方 Skill（platform）让 AI 助手通过平台开放 API 完成创作生成、项目画布管理与账户查询，无需打开网页即可调用平台能力。

安装 Skill

方式一：通过 AI 助手安装（推荐）

将下面这段话直接发给你的 AI 助手（Claude Code / Claw、Qoder、Trae、通义灵码等）， 它会自动完成下载、安装和初始化：

请帮我安装（或更新）Platform Skill：https://www.caoliaowu.com/downloads/platform-skill.zip
下载后解压到 skills 目录（如项目内 .agents/skills/，若已存在则覆盖），并读取其中的 SKILL.md 完成初始化。

方式二：手动安装

  1. 下载 Skill 安装包：⬇ platform-skill.zip
  2. 解压到 AI 助手的 skills 目录：
    # 项目内安装
unzip platform-skill.zip -d <你的项目>/.agents/skills/
  3. 重启 AI 助手即可识别 platform skill。

更新 Skill

更新方式与安装相同：重新执行上方一键安装提示词，或重新下载最新安装包覆盖解压到原目录即可。 覆盖安装不会影响已配置的 PLATFORM_API_KEY。当前最新版本：v1.3.0（可查看安装目录下 SKILL.md 头部的 version 字段确认本地版本）。

配置 API Key

  1. 登录平台后进入 账号中心 → 「API Keys」创建 Key（ptk_ 前缀），完整内容仅显示一次，请立即复制保存。
  2. 配置环境变量（写入 ~/.zshrc 或 ~/.bashrc）：
    export PLATFORM_API_KEY="ptk_xxxxxxxx"
# 服务地址默认指向官方站点 https://www.caoliaowu.com，无需额外配置

开始使用

配置完成后，直接用自然语言告诉 AI 助手你要做什么，助手会自动路由到对应命令，例如：

💬 「用草料屋查我的余额」

提示词中显式点名「草料屋」可 100% 命中本 Skill，匹配不中时的保底写法。

💬 「帮我生成一张赛博朋克城市夜景图」

自动调用文生图，可追加 --wait 等待完成并返回结果链接。

💬 「查一下我的平台余额」

调用账户查询，返回积分余额与个人信息。

💬 「用 kling-v2 把这张图生成视频」

自动走图生视频流程，生成前可先让它报价确认。

能力一览

🎨 generate · AI 生成

文生图、图生图、九宫格 / 三联画批量生图、图片放大 / 扩图 / 裁剪、图转文、 文生视频、图生视频、分镜拆分、视频剪辑加工（去字幕 / 提取音频 / 静音 / 变速 / 转码），以及报价查询、任务状态、生成历史与解锁待支付结果。

🗂 project · 项目与画布

项目列表 / 详情 / 创建 / 更新 / 删除、项目素材查询、项目分享链接管理， 以及查看 / 复制他人分享的项目。

💳 account · 账户管理

余额与积分查询、余额流水、充值发票、邀请码、昵称 / 头像修改、改密与全端登出， 以及 API Key 的创建与吊销。

🧭 model · 模型与套餐

查询平台可用模型列表与详情，以及充值套餐价格展示（仅查询，不支持下单）。

🔔 notify · 站内通知

未读通知数量、通知列表查询与标记已读 / 全部已读。

命令速查

使用意图命令
查询某模型生成价格 / 积分消耗generate quote --model <model>
查看可用模型 / 充值套餐model list | get <modelId> | packages
文生图 / 图生图generate image --model <model> --prompt "..." [--image-url <url> | --file <path>] [--wait]
文生视频 / 图生视频generate video --model <model> --prompt "..." [--image-url <url> | --file <path>] [--wait]
九宫格批量生图（一次 9 张）generate grid --model <model> --prompt "..."
三联画批量生图（一次 3 张）generate triptych --model <model> --prompt "..." [--image-url <url> | --file <path>]
图片放大 / 扩图 / 裁剪 / 局部重绘generate image-op --operation <upscale|outpaint|crop|inpaint> (--image-url <url> | --file <path>)
图片内容描述（图转文）generate text (--image-url <url> | --file <path>)
查询生成任务进度 / 获取结果generate status <id> [--wait]
查看历史生成记录generate history
解锁余额不足被挂起的生成结果generate unlock <generationId>
视频剪辑 / 去字幕 / 提取音频 / 静音 / 变速 / 转码generate video-edit --task-type <TRIM|CROP|REMOVE_SUBTITLES|EXTRACT_AUDIO|FORMAT_CONVERT|SPEED_CHANGE|MUTE> (--video-url <url> | --video-file <path>) [--params '<json>'] [--wait]
查询视频加工任务列表 / 进度generate video-task <id> [--wait] | --list [--status <status>]
故事拆分镜generate storyboard --story "..." [--shot-count N] [--style 风格]
项目列表 / 详情 / 创建 / 更新 / 删除 / 素材 / 分享project list | get | create | update | delete | assets | share
查看 / 复制他人分享的项目project shared-get <id> | shared-copy <id>
余额 / 积分 / 个人信息account me
余额流水 / 充值发票account transactions | invoices
我的邀请码account invite-code
修改昵称 / 头像account profile-update --name "..." [--image-url <url> | --avatar-file <path>]
未读通知 / 通知列表 / 标记已读notify unread | list | read <id> | read-all
管理 API Keysaccount keys | key-create | key-revoke

常用参数：--count（1 / 2 / 4）、--quality、 --duration-seconds、--aspect-ratio 同时影响报价与生成； --project-id 可将结果关联到项目画布； --wait 提交后轮询到终态；--image-url 可重复传入实现多图引用；--file 直接传本地图片，--source-video-file 直接传本地视频（自动上传）。

使用示例

# 查询报价（不扣费）
platform generate quote --model nano-banana --count 2

# 文生图并等待完成
platform generate image --model nano-banana --prompt "赛博朋克城市夜景" --wait

# 本地图片图生视频并等待完成
platform generate video --model kling-v2 --prompt "镜头缓慢推进" \
  --file ./cover.jpg --wait

# 九宫格批量生图
platform generate grid --model nano-banana --prompt "水彩风格森林小屋"

# 分镜拆分
platform generate storyboard --story "一只猫穿越城市的冒险" --shot-count 8

# 余额查询 / 未读通知
platform account me
platform notify unread

注意事项

生成类操作（图片 / 视频 / 批量生图 / 图片编辑 / 图转文 / 视频加工 / 分镜）会消耗积分计费， 建议先用 quote 查询报价确认后再提交。
项目删除、Key 吊销、修改密码、全端登出等为破坏性操作，执行前请务必确认。
生成结果 URL 通常为带签名的临时链接，请及时下载保存。
出现「需要登录」或 401 错误时，请检查 API Key 是否有效（可能已吊销或过期）， 可在账户中心重新创建。