51 capabilities · one balance
接上你的 agent
需要的
每一项创作能力
图像、视频、音乐、语音、口型、转录、搜索、地理数据 —— 一个接口，一个余额。
当前公开接口
$GET /api/tools/catalog能力 →先发现、再检视；执行将在认证完成后开放。
目录
能力按 service 编址
不是「生成视频」，而是 seedance-2-0、grok-imagine-1.5 —— 同族之间价格能差 20 倍，能力边界也完全不同。
seedance-2-0seedance-2-0-fastseedance-2-0-minikling-o3-ref2vkling-o3-pro-ref2vkling-o3-v2vkling-o3-pro-v2vseedance-1-5dli2v3dlai2v_prodlai2v_pro_multiframekling3.0dlai2vdlim2vhappyhorse-1-0-i2vhappyhorse-1-0-r2vhappyhorse-1-0-video-editgemini-omni-videogrok-imagine-1.5longcat-avatar-1-5dlai2v_prodlai2v_pro_multiframedlai2vlongcat-avatarbanana-probanana-2seedreamseedream-5-lte
怎么用告诉 agent 要做什么
告诉 agent 要做什么
它自己挑工具
不用事先把工具清单塞进提示词，也不用替它决定该用哪个模型 —— 每项能力的适用边界和取舍都写在目录里，它读过就会用。
discover一句话描述目的，拿回按适配度排序的候选与推荐理由
inspect输入 schema、能力边界、价格，一次拿全，不用猜
run 403执行入口暂未开放；认证、计费与审计完成后再启用
计费
没有订阅
discover 和 inspect 免费。run 的价格可以在执行前确认，但 Actionway 当前尚未开放执行入口。
51项能力
免费查询discover · inspect
1 个余额用于未来的 run
$ curl -X POST /api/tools/run → 403 tool_execution_disabled
当前不会产生执行费用。 POST /api/tools/run 固定返回 403，直到认证、授权、计费与审计边界完成评审。
接口
三个动词，一个接口
同一份目录，同一套能力定义；run 先保留契约，入口保持关闭。
/api/tools/discover
自然语言进，候选能力出。免费，不需要登录。
/api/tools/inspect
取某项能力的完整输入契约与使用指引。免费。
/api/tools/run 403
执行逻辑已预留，当前由 Actionway 服务端统一返回 403。
常见问题
你可能想问
需要登录吗？
浏览目录、discover 和 inspect 目前都不需要登录。run 暂未开放。
怎么计费？
discover 和 inspect 免费。只有未来开放的 run 会收费，实际执行前会先提供报价。
为什么 run 现在返回 403？
认证、授权、计费和审计边界还没有完成，所以 Actionway 在服务端入口统一拦截。
支持哪些 agent 框架？
都支持。这是普通 HTTP 接口，curl 能用就行，没有 SDK 要装、没有版本要跟。
异步任务怎么拿结果？
视频、音乐、口型等能力通常异步执行。结果查询会与 run 一起在认证完成后开放。
让 agent 自己找到
该用的能力
现在可以公开检索目录和读取能力约束；执行会在认证完成后开放。
$GET /api/tools/catalog打开能力目录 →