文档OriHub
取消或删除任务
媒体任务没有取消和删除接口;能删的是密钥、数字人、对话组和记忆。
媒体任务没有取消或删除接口。 任务提交出去就一路跑到终态,只能查、不能撤。
客户端断开不等于取消
断开连接不影响服务端:任务照跑,成功照扣,失败全额退款。但断开后拿不回正文 —— 要正文就用流式边收边存。
(聊天接口 /v1/agent/chat 的 SSE 流里,中断会发一个 task_interrupted 帧,已产出的部分照常交付,最后的 done 帧 status 是 interrupted。)
能删和能停的是什么
| 对象 | 接口 | 说明 |
|---|---|---|
| 密钥 | DELETE /v1/keys/{id} |
需要管理密钥(sk-mgmt- 开头,控制台 API Key 页开「允许通过 API 管理」生成)。普通 API Key 调它返回 403(code=management_key_required) |
| 数字人 | DELETE /v1/skills/avatars/{avatar_id} |
|
| 对话组 | POST /v1/agent/conversations/delete |
硬删不可恢复,连带历史消息和附件解析缓存一起删 |
| 长期记忆 | POST /v1/agent/memories/clear |
删密钥的细节
- 删除即刻生效 —— 之后这把 Key 的每次调用都返回 401
- 调用记录和扣费保留,用量日志里这把 Key 显示为已删除
- 重复删、或删别人账户的密钥 → 404
- 每次删除都记录时间、来源 IP、User-Agent 和删除前的配置
- 想暂停而不是删:
POST /v1/keys/{id}带status=0(之后所有端点返回 403,改回status=1恢复)
任务记录本身只能查
| 想知道 | 用哪个 |
|---|---|
| 某个任务的状态和成品 | GET /v1/skills/task-status?task_id=... |
| 最近的任务列表 | GET /v1/skills/usage?detail=1 |
任务失败时是全额退款:cost 归零,退款额在 refunded_amount。所以跑失败的任务不用手动清理 —— 钱会回来,记录留着就行。