[{"data":1,"prerenderedAt":170},["ShallowReactive",2],{"reference-detail-get_ai_videos_api_v1_ai_videos_get":3,"developer-code-vwchh9":168,"developer-code-1pjbir":169},{"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":34,"security":158,"codeSamples":161},"AI Video","AI Videos","ai-videos","GET","\u002Fapi\u002Fv1\u002Fai_videos","get-ai-videos","List AI videos","List AI video tasks for this account, newest first. Pass the previous page's `next_cursor` to\npaginate; `next_cursor=0` means no more pages.\n\nBeta: available to allowlisted API keys; standard per-key rate limits apply.","get_ai_videos_api_v1_ai_videos_get",60,"\u003Cp>List AI video tasks for this account, newest first. Pass the previous page's \u003Ccode>next_cursor\u003C\u002Fcode> to paginate; \u003Ccode>next_cursor=0\u003C\u002Fcode> means no more pages.\u003C\u002Fp>\u003Cp>Beta: available to allowlisted API keys; standard per-key rate limits apply.\u003C\u002Fp>",[16,23,30],{"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",{"name":24,"in":25,"required":26,"description":27,"type":28,"default":29,"example":29},"cursor","query",false,"Pagination cursor from the previous page's `next_cursor`. Omit or pass 0 to start from the newest task.","integer",0,{"name":31,"in":25,"required":26,"description":32,"type":28,"default":33,"example":33},"limit","Maximum tasks to return per page. Range 1–100; defaults to 20.",20,[35,132],{"status":36,"description":37,"contentType":38,"schema":39,"example":124},"200","Successful Response","application\u002Fjson",{"type":40,"description":41,"nullable":26,"properties":42},"BaseSuccessResponse_GetAiVideosResponse_","",[43,115,119],{"name":44,"required":19,"type":45,"description":46,"nullable":19,"properties":47},"data","GetAiVideosResponse | null","The endpoint payload. Its shape is specific to each endpoint (see that endpoint's response schema); null for operations that return no body, such as delete.",[48,52],{"name":49,"required":26,"type":28,"description":50,"nullable":26,"default":29,"properties":51},"next_cursor","Cursor to fetch the next page; pass it back as `cursor`. 0 means no more pages.",[],{"name":53,"required":19,"type":54,"description":55,"nullable":26,"properties":56,"items":57},"videos","AiVideoDto[]","Video tasks for this account, newest first.",[],{"type":58,"description":41,"nullable":26,"properties":59},"AiVideoDto",[60,64,68,73,77,82,95,99,103,107,111],{"name":61,"required":26,"type":21,"description":62,"nullable":26,"default":41,"properties":63},"aspect_ratio","Output aspect ratio of the generated video (e.g. `16:9`, `9:16`); empty until known.",[],{"name":65,"required":26,"type":28,"description":66,"nullable":26,"default":29,"properties":67},"cost_credit","Credits charged for this task; 0 when it failed (the charge is auto-refunded).",[],{"name":69,"required":26,"type":70,"description":71,"nullable":19,"properties":72},"cover_url","string | null","URL of the video's cover\u002Fthumbnail image when available.",[],{"name":74,"required":26,"type":28,"description":75,"nullable":26,"default":29,"properties":76},"created_at","Unix timestamp (seconds) when the task was created.",[],{"name":78,"required":26,"type":79,"description":80,"nullable":26,"default":29,"properties":81},"duration_sec","number","Length of the generated video in seconds; 0 until known.",[],{"name":83,"required":26,"type":84,"description":85,"nullable":19,"properties":86},"error","AiVideoErrorDto | null","Failure detail; present only when status is `failed`.",[87,91],{"name":88,"required":19,"type":28,"description":89,"nullable":26,"properties":90},"code","Numeric code identifying why generation failed.",[],{"name":92,"required":19,"type":21,"description":93,"nullable":26,"properties":94},"message","Human-readable explanation of the failure.",[],{"name":96,"required":19,"type":21,"description":97,"nullable":26,"properties":98},"model_id","Model used to generate this video; see GET \u002Fapi\u002Fv1\u002Fai_video\u002Fmodels.",[],{"name":100,"required":26,"type":21,"description":101,"nullable":26,"default":41,"properties":102},"resolution","Output resolution of the generated video (e.g. `720p`, `1080p`); empty until known.",[],{"name":104,"required":19,"type":21,"description":105,"nullable":26,"properties":106},"status","Current task status: `queued` (waiting), `creating` (rendering), `created` (ready), or `failed`.",[],{"name":108,"required":19,"type":21,"description":109,"nullable":26,"properties":110},"video_id","Unique identifier of the video task.",[],{"name":112,"required":26,"type":70,"description":113,"nullable":19,"properties":114},"video_url","Download URL of the generated video; present once status is `created`.",[],{"name":92,"required":26,"type":21,"description":116,"nullable":26,"default":117,"properties":118},"Human-readable status message; `\"success\"` on a successful call.","success",[],{"name":120,"required":19,"type":121,"description":122,"nullable":26,"properties":123},"server_time","string · date-time","Server-side timestamp when the response was produced, in ISO 8601 format (UTC).",[],{"data":125,"server_time":131,"message":117},{"videos":126,"next_cursor":29},[127],{"model_id":128,"status":117,"video_id":129,"aspect_ratio":41,"cost_credit":29,"cover_url":130,"created_at":29,"duration_sec":29},"vs_character_v4","video_123456","https:\u002F\u002Fexample.com\u002Fmedia\u002Finput.mp4","2026-08-24T08:00:00Z",{"status":133,"description":134,"contentType":38,"schema":135,"example":155},"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":136,"description":41,"nullable":26,"properties":137},"ErrorResponse",[138],{"name":83,"required":19,"type":139,"description":41,"nullable":26,"properties":140},"ErrorDetail",[141,144,148,152],{"name":88,"required":19,"type":28,"description":142,"nullable":26,"properties":143},"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":145,"required":26,"type":70,"description":146,"nullable":19,"properties":147},"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":149,"required":26,"type":70,"description":150,"nullable":19,"properties":151},"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":92,"required":19,"type":21,"description":153,"nullable":26,"properties":154},"Human-readable explanation of what went wrong. Safe to log or surface to end users; not localized.",[],{"error":156},{"code":157,"message":21,"details":21,"hint":21},1,[159],{"APIKeyHeader":160},[],[162,165],{"lang":163,"source":164},"Python","import os\nimport requests\n\nresponse = requests.get(\n    \"https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fai_videos\",\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":166,"source":167},"cURL","curl --request GET 'https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fai_videos?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\">import\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> os\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FF7B72\">import\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> requests\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">response \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> requests.get(\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#A5D6FF\">    \"https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fai_videos\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFA657\">    headers\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">{\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"X-API-Key\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: os.environ[\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"VISIONSTORY_API_KEY\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">]},\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFA657\">    params\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">{\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#A5D6FF\">      \"cursor\"\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:#A5D6FF\">      \"limit\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\">20\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\">response.raise_for_status()\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79C0FF\">print\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(response.json())\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\">        \"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\">        \"status\"\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\">        \"video_id\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \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:#7EE787\">        \"aspect_ratio\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"\"\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\">0\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">        \"cover_url\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"https:\u002F\u002Fexample.com\u002Fmedia\u002Finput.mp4\"\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\">0\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>\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\">  \"server_time\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"2026-08-24T08:00:00Z\"\u003C\u002Fspan>\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>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">}\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",1788166855865]