系列「每天一个高质量 API」第 26 篇。搜蚁智选(souyi.net.cn)是一个面向 AI Agent 的 API 发现与统一调用平台。今天聊 TheMealDB 随机食谱(free-meal-themealdb)。
想要一道菜的做法?TheMealDB 随机返回菜名、分类、产地、配料与详细步骤——美食 Agent 的食材库。
这个 API 能做什么
TheMealDB 的 /api/json/v1/1/random.php 随机返回一道菜:idMeal、strMeal、strCategory、strArea、strInstructions(做法)、strMealThumb(配图)。免费档覆盖数千道菜谱。
为什么 AI Agent 需要它
- 美食 / 烹饪 Agent:用户说「今天做什么菜」随机出一道。
- 健康饮食:按分类 / 产地筛选,做膳食建议。
- 图文卡片:strMealThumb 直接当配图。
怎么用
方式一:直连上游(免费、无需 Key)
curl "https://www.themealdb.com/api/json/v1/1/random.php"
方式二:经搜蚁智选一键调用(带 Key,统一计费 / 限流 / 可观测)
curl -X POST https://souyi.net.cn/api/v1/ai/request \
-H "X-API-Key: YOUR_AIMALL_KEY" \
-H "Content-Type: application/json" \
-d '{"asset_id":"free-meal-themealdb","call_data":{}}'
这些免费 API 的上游本身免密;经搜蚁智选代理后,多个数据源可以聚合到同一个 Agent 工作流里,统一走 X-API-Key + 统一计费、限流与可观测,省去每个上游单独接一遍。
返回示例
{
"meals":[
{"idMeal":"53260","strMeal":"Slow-roast lamb with cinnamon, fennel & citrus",
"strCategory":"Lamb","strArea":"Turkish",
"strInstructions":"Put the lamb into a large food bag with all the juice..."}
]
}
价格
免费。免费档数据以 CC BY-SA 授权;平台调用仅记录调用量。
怎么拿到 Key
注册 souyi.net.cn → 控制台一键生成 X-API-Key → 即可调用平台全部 API(含本系列 34 个)。
小结
美食类 Agent 最缺的是「有做法的菜」。TheMealDB 随机一道、带步骤带图,接上就能做每日菜谱。
下一篇(Day 27):PokeAPI 宝可梦数据(free-games-pokeapi)。系列持续更新,关注不迷路。