[{"data":1,"prerenderedAt":166},["ShallowReactive",2],{"reference-detail-en-get_assets_api_v1_assets_get":3,"developer-code-k3bk6n":164,"developer-code-16w18hi":165},{"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":151,"codeSamples":154},"Assets","assets","GET","\u002Fapi\u002Fv1\u002Fassets","get-assets","List assets","List your uploaded assets, newest first. Pass the previous page's `next_cursor` to paginate\n(`next_cursor=0` means no more pages); optionally filter by `kind` (`image` \u002F `video` \u002F `audio`).","get_assets_api_v1_assets_get",90,"\u003Cp>List your uploaded assets, newest first. Pass the previous page's \u003Ccode>next_cursor\u003C\u002Fcode> to paginate (\u003Ccode>next_cursor=0\u003C\u002Fcode> means no more pages); optionally filter by \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,"Your VisionStory API key (`sk-vs-...`), kept server-side. Create or manage keys in [API keys](\u002Fapi-keys) (Pro plan and up).","string","sk-vs-your-api-key",{"name":23,"in":24,"required":25,"description":26,"type":27,"enum":28,"example":29},"kind","query",false,"Filter by media kind. Omit to return assets of all kinds.","string | null",[29,30,31],"image","video","audio",{"name":33,"in":24,"required":25,"description":34,"type":35,"default":36,"example":36},"cursor","Pagination cursor from the previous page's `next_cursor`. Omit or pass 0 to start from the newest asset.","integer",0,{"name":38,"in":24,"required":25,"description":39,"type":35,"default":40,"example":40},"limit","Maximum assets to return per page. Range 1–100; defaults to 20.",20,[42,122],{"status":43,"description":44,"contentType":45,"schema":46,"example":104,"examples":113,"headers":121},"200","Successful Response","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","The endpoint-specific payload. See this endpoint's response schema for its fields; null only when the operation returns no payload.",[55,90],{"name":5,"required":18,"type":56,"description":57,"nullable":25,"properties":58,"items":59},"AssetDto[]","Uploaded assets for this account, newest first.",[],{"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","Unique identifier of the asset; reference it as `asset_id` in generation requests.",[],{"name":67,"required":25,"type":35,"description":68,"nullable":25,"default":36,"properties":69},"created_at","Unix timestamp (seconds) when the asset was uploaded.",[],{"name":71,"required":25,"type":72,"description":73,"nullable":25,"default":36,"properties":74},"duration_sec","number","Duration in seconds for video\u002Faudio assets; 0 for images.",[],{"name":76,"required":25,"type":35,"description":77,"nullable":25,"default":36,"properties":78},"height","Pixel height for image\u002Fvideo assets; 0 when not applicable.",[],{"name":23,"required":18,"type":20,"description":80,"nullable":25,"properties":81},"Detected media kind: one of `image` \u002F `video` \u002F `audio`.",[],{"name":83,"required":25,"type":20,"description":84,"nullable":25,"default":48,"properties":85},"mime","Detected MIME type of the asset, e.g. `image\u002Fpng`.",[],{"name":87,"required":25,"type":35,"description":88,"nullable":25,"default":36,"properties":89},"width","Pixel width for image\u002Fvideo assets; 0 when not applicable.",[],{"name":91,"required":25,"type":35,"description":92,"nullable":25,"default":36,"properties":93},"next_cursor","Cursor to fetch the next page; pass it back as `cursor`. 0 means no more pages.",[],{"name":95,"required":25,"type":20,"description":96,"nullable":25,"default":97,"properties":98},"message","Human-readable status message; `\"success\"` on a successful call.","success",[],{"name":100,"required":18,"type":101,"description":102,"nullable":25,"properties":103},"server_time","string · date-time","Server-side timestamp when the response was produced, in ISO 8601 format (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":116,"value":117},"Examples illustrate the response structure, not live account data or a pricing quote. IDs and URLs are placeholders. Query model discovery and cost endpoints for current availability and prices.","Successful response",{"data":118,"message":97,"server_time":112},{"assets":119,"next_cursor":36},[120],{"asset_id":108,"created_at":109,"duration_sec":36,"height":110,"kind":29,"mime":111,"width":110},[],{"status":123,"description":124,"contentType":45,"schema":125,"example":147,"headers":150},"default","Error response. All failures share one envelope: an `error` object with a numeric `code`, a human-readable `message`, an optional `details` string, and an optional `hint` giving an actionable next step (useful for AI agents).",{"type":126,"description":48,"nullable":25,"properties":127},"ErrorResponse",[128],{"name":129,"required":18,"type":130,"description":48,"nullable":25,"properties":131},"error","ErrorDetail",[132,136,140,144],{"name":133,"required":18,"type":35,"description":134,"nullable":25,"properties":135},"code","Machine-readable error code. Mirrors the HTTP status for transport-level failures (e.g. 401, 404, 422, 500) and may carry a business-specific code otherwise.",[],{"name":137,"required":25,"type":27,"description":138,"nullable":18,"properties":139},"details","Optional structured detail about the failure, e.g. a JSON string of per-field validation errors on a 422. Absent when there is nothing extra to report.",[],{"name":141,"required":25,"type":27,"description":142,"nullable":18,"properties":143},"hint","Actionable next step for resolving the error, written for both humans and AI agents (e.g. how to fix the request, or where to obtain an API key). May be absent.",[],{"name":95,"required":18,"type":20,"description":145,"nullable":25,"properties":146},"Human-readable explanation of what went wrong. Safe to log or surface to end users; not localized.",[],{"error":148},{"code":149,"message":20,"details":20,"hint":20},1,[],[152],{"APIKeyHeader":153},[],[155,158,161],{"lang":156,"source":157},"SDK","from visionstory import VisionStoryClient\n\nclient = VisionStoryClient.from_env()\nassets = client.list_assets(kind=\"image\", limit=20)\nprint(assets)",{"lang":159,"source":160},"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":162,"source":163},"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>",1790231924588]