搜索 VisionStory 开发者文档

没有找到匹配的文档“”。

可以尝试功能或资源名称,例如

VisionStory开发者

删除 AI 视频

DELETE/api/v1/ai_video
AI 视频

通过 video_id 软删除 AI 视频任务,仅影响自己创建的任务。

Beta:所有有效付费订阅账户均可使用,适用标准的单 API Key 请求频率限制。

Agent 安全要求:仅在用户明确要求删除,并在调用此破坏性操作前再次确认后,才能执行。

请求头

X-API-Keystring必填

你的 VisionStory API Key(sk-vs-...),请仅保存在服务端。可在 API Key 管理 中创建或管理,需要 Pro 或更高方案。

查询参数

video_idstring必填

要删除的 AI 视频任务 ID,来自 POST /api/v1/ai_video。仅影响自己创建的任务,采用软删除。

响应

200请求成功

application/json

dataDeleteResponse | null必填可为空

DELETE 接口(avatar / voice / video / ai_video / asset)的通用响应体。

deletedboolean

请求成功时始终为 true,表示资源已移除,不再出现在列表接口中。删除操作具有幂等性:再次删除已移除的资源仍返回 true

默认值: true

messagestring

便于阅读的状态消息;调用成功时为 "success"

默认值: success

server_timestring · date-time必填

服务端生成响应时的时间戳,使用 ISO 8601 格式(UTC)。

default错误响应。所有失败均使用统一结构:error 对象包含数字错误码 code、便于阅读的 message、可选的 details 字符串,以及提供后续处理建议的可选 hint(便于 AI Agent 使用)。

application/json

errorErrorDetail必填
codeinteger必填

机器可读的错误码。传输层失败时对应 HTTP 状态码(例如 401、404、422、500),其他情况可能使用业务专用错误码。

detailsstring | null可为空

可选的结构化错误详情,例如 422 响应中逐字段校验错误的 JSON 字符串。无补充信息时不返回。

hintstring | null可为空

供用户和 AI Agent 参考的错误处理建议,例如如何修正请求或在哪里获取 API Key。可能不返回此字段。

messagestring必填

便于阅读的错误原因说明,可安全记录到日志或展示给最终用户;此返回值未本地化。