[{"data":1,"prerenderedAt":162},["ShallowReactive",2],{"reference-detail-en-get_videos_api_v1_videos_get":3,"developer-code-trrk36":160,"developer-code-h5zf68":161},{"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":147,"codeSamples":150},"Talking Avatar Video","Videos","videos","GET","\u002Fapi\u002Fv1\u002Fvideos","get-videos","List videos","List your most recent videos (up to 100, newest first). Not paginated — intended for quick access to\nrecent generation history.","get_videos_api_v1_videos_get",10,"\u003Cp>List your most recent videos (up to 100, newest first). Not paginated — intended for quick access to recent generation history.\u003C\u002Fp>",[16],{"name":17,"in":18,"required":19,"description":20,"type":21,"example":22},"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",[24,118],{"status":25,"description":26,"contentType":27,"schema":28,"example":99,"examples":109,"headers":117},"200","Successful Response","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","The endpoint-specific payload. See this endpoint's response schema for its fields; null only when the operation returns no payload.",[38],{"name":6,"required":19,"type":39,"description":40,"nullable":31,"properties":41,"items":42},"VideoDto[]","Recent videos for the account, most recent first (up to 100; not paginated).",[],{"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","Output aspect ratio of the rendered video.",[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","Credits charged for this video; 0 when the task failed (the charge is auto-refunded).",0,[],{"name":60,"required":19,"type":55,"description":61,"nullable":31,"properties":62},"created_at","Unix timestamp (seconds) when the video task was created.",[],{"name":64,"required":19,"type":21,"description":65,"nullable":31,"properties":66},"model_id","Identifier of the model that produced this video; see GET \u002Fapi\u002Fv1\u002Fmodels.",[],{"name":68,"required":31,"type":21,"description":69,"nullable":31,"enum":70,"default":71,"properties":75},"resolution","Output resolution of the rendered video.",[71,72,73,74],"480p","720p","1080p","2k",[],{"name":77,"required":19,"type":21,"description":78,"nullable":31,"properties":79},"status","Current task status: `queued` (waiting), `creating` (rendering), `created` (ready), or `failed`.",[],{"name":81,"required":19,"type":21,"description":82,"nullable":31,"properties":83},"video_id","Unique identifier of the video task. Use it to poll status or delete the video.",[],{"name":85,"required":31,"type":86,"description":87,"nullable":19,"properties":88},"video_url","string | null","Download URL of the finished video; empty until status is `created`. Videos are retained for 7 days.",[],{"name":90,"required":31,"type":21,"description":91,"nullable":31,"default":92,"properties":93},"message","Human-readable status message; `\"success\"` on a successful call.","success",[],{"name":95,"required":19,"type":96,"description":97,"nullable":31,"properties":98},"server_time","string · date-time","Server-side timestamp when the response was produced, in ISO 8601 format (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":112,"value":113},"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":114,"message":92,"server_time":108},{"videos":115},[116],{"aspect_ratio":49,"cost_credit":13,"created_at":103,"model_id":104,"resolution":72,"status":105,"video_id":106,"video_url":107},[],{"status":119,"description":120,"contentType":27,"schema":121,"example":143,"headers":146},"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":122,"description":30,"nullable":31,"properties":123},"ErrorResponse",[124],{"name":125,"required":19,"type":126,"description":30,"nullable":31,"properties":127},"error","ErrorDetail",[128,132,136,140],{"name":129,"required":19,"type":55,"description":130,"nullable":31,"properties":131},"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":133,"required":31,"type":86,"description":134,"nullable":19,"properties":135},"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":137,"required":31,"type":86,"description":138,"nullable":19,"properties":139},"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":90,"required":19,"type":21,"description":141,"nullable":31,"properties":142},"Human-readable explanation of what went wrong. Safe to log or surface to end users; not localized.",[],{"error":144},{"code":145,"message":21,"details":21,"hint":21},1,[],[148],{"APIKeyHeader":149},[],[151,154,157],{"lang":152,"source":153},"SDK","from visionstory import VisionStoryClient\n\nclient = VisionStoryClient.from_env()\nvideos = client.list_videos()\nprint(videos)",{"lang":155,"source":156},"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":158,"source":159},"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>",1790231923843]