[{"data":1,"prerenderedAt":161},["ShallowReactive",2],{"reference-detail-zh-get_videos_api_v1_videos_get":3,"developer-code-trrk36":159,"developer-code-h5zf68":160},{"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":23,"security":146,"codeSamples":149},"Talking Avatar Video","Videos","videos","GET","\u002Fapi\u002Fv1\u002Fvideos","get-videos","列出视频","列出最近的视频，最多 100 个，按时间从新到旧排列。不分页，适合快速查看最近的生成记录。","get_videos_api_v1_videos_get",10,"\u003Cp>列出最近的视频，最多 100 个，按时间从新到旧排列。不分页，适合快速查看最近的生成记录。\u003C\u002Fp>",[16],{"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",[24,117],{"status":25,"description":26,"contentType":27,"schema":28,"example":99,"examples":109,"headers":116},"200","请求成功","application\u002Fjson",{"type":29,"description":30,"nullable":31,"properties":32},"BaseSuccessResponse_GetVideosResponse_","",false,[33,89,94],{"name":34,"required":19,"type":35,"description":36,"nullable":19,"properties":37},"data","GetVideosResponse | null","当前接口的响应数据，字段定义见该接口的响应结构。仅当操作不返回数据时为 null。",[38],{"name":6,"required":19,"type":39,"description":40,"nullable":31,"properties":41,"items":42},"VideoDto[]","账户最近的视频，按时间从新到旧排列，最多 100 个，不分页。",[],{"type":43,"description":30,"nullable":31,"properties":44},"VideoDto",[45,53,59,63,67,76,80,84],{"name":46,"required":31,"type":21,"description":47,"nullable":31,"enum":48,"default":49,"properties":52},"aspect_ratio","渲染后视频的输出宽高比。",[49,50,51],"9:16","16:9","1:1",[],{"name":54,"required":31,"type":55,"description":56,"nullable":31,"default":57,"properties":58},"cost_credit","integer","生成此视频扣除的点数；任务失败时为 0，已扣点数会自动退还。",0,[],{"name":60,"required":19,"type":55,"description":61,"nullable":31,"properties":62},"created_at","视频任务创建时的 Unix 时间戳，单位为秒。",[],{"name":64,"required":19,"type":21,"description":65,"nullable":31,"properties":66},"model_id","生成此视频的模型标识符，请查询 GET \u002Fapi\u002Fv1\u002Fmodels。",[],{"name":68,"required":31,"type":21,"description":69,"nullable":31,"enum":70,"default":71,"properties":75},"resolution","渲染后视频的输出分辨率。",[71,72,73,74],"480p","720p","1080p","2k",[],{"name":77,"required":19,"type":21,"description":78,"nullable":31,"properties":79},"status","当前任务状态：`queued`（等待中）、`creating`（渲染中）、`created`（已完成）或 `failed`（失败）。",[],{"name":81,"required":19,"type":21,"description":82,"nullable":31,"properties":83},"video_id","视频任务的唯一标识符，用于轮询状态或删除视频。",[],{"name":85,"required":31,"type":86,"description":87,"nullable":19,"properties":88},"video_url","string | null","成片下载 URL；状态为 `created` 前为空。视频保留 7 天。",[],{"name":90,"required":31,"type":21,"description":91,"nullable":31,"default":92,"properties":93},"message","便于阅读的状态消息；调用成功时为 `\"success\"`。","success",[],{"name":95,"required":19,"type":96,"description":97,"nullable":31,"properties":98},"server_time","string · date-time","服务端生成响应时的时间戳，使用 ISO 8601 格式（UTC）。",[],{"data":100,"message":92,"server_time":108},{"videos":101},[102],{"aspect_ratio":49,"cost_credit":13,"created_at":103,"model_id":104,"resolution":72,"status":105,"video_id":106,"video_url":107},1788480000,"vs_character_v4","created","example_video_id","https:\u002F\u002Fexample.com\u002Favatar-video.mp4","2026-09-04T00:00:00Z",[110],{"name":92,"description":111,"summary":26,"value":112},"示例仅用于说明响应结构，不代表实时账户数据或实际报价。ID 和 URL 均为占位内容。请调用模型查询及费用估算接口，获取当前可用模型和价格。",{"data":113,"message":92,"server_time":108},{"videos":114},[115],{"aspect_ratio":49,"cost_credit":13,"created_at":103,"model_id":104,"resolution":72,"status":105,"video_id":106,"video_url":107},[],{"status":118,"description":119,"contentType":27,"schema":120,"example":142,"headers":145},"default","错误响应。所有失败均使用统一结构：`error` 对象包含数字错误码 `code`、便于阅读的 `message`、可选的 `details` 字符串，以及提供后续处理建议的可选 `hint`（便于 AI Agent 使用）。",{"type":121,"description":30,"nullable":31,"properties":122},"ErrorResponse",[123],{"name":124,"required":19,"type":125,"description":30,"nullable":31,"properties":126},"error","ErrorDetail",[127,131,135,139],{"name":128,"required":19,"type":55,"description":129,"nullable":31,"properties":130},"code","机器可读的错误码。传输层失败时对应 HTTP 状态码（例如 401、404、422、500），其他情况可能使用业务专用错误码。",[],{"name":132,"required":31,"type":86,"description":133,"nullable":19,"properties":134},"details","可选的结构化错误详情，例如 422 响应中逐字段校验错误的 JSON 字符串。无补充信息时不返回。",[],{"name":136,"required":31,"type":86,"description":137,"nullable":19,"properties":138},"hint","供用户和 AI Agent 参考的错误处理建议，例如如何修正请求或在哪里获取 API Key。可能不返回此字段。",[],{"name":90,"required":19,"type":21,"description":140,"nullable":31,"properties":141},"便于阅读的错误原因说明，可安全记录到日志或展示给最终用户；此返回值未本地化。",[],{"error":143},{"code":144,"message":21,"details":21,"hint":21},1,[],[147],{"APIKeyHeader":148},[],[150,153,156],{"lang":151,"source":152},"SDK","from visionstory import VisionStoryClient\n\nclient = VisionStoryClient.from_env()\nvideos = client.list_videos()\nprint(videos)",{"lang":154,"source":155},"REST","import os\nimport requests\n\nheaders = {\"X-API-Key\": os.environ[\"VISIONSTORY_API_KEY\"]}\nresponse = requests.get(\n    'https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fvideos', headers=headers, timeout=10\n)\nresp_data = response.json()\nprint(len(resp_data['data']['videos']))",{"lang":157,"source":158},"cURL","curl -X 'GET' \\\n      'https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fvideos' \\\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\">videos \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> client.list_videos()\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79C0FF\">print\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(videos)\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\">    \"videos\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: [\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">      {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">        \"aspect_ratio\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"9:16\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">        \"cost_credit\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\">10\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">        \"created_at\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\">1788480000\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">        \"model_id\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"vs_character_v4\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">        \"resolution\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"720p\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">        \"status\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"created\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">        \"video_id\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"example_video_id\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">        \"video_url\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"https:\u002F\u002Fexample.com\u002Favatar-video.mp4\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">      }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">    ]\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>",1788547143930]