系列「每天一个高质量 API」第 34 篇。搜蚁智选(souyi.net.cn)是一个面向 AI Agent 的 API 发现与统一调用平台。今天聊 Dog CEO 随机狗狗图(free-dog-ceo)。
想要一张随机狗狗图?Dog CEO 返回图片 URL——演示「图像型 API 如何进 Agent」最轻松的例子。
这个 API 能做什么
Dog CEO 的 /api/breeds/image/random 返回随机狗狗图的直链:message(图片 URL)、status。零参数、零密钥,返回的是图片地址而非 JSON 数据,适合演示图像型接口的接线方式。
为什么 AI Agent 需要它
- 图像 Agent 演示:拿 URL 直接喂下游图像识别 / 配图。
- 趣味互动:「来张狗狗图」这类彩蛋。
- 教学样本:展示非 JSON(二进制 / URL)型 API 的处理。
怎么用
方式一:直连上游(免费、无需 Key)
curl "https://dog.ceo/api/breeds/image/random"
方式二:经搜蚁智选一键调用(带 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-dog-ceo","call_data":{}}'
这些免费 API 的上游本身免密;经搜蚁智选代理后,多个数据源可以聚合到同一个 Agent 工作流里,统一走 X-API-Key + 统一计费、限流与可观测,省去每个上游单独接一遍。
返回示例
{
"message": "https://images.dog.ceo/breeds/waterdog-spanish/20190208_063211.jpg",
"status": "success"
}
价格
免费。Dog CEO 公开端点免密;平台调用仅记录调用量。
怎么拿到 Key
注册 souyi.net.cn → 控制台一键生成 X-API-Key → 即可调用平台全部 API(含本系列 34 个)。
小结
不是所有 API 都返回 JSON。Dog CEO 用一张图告诉 Agent:图像型接口同样是工作流的一环,接法不同但要会接。
更多免费 API 见 系列目录。