[{"data":1,"prerenderedAt":113},["ShallowReactive",2],{"reference-detail-zh-delete_video_api_v1_video_delete":3,"developer-code-57rpc5":111,"developer-code-1wdzc54":112},{"tag":4,"sourceTag":5,"tagSlug":6,"method":7,"path":8,"slug":9,"summary":10,"description":11,"operationId":12,"groupOrder":13,"descriptionHtml":14,"parameters":15,"responses":28,"security":98,"codeSamples":101},"Talking Avatar Video","Videos","videos","DELETE","\u002Fapi\u002Fv1\u002Fvideo","delete-video","删除视频","通过 `video_id` 删除视频。仅影响自己创建的视频，且删除后无法恢复。\n\nAgent 安全要求：仅在用户明确要求删除，并在调用此破坏性操作前再次确认后，才能执行。","delete_video_api_v1_video_delete",10,"\u003Cp>通过 \u003Ccode>video_id\u003C\u002Fcode> 删除视频。仅影响自己创建的视频，且删除后无法恢复。\u003C\u002Fp>\u003Cp>Agent 安全要求：仅在用户明确要求删除，并在调用此破坏性操作前再次确认后，才能执行。\u003C\u002Fp>",[16,23],{"name":17,"in":18,"required":19,"description":20,"type":21,"example":22},"X-API-Key","header",true,"你的 VisionStory API Key（`sk-vs-...`），请仅保存在服务端。可在 [API Key 管理](\u002Fapi-keys) 中创建或管理，需要 Pro 或更高方案。","string","sk-vs-your-api-key",{"name":24,"in":25,"required":19,"description":26,"type":21,"example":27},"video_id","query","要删除的视频 ID，来自 POST \u002Fapi\u002Fv1\u002Fvideo 或 GET \u002Fapi\u002Fv1\u002Fvideos。仅影响自己创建的视频，且删除永久生效。","video_123456",[29,67],{"status":30,"description":31,"contentType":32,"schema":33,"example":58,"examples":61,"headers":66},"200","请求成功","application\u002Fjson",{"type":34,"description":35,"nullable":36,"properties":37},"BaseSuccessResponse_DeleteResponse_","",false,[38,48,53],{"name":39,"required":19,"type":40,"description":41,"nullable":19,"properties":42},"data","DeleteResponse | null","DELETE 接口（avatar \u002F voice \u002F video \u002F ai_video \u002F asset）的通用响应体。",[43],{"name":44,"required":36,"type":45,"description":46,"nullable":36,"default":19,"properties":47},"deleted","boolean","请求成功时始终为 `true`，表示资源已移除，不再出现在列表接口中。删除操作具有幂等性：再次删除已移除的资源仍返回 `true`。",[],{"name":49,"required":36,"type":21,"description":50,"nullable":36,"default":51,"properties":52},"message","便于阅读的状态消息；调用成功时为 `\"success\"`。","success",[],{"name":54,"required":19,"type":55,"description":56,"nullable":36,"properties":57},"server_time","string · date-time","服务端生成响应时的时间戳，使用 ISO 8601 格式（UTC）。",[],{"data":59,"message":51,"server_time":60},{"deleted":19},"2026-09-04T00:00:00Z",[62],{"name":51,"description":63,"summary":31,"value":64},"示例仅用于说明响应结构，不代表实时账户数据或实际报价。ID 和 URL 均为占位内容。请调用模型查询及费用估算接口，获取当前可用模型和价格。",{"data":65,"message":51,"server_time":60},{"deleted":19},[],{"status":68,"description":69,"contentType":32,"schema":70,"example":94,"headers":97},"default","错误响应。所有失败均使用统一结构：`error` 对象包含数字错误码 `code`、便于阅读的 `message`、可选的 `details` 字符串，以及提供后续处理建议的可选 `hint`（便于 AI Agent 使用）。",{"type":71,"description":35,"nullable":36,"properties":72},"ErrorResponse",[73],{"name":74,"required":19,"type":75,"description":35,"nullable":36,"properties":76},"error","ErrorDetail",[77,82,87,91],{"name":78,"required":19,"type":79,"description":80,"nullable":36,"properties":81},"code","integer","机器可读的错误码。传输层失败时对应 HTTP 状态码（例如 401、404、422、500），其他情况可能使用业务专用错误码。",[],{"name":83,"required":36,"type":84,"description":85,"nullable":19,"properties":86},"details","string | null","可选的结构化错误详情，例如 422 响应中逐字段校验错误的 JSON 字符串。无补充信息时不返回。",[],{"name":88,"required":36,"type":84,"description":89,"nullable":19,"properties":90},"hint","供用户和 AI Agent 参考的错误处理建议，例如如何修正请求或在哪里获取 API Key。可能不返回此字段。",[],{"name":49,"required":19,"type":21,"description":92,"nullable":36,"properties":93},"便于阅读的错误原因说明，可安全记录到日志或展示给最终用户；此返回值未本地化。",[],{"error":95},{"code":96,"message":21,"details":21,"hint":21},1,[],[99],{"APIKeyHeader":100},[],[102,105,108],{"lang":103,"source":104},"SDK","from visionstory import VisionStoryClient\n\nclient = VisionStoryClient.from_env()\nresult = client.delete_video(\"video_123456\")\nprint(result)",{"lang":106,"source":107},"REST","import os\nimport requests\n\nheaders = {\"X-API-Key\": os.environ[\"VISIONSTORY_API_KEY\"]}\nrequests.delete(\n    'https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fvideo?video_id=xxxx', headers=headers\n)",{"lang":109,"source":110},"cURL","curl -X 'DELETE' \\\n      'https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fvideo?video_id=xxxx' \\\n      -H 'accept: application\u002Fjson' \\\n      -H 'X-API-Key: $VISIONSTORY_API_KEY'","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#FF7B72\">from\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> visionstory \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">import\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> VisionStoryClient\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">client \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> VisionStoryClient.from_env()\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">result \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> client.delete_video(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"video_123456\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79C0FF\">print\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(result)\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">{\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">  \"data\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">    \"deleted\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\">true\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">  },\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">  \"message\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"success\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">  \"server_time\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"2026-09-04T00:00:00Z\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">}\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",1788547143931]