智能执行

能力标识：agent.execute。用一句话描述任务，智能体可以查询已授权能力、预估积分、提交图片或视频任务并查询结果。接口使用接入密钥鉴权，不使用浏览器 Cookie。

启用隔离运行环境的控制台对话支持执行工作空间命令、下载文件、转换 JPEG，并使用 deepseek-flash 查看 PNG、JPEG、WebP 或 GIF 图片。运行环境包含灵途 CLI 和灵感 Skill。每次读图最多包含四张图片，大图会自动缩小；可用工具和文件以对应对话的工作空间为准，远程执行的结果仍回写到当前对话，图片输入计入同一轮任务预算。

创建可复用智能体

curl https://api.anycap.io/v1/managed-agents \  -H "Authorization: Bearer $ANYCAP_API_KEY" \  -H "Content-Type: application/json" \  -d '{"name":"内容策划","role_description":"用用户的语言规划可执行的 TikTok Shop 内容。"}' # 后续每轮使用返回的 id；会话和 history 由接入产品保存。curl https://api.anycap.io/v1/managed-agents/$AGENT_ID/runs \  -H "Authorization: Bearer $ANYCAP_API_KEY" \  -H "Idempotency-Key: $TURN_ID" \  -H "Content-Type: application/json" \  -d '{"input":"为这个商品写 3 个开场钩子。","history":[],"max_credits":0,"stream":false}'

通过 GET /v1/managed-agents 查询定义，通过 PATCH/DELETE /v1/managed-agents/{id} 修改或删除。归属始终由接入密钥对应的账号和 actor 决定。Idempotency-Key 仅可用于完全相同的一轮。Anycap 执行并结算模型/工具，接入方服务端保存并校验自己的终端用户会话。

已登记的服务端应用可使用持久化图文复刻任务：POST /v1/managed-agents/{id}/jobs 返回 202；GET /jobs/{job_id} 查询状态，/events 使用 Last-Event-ID 重放 SSE；POST /cancel 停止后续工作，POST /inputs 在 waiting_input 时提交稳定的 input_id 与 feedback。每次调用均需接入密钥、X-Anycap-App 及短期 X-Anycap-Grant，绑定应用用户、外部任务编号、动作和原始请求体摘要；凭据只放在接入产品服务端。已完成步骤和累计模型预算在重启后保留，结果未知的模型或生成请求不会自动重提。此任务类型需运营启用；案例、产品、素材等结构化输入及独立业务算力上限以 OpenAPI 为准。

发现模型并执行

curl https://api.anycap.io/v1/models \  -H "Authorization: Bearer $ANYCAP_API_KEY" curl https://api.anycap.io/api/v1/capabilities/agent.execute/executions \  -H "Authorization: Bearer $ANYCAP_API_KEY" \  -H "Content-Type: application/json" \  -d '{"input":"查看我能使用的图片生成能力，并推荐一个合适的方案。","model":"deepseek-flash","max_credits":0,"max_turns":4,"stream":false}'

将 model 替换为发现接口中已授权、可用的模型。请求与既有 POST /v1/agent/runs 合同相同，旧客户端可以继续使用原接口。执行付费工具前须明确授权，并设置正数 max_credits。

读取结果与继续调用

返回 id、status、message、steps、budget、usage、messages。即使 HTTP 200 也要检查 status：completed 完成、budget_exceeded 工具预算不足、limit_reached 达到轮次上限、failed 执行失败。图片或视频任务可能仍在处理中，应按返回的任务 ID 使用相应能力查询接口。

设置 stream:true 或 Accept: text/event-stream 可接收 run.started、tool.call、tool.result、assistant、run.completed、run.failed 事件。预算或轮次限制也通过 run.failed 结束。助手文本按模型轮次返回，不逐 token 推送。

调用方自行保存历史，将响应 messages 追加后在下一次请求中作为 history 传入。直接调用 agent.execute 仍是无状态的；/v1/managed-agents/{id}/runs 会额外读取属于该密钥 actor 的可复用角色，但仍不创建控制台浏览器会话或文件工作区。每轮发送稳定的 Idempotency-Key 后，相同请求可派生相同计费执行编号；输入或 history 改变时不得复用该 key。