系列「每天一个高质量 API」第 30 篇。搜蚁智选(souyi.net.cn)是一个面向 AI Agent 的 API 发现与统一调用平台。今天聊 TheCocktailDB 鸡尾酒配方(free-drinks-cocktaildb)。
随机一杯鸡尾酒:名称、类别、配料与调制步骤全给——饮品 / 派对类 Agent 的配方库。
这个 API 能做什么
TheCocktailDB 的 /api/json/v1/1/random.php 随机返回一款酒:idDrink、strDrink、strCategory、strAlcoholic、strGlass、strInstructions。免费档覆盖数千款配方。
为什么 AI Agent 需要它
- 饮品推荐 Agent:用户说「来杯烈的」随机出一款。
- 派对助手:按基酒 / 类别筛选做酒单。
- 图文卡片:配方 + 步骤直接成卡。
怎么用
方式一:直连上游(免费、无需 Key)
curl "https://www.thecocktaildb.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-drinks-cocktaildb","call_data":{}}'
这些免费 API 的上游本身免密;经搜蚁智选代理后,多个数据源可以聚合到同一个 Agent 工作流里,统一走 X-API-Key + 统一计费、限流与可观测,省去每个上游单独接一遍。
返回示例
{
"drinks":[
{"idDrink":"13202","strDrink":"Flaming Dr. Pepper",
"strCategory":"Shot","strAlcoholic":"Alcoholic",
"strGlass":"Collins Glass",
"strInstructions":"Add Amaretto, Bacardi, and vodka. Mix in the Dr. Pepper and beer"}
]
}
价格
免费。免费档数据以 CC BY-SA 授权;平台调用仅记录调用量。
怎么拿到 Key
注册 souyi.net.cn → 控制台一键生成 X-API-Key → 即可调用平台全部 API(含本系列 34 个)。
小结
饮品 Agent 缺的是「有步骤的配方」。TheCocktailDB 随机一款、带配料带做法,接上就能做调酒助手。
下一篇(Day 31):Agify 姓名年龄推测(free-personality-agify)。系列持续更新,关注不迷路。