[{"data":1,"prerenderedAt":165},["ShallowReactive",2],{"reference-detail-zh-get_assets_api_v1_assets_get":3,"developer-code-k3bk6n":163,"developer-code-16w18hi":164},{"tag":4,"sourceTag":4,"tagSlug":5,"method":6,"path":7,"slug":8,"summary":9,"description":10,"operationId":11,"groupOrder":12,"descriptionHtml":13,"parameters":14,"responses":41,"security":150,"codeSamples":153},"Assets","assets","GET","\u002Fapi\u002Fv1\u002Fassets","get-assets","列出素材","列出已上传的素材，按时间从新到旧排列。使用上一页的 `next_cursor` 分页（`next_cursor=0` 表示没有更多页面），可选按 `kind`（`image` \u002F `video` \u002F `audio`）筛选。","get_assets_api_v1_assets_get",90,"\u003Cp>列出已上传的素材，按时间从新到旧排列。使用上一页的 \u003Ccode>next_cursor\u003C\u002Fcode> 分页（\u003Ccode>next_cursor=0\u003C\u002Fcode> 表示没有更多页面），可选按 \u003Ccode>kind\u003C\u002Fcode>（\u003Ccode>image\u003C\u002Fcode> \u002F \u003Ccode>video\u003C\u002Fcode> \u002F \u003Ccode>audio\u003C\u002Fcode>）筛选。\u003C\u002Fp>",[15,22,32,37],{"name":16,"in":17,"required":18,"description":19,"type":20,"example":21},"X-API-Key","header",true,"你的 VisionStory API Key（`sk-vs-...`），请仅保存在服务端。可在 [API Key 管理](\u002Fapi-keys) 中创建或管理，需要 Pro 或更高方案。","string","sk-vs-your-api-key",{"name":23,"in":24,"required":25,"description":26,"type":27,"enum":28,"example":29},"kind","query",false,"按媒体类型筛选。省略时返回所有类型的素材。","string | null",[29,30,31],"image","video","audio",{"name":33,"in":24,"required":25,"description":34,"type":35,"default":36,"example":36},"cursor","上一页返回的 `next_cursor` 分页游标。省略或传入 0 时，从最新素材开始查询。","integer",0,{"name":38,"in":24,"required":25,"description":39,"type":35,"default":40,"example":40},"limit","每页最多返回的素材数，范围为 1–100，默认 20。",20,[42,121],{"status":43,"description":44,"contentType":45,"schema":46,"example":104,"examples":113,"headers":120},"200","请求成功","application\u002Fjson",{"type":47,"description":48,"nullable":25,"properties":49},"BaseSuccessResponse_GetAssetsResponse_","",[50,94,99],{"name":51,"required":18,"type":52,"description":53,"nullable":18,"properties":54},"data","GetAssetsResponse | null","当前接口的响应数据，字段定义见该接口的响应结构。仅当操作不返回数据时为 null。",[55,90],{"name":5,"required":18,"type":56,"description":57,"nullable":25,"properties":58,"items":59},"AssetDto[]","当前账户上传的素材，按时间从新到旧排列。",[],{"type":60,"description":48,"nullable":25,"properties":61},"AssetDto",[62,66,70,75,79,82,86],{"name":63,"required":18,"type":20,"description":64,"nullable":25,"properties":65},"asset_id","素材的唯一标识符，在生成请求中作为 `asset_id` 引用。",[],{"name":67,"required":25,"type":35,"description":68,"nullable":25,"default":36,"properties":69},"created_at","素材上传时的 Unix 时间戳，单位为秒。",[],{"name":71,"required":25,"type":72,"description":73,"nullable":25,"default":36,"properties":74},"duration_sec","number","视频或音频素材的时长，单位为秒；图像为 0。",[],{"name":76,"required":25,"type":35,"description":77,"nullable":25,"default":36,"properties":78},"height","图像或视频素材的像素高度；不适用时为 0。",[],{"name":23,"required":18,"type":20,"description":80,"nullable":25,"properties":81},"识别出的媒体类型，为 `image` \u002F `video` \u002F `audio` 之一。",[],{"name":83,"required":25,"type":20,"description":84,"nullable":25,"default":48,"properties":85},"mime","识别出的素材 MIME 类型，例如 `image\u002Fpng`。",[],{"name":87,"required":25,"type":35,"description":88,"nullable":25,"default":36,"properties":89},"width","图像或视频素材的像素宽度；不适用时为 0。",[],{"name":91,"required":25,"type":35,"description":92,"nullable":25,"default":36,"properties":93},"next_cursor","获取下一页的游标，将其作为 `cursor` 传回。0 表示没有更多页面。",[],{"name":95,"required":25,"type":20,"description":96,"nullable":25,"default":97,"properties":98},"message","便于阅读的状态消息；调用成功时为 `\"success\"`。","success",[],{"name":100,"required":18,"type":101,"description":102,"nullable":25,"properties":103},"server_time","string · date-time","服务端生成响应时的时间戳，使用 ISO 8601 格式（UTC）。",[],{"data":105,"message":97,"server_time":112},{"assets":106,"next_cursor":36},[107],{"asset_id":108,"created_at":109,"duration_sec":36,"height":110,"kind":29,"mime":111,"width":110},"example_asset_id",1788480000,1024,"image\u002Fpng","2026-09-04T00:00:00Z",[114],{"name":97,"description":115,"summary":44,"value":116},"示例仅用于说明响应结构，不代表实时账户数据或实际报价。ID 和 URL 均为占位内容。请调用模型查询及费用估算接口，获取当前可用模型和价格。",{"data":117,"message":97,"server_time":112},{"assets":118,"next_cursor":36},[119],{"asset_id":108,"created_at":109,"duration_sec":36,"height":110,"kind":29,"mime":111,"width":110},[],{"status":122,"description":123,"contentType":45,"schema":124,"example":146,"headers":149},"default","错误响应。所有失败均使用统一结构：`error` 对象包含数字错误码 `code`、便于阅读的 `message`、可选的 `details` 字符串，以及提供后续处理建议的可选 `hint`（便于 AI Agent 使用）。",{"type":125,"description":48,"nullable":25,"properties":126},"ErrorResponse",[127],{"name":128,"required":18,"type":129,"description":48,"nullable":25,"properties":130},"error","ErrorDetail",[131,135,139,143],{"name":132,"required":18,"type":35,"description":133,"nullable":25,"properties":134},"code","机器可读的错误码。传输层失败时对应 HTTP 状态码（例如 401、404、422、500），其他情况可能使用业务专用错误码。",[],{"name":136,"required":25,"type":27,"description":137,"nullable":18,"properties":138},"details","可选的结构化错误详情，例如 422 响应中逐字段校验错误的 JSON 字符串。无补充信息时不返回。",[],{"name":140,"required":25,"type":27,"description":141,"nullable":18,"properties":142},"hint","供用户和 AI Agent 参考的错误处理建议，例如如何修正请求或在哪里获取 API Key。可能不返回此字段。",[],{"name":95,"required":18,"type":20,"description":144,"nullable":25,"properties":145},"便于阅读的错误原因说明，可安全记录到日志或展示给最终用户；此返回值未本地化。",[],{"error":147},{"code":148,"message":20,"details":20,"hint":20},1,[],[151],{"APIKeyHeader":152},[],[154,157,160],{"lang":155,"source":156},"SDK","from visionstory import VisionStoryClient\n\nclient = VisionStoryClient.from_env()\nassets = client.list_assets(kind=\"image\", limit=20)\nprint(assets)",{"lang":158,"source":159},"REST","import os\nimport requests\n\nresponse = requests.get(\n    \"https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fassets\",\n    headers={\"X-API-Key\": os.environ[\"VISIONSTORY_API_KEY\"]},\n    params={\n      \"cursor\": 0,\n      \"limit\": 20\n    },\n)\nresponse.raise_for_status()\nprint(response.json())",{"lang":161,"source":162},"cURL","curl --request GET 'https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fassets?cursor=0&limit=20' \\\n  --header '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\">assets \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> client.list_assets(\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">kind\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"image\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, \u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">limit\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\">20\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\">(assets)\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\">    \"assets\"\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\">        \"asset_id\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"example_asset_id\"\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\">        \"duration_sec\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\">0\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">        \"height\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\">1024\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">        \"kind\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"image\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">        \"mime\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"image\u002Fpng\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">        \"width\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\">1024\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\">    \"next_cursor\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\">0\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>",1788547144566]