Ori联系我们

文档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。所以跑失败的任务不用手动清理 —— 钱会回来,记录留着就行。