下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/showapi--michelin-chef-cooking-guide-showapi.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @showapi/michelin-chef-cooking-guide-showapi。以米其林大厨身份根据菜品名称与要求生成专业分步烹饪指导、核心注意事项、多宫格图文步骤展示图及TTS语音播报;适用于家庭烹饪教学、菜谱学习、美食自媒体内容创作、视听结合烹饪指导场景
阅读全文 (展开查看完整说明)
概述
米其林大厨教你做菜
任务目标
- 以米其林大厨视角,根据用户输入的菜品名称和要求,生成专业的分步烹饪指导及注意事项
- 智能生成多宫格图文步骤展示图,并合成一段注意事项的TTS语音播报,提供视听双管齐下的专业烹饪指导
- 触发场景:学做菜查菜谱、烹饪教学辅助、美食自媒体内容创作、家庭厨房进阶练习
能力组成
能力流程描述
该技能以用户输入的菜品名称 cuisine(必填,如"横县鱼生")与对菜品的要求 request(选填,如口味偏好、器具条件、难度期望)为起点,完整执行链路如下:
- 合规校验优化:对用户输入进行合规性校验与优化,保障生成内容安全合规;
- 生成米其林级别菜谱:以米其林大厨身份,结合菜品名称与用户要求,生成专业的分步烹饪指导(含步骤序号、步骤标题、步骤描述)与核心注意事项详情;
- 双线并行生成:
- 语音线:将注意事项精简为口语化TTS脚本 → 启动TTS语音合成任务(音色 tongtong、语速 1倍、模型 glm-tts)→ 轮询TTS语音生成状态直至成功;
- 图文线:基于菜谱步骤构建多宫格图文生图Prompt → 启动多宫格图文生成任务(画面比例 1:1)→ 轮询图文生成状态直至成功;
- 结果汇总输出:整合菜品名称、烹饪步骤列表、注意事项、多宫格图文步骤展示图URL、注意事项语音播报URL 五类交付物。
整个流程为异步自动执行:用户提交任务后获得唯一 task_id,通过轮询查询直至任务完成,一次性获得全部结果。
技能能力组成流程图
flowchart TD
A["用户输入: 菜品名称cuisine(必填) + 要求request(选填)"] --> B["合规校验优化"]
B --> C["生成米其林级别菜谱步骤与注意事项"]
C --> D["生成精简口语化TTS脚本"]
C --> E["构建多宫格图文生图Prompt"]
D --> F["启动TTS语音合成任务<br/>(tongtong音色/1倍速/glm-tts)"]
E --> G["启动多宫格图文生成任务<br/>(比例1:1)"]
F --> H["轮询TTS语音生成状态"]
G --> I["轮询图文生成状态"]
H --> J["汇总输出: cuisine + steps + cautions + image_url + audio_url"]
I --> J前置准备
- 凭证:配置 ShowAPI AppKey,凭证名称:showapi_appkey
- 鉴权配置:
本 Skill 调用需要 AppKey 鉴权。所有 API 请求的 URL 查询参数中需携带 appKey={你的AppKey}。
如何获取 AppKey
如果你还没有 AppKey,请按以下步骤通过手机验证获取:
- 请用户提供手机号(中国大陆手机号)
- 调用发送验证码接口:
“` POST https://www.showapi.com/auth/agent_sendCode Content-Type: application/x-www-form-urlencoded
phone={手机号} “ 成功响应:{"flag":true,"remark":"发送成功"}`
- 请用户查看手机收到的6位验证码并告诉你
- 调用验证接口获取 AppKey:
“` POST https://www.showapi.com/auth/agent_verify Content-Type: application/x-www-form-urlencoded
phone={手机号}&code={验证码} “ 成功响应:{"flag":true,"app_key":"你的AppKey"}`
- 将获取到的 app_key 保存,后续所有 API 调用 URL 中携带
appKey={app_key}参数
注意事项
- 验证码5分钟有效,每分钟只能发送1次
- 如果手机号已注册过易源数据平台账户,会直接返回该账户的 AppKey,不会重复注册
- AppKey 获取后请妥善保存,避免重复验证
- 模拟体验:无 appKey 时,系统自动触发模拟调用,直接返回完整结果,快速预览生成效果
- 调用费用:约 0.25 元/次(含模型推理价格)
- 依赖:仅使用 Python 标准库,无需安装第三方包
操作步骤
模拟体验流程(无 appKey)
- 自动触发模拟调用
系统检测到未配置 appKey 时,自动向 https://www.showapi.com/_nuxt3/api/2405-105 发送 POST 请求(body: {"flow_id":"6a87b6613c51f20e38016da8"}),直接获取完整模拟生成结果。此过程为一次性返回,不执行 execute_task.py 和 query_task.py。
- 可视化预览
将返回的 JSON 结果以 HTML 形式可视化展示,重点呈现多宫格图文步骤展示图与语音播报链接。
- 引导真实调用
提示用户当前为无 appKey 的模拟运行结果。如需真实调用,请通过手机验证获取 AppKey(步骤见「前置准备-鉴权配置」),并在后续所有 API 调用 URL 中携带 appKey={app_key} 参数。
标准流程(有 appKey,强制异步执行)
- 收集用户需求
确认菜品名称(必填,如"横县鱼生")与对菜品的要求(选填,如口味偏好、家庭器具条件、难度期望等)。
- 异步提交生成任务
调用脚本异步执行菜谱步骤、图文展示图、语音播报生成任务,仅返回唯一 task_id,不阻塞等待。调用示例:
python scripts/execute_task.py --cuisine "横县鱼生" --request "希望做出餐厅级别的口感,家庭厨房条件下操作" --async- 轮询查询任务结果(必选)
使用 task_id 循环查询任务状态,每一轮轮询后,即时将当前返回的核心资料同步反馈给用户,直至获取完整结果。调用示例:
python scripts/query_task.py --task-id "返回的task_id值"- 等待结果完成
必须轮询直到完成(图文与语音合成通常需要1~3分钟,建议每5秒查询一次)。
- 结果解析与落地应用
提取菜谱步骤列表、注意事项、多宫格图文步骤展示图URL与语音播报URL,用于烹饪学习、教学展示或美食内容创作。
- 生成html页面
生成一个简单的html页面来融合返回的主要信息,特别是图片与语音播放控件。
使用示例
示例1:家庭烹饪教学
- 输入:菜品名称"红烧肉",要求"家庭厨房条件,偏甜口"
- 流程:异步提交任务 → 获取task_id → 轮询查询(每轮反馈进度/数据)
- 产出:米其林级分步烹饪指导+注意事项+多宫格图文展示图+语音播报
- 配置要点:cuisine 必填;request 可描述口味、器具、火候等偏好
示例2:地方特色菜谱学习
- 输入:菜品名称"横县鱼生"
- 流程:异步提交任务 → 获取task_id → 轮询查询(每轮反馈进度/数据)
- 产出:地方名菜的米其林标准专业做法与全套视听指导材料
- 配置要点:request 可不填,默认按米其林大厨标准做法生成
示例3:美食自媒体内容创作
- 输入:菜品名称"惠灵顿牛排",要求"步骤讲解适合拆成短视频分镜脚本"
- 流程:异步提交任务 → 获取task_id → 轮询查询(每轮反馈进度/数据)
- 产出:多宫格图文步骤图可作分镜素材,语音播报可作配音参考
- 配置要点:在 request 中说明内容用途与风格,获得更贴合创作的输出
生成效果示例
描述
技能运行后输出五类结构化交付物:
- cuisine(菜品名称):本次生成菜谱对应的菜品名称;
- steps(烹饪步骤):以米其林大厨视角生成的分步烹饪指导数组,每个步骤包含 step_number(步骤序号)、title(步骤标题)、description(步骤描述);
- cautions(注意事项):烹饪过程中的核心注意事项详情文本;
- image_url(图文步骤展示图):包含4~9宫格的图文步骤展示图URL,每格对应一个关键操作步骤的画面;
- audio_url(语音播报):注意事项TTS语音播报文件URL,可直接在线播放收听。
可视化呈现方式:多宫格图文展示图以"一图多格"形式直观呈现每一步操作要点;语音播报以音频形式讲解注意事项,实现"看图学步骤、听音记要点"的视听结合体验。
输出案例
说明:若输出结果包含图片,优先插入对应图片资源,之后再输出 JSON / Markdown 格式的文本内容。
多宫格图文步骤展示图效果:
接口返回数据示例(以"横县鱼生"为例):
{
"showapi_res_body": {
"task_status": "SUCCEEDED",
"result": {
"cuisine": "横县鱼生",
"steps": [
{
"step_number": 1,
"title": "选鱼与放血",
"description": "选用鲜活河鱼,宰杀后立即放血、去鳞、去内脏,从鱼背下刀取整片净肉,保证鱼肉洁白无腥味。"
},
{
"step_number": 2,
"title": "鱼片切制",
"description": "以精湛刀工将鱼肉切成约1毫米的透明薄片,整齐铺于垫冰的盘中,保持爽脆弹嫩的口感。"
}
],
"cautions": "1. 食材必须绝对新鲜,建议活鱼现杀;2. 刀具与砧板全程严格消毒;3. 捞汁配料需提前切细备用,避免延误鱼片最佳风味……",
"image_url": "https://oss.showapi.com/workflow/6a13a91c9e64f2c7637a7564/6a87b6613c51f20e38016da8/snapshot/caseImgs/d8e078054c.png",
"audio_url": "https://oss.showapi.com/…/cautions_tts.mp3"
}
},
"showapi_res_code": 0,
"showapi_fee_num": 1
}资源索引
- [scripts/execute_task.py](scripts/execute_task.py):异步提交菜谱、图文、语音生成任务(真实调用时使用)
- [scripts/query_task.py](scripts/query_task.py):轮询查询异步任务结果(真实调用时使用)
响应数据结构
1. 异步任务提交响应
{
"showapi_res_body": {
"task_id": "唯一任务ID",
"status": "pending",
"msg": "任务已提交,正在异步处理中"
},
"showapi_res_code": 0,
"showapi_fee_num": 1
}2. 任务查询响应(单轮轮询返回数据,需实时同步给用户)
处理中示例:
{
"showapi_res_body": {
"task_status": "RUNNING",
"msg": "任务处理中,请继续轮询",
"result": null
},
"showapi_res_code": 0,
"showapi_fee_num": 1
}完成示例:
{
"showapi_res_body": {
"task_status": "SUCCEEDED",
"result": {
"cuisine": "菜品名称",
"steps": [
{
"step_number": 1,
"title": "步骤标题",
"description": "步骤描述"
}
],
"cautions": "烹饪过程中的核心注意事项详情",
"image_url": "多宫格图文步骤展示图URL",
"audio_url": "注意事项语音播报URL"
}
},
"showapi_res_code": 0,
"showapi_fee_num": 1
}注意事项
- cuisine(菜品名称)为必填项;request(对菜品的要求)为选填项,建议描述口味、器具、难度等偏好以获得更精准的结果。
- 所有任务强制异步执行,不支持同步模式。
- 轮询查询过程中,每次获取接口返回数据后,立即将主要内容反馈给用户。
- 图文与语音合成需要一定时间(通常1~3分钟),请耐心轮询,建议查询间隔5秒。
- 生成的步骤与注意事项仅作烹饪参考,制作生食类菜品时请务必注意食品安全与卫生。
- 模拟运行说明:无 appKey 时系统自动触发模拟调用,一次性返回完整 JSON 结果,不经过 execute_task.py 和 query_task.py,结果仅作效果预览,非真实生成内容。如需真实调用,请通过手机验证获取 AppKey 并配置。