[{"data":1,"prerenderedAt":152},["ShallowReactive",2],{"reference-detail-zh-get_models_api_v1_models_get":3,"developer-code-1e8ddw0":150,"developer-code-hj8rg7":151},{"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":22,"security":137,"codeSamples":140},"Models","models","GET","\u002Fapi\u002Fv1\u002Fmodels","get-models","列出数字人模型","列出可用于数字人视频的渲染模型。每项包含支持的宽高比、分辨率和最大视频时长。将模型的 `model_id` 传入 POST \u002Fapi\u002Fv1\u002Fvideo。","get_models_api_v1_models_get",40,"\u003Cp>列出可用于数字人视频的渲染模型。每项包含支持的宽高比、分辨率和最大视频时长。将模型的 \u003Ccode>model_id\u003C\u002Fcode> 传入 POST \u002Fapi\u002Fv1\u002Fvideo。\u003C\u002Fp>",[15],{"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",[23,107],{"status":24,"description":25,"contentType":26,"schema":27,"example":84,"examples":97,"headers":106},"200","请求成功","application\u002Fjson",{"type":28,"description":29,"nullable":30,"properties":31},"BaseSuccessResponse_GetModelsResponse_","",false,[32,74,79],{"name":33,"required":18,"type":34,"description":35,"nullable":18,"properties":36},"data","GetModelsResponse | null","当前接口的响应数据，字段定义见该接口的响应结构。仅当操作不返回数据时为 null。",[37],{"name":5,"required":18,"type":38,"description":39,"nullable":30,"properties":40,"items":41},"ModelDto[]","可用的数字人渲染模型及其支持的选项。",[],{"type":42,"description":29,"nullable":30,"properties":43},"ModelDto",[44,51,55,60,64],{"name":45,"required":30,"type":46,"description":47,"nullable":30,"properties":48,"items":49},"aspect_ratios","string[]","此模型可渲染的宽高比。创建视频时，将其中一个值作为 `aspect_ratio` 传入。",[],{"type":20,"description":29,"nullable":30,"properties":50},[],{"name":52,"required":18,"type":20,"description":53,"nullable":30,"properties":54},"description","便于阅读的模型优势及适用场景简介。",[],{"name":56,"required":18,"type":57,"description":58,"nullable":30,"properties":59},"max_duration_seconds","integer","此模型单次请求可生成的最长视频时长，单位为秒。",[],{"name":61,"required":18,"type":20,"description":62,"nullable":30,"properties":63},"model_id","稳定的模型标识符。创建视频时作为 `model_id` 传入，例如 `vs_character_v4`。已退役的 `vs_talk_*` ID 仍可使用，并会自动映射到 `vs_character_v4`。",[],{"name":65,"required":30,"type":46,"description":66,"nullable":30,"properties":67,"items":68},"resolutions","此模型支持的输出分辨率；将其中一个值作为 `resolution` 传入。更高的分辨率消耗更多点数，渲染时间也更长。",[],{"type":20,"description":29,"nullable":30,"enum":69,"properties":73},[70,71,72],"720p","1080p","2k",[],{"name":75,"required":30,"type":20,"description":76,"nullable":30,"default":77,"properties":78},"message","便于阅读的状态消息；调用成功时为 `\"success\"`。","success",[],{"name":80,"required":18,"type":81,"description":82,"nullable":30,"properties":83},"server_time","string · date-time","服务端生成响应时的时间戳，使用 ISO 8601 格式（UTC）。",[],{"data":85,"message":77,"server_time":96},{"models":86},[87],{"aspect_ratios":88,"description":92,"max_duration_seconds":93,"model_id":94,"resolutions":95},[89,90,91],"9:16","16:9","1:1","Character Model v4 provides improved motion quality and stability.",600,"vs_character_v4",[70,71,72],"2026-09-04T00:00:00Z",[98],{"name":77,"description":99,"summary":25,"value":100},"示例仅用于说明响应结构，不代表实时账户数据或实际报价。ID 和 URL 均为占位内容。请调用模型查询及费用估算接口，获取当前可用模型和价格。",{"data":101,"message":77,"server_time":96},{"models":102},[103],{"aspect_ratios":104,"description":92,"max_duration_seconds":93,"model_id":94,"resolutions":105},[89,90,91],[70,71,72],[],{"status":108,"description":109,"contentType":26,"schema":110,"example":133,"headers":136},"default","错误响应。所有失败均使用统一结构：`error` 对象包含数字错误码 `code`、便于阅读的 `message`、可选的 `details` 字符串，以及提供后续处理建议的可选 `hint`（便于 AI Agent 使用）。",{"type":111,"description":29,"nullable":30,"properties":112},"ErrorResponse",[113],{"name":114,"required":18,"type":115,"description":29,"nullable":30,"properties":116},"error","ErrorDetail",[117,121,126,130],{"name":118,"required":18,"type":57,"description":119,"nullable":30,"properties":120},"code","机器可读的错误码。传输层失败时对应 HTTP 状态码（例如 401、404、422、500），其他情况可能使用业务专用错误码。",[],{"name":122,"required":30,"type":123,"description":124,"nullable":18,"properties":125},"details","string | null","可选的结构化错误详情，例如 422 响应中逐字段校验错误的 JSON 字符串。无补充信息时不返回。",[],{"name":127,"required":30,"type":123,"description":128,"nullable":18,"properties":129},"hint","供用户和 AI Agent 参考的错误处理建议，例如如何修正请求或在哪里获取 API Key。可能不返回此字段。",[],{"name":75,"required":18,"type":20,"description":131,"nullable":30,"properties":132},"便于阅读的错误原因说明，可安全记录到日志或展示给最终用户；此返回值未本地化。",[],{"error":134},{"code":135,"message":20,"details":20,"hint":20},1,[],[138],{"APIKeyHeader":139},[],[141,144,147],{"lang":142,"source":143},"SDK","from visionstory import VisionStoryClient\n\nclient = VisionStoryClient.from_env()\nmodels = client.list_models()\nprint(models)",{"lang":145,"source":146},"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\u002Fmodels', headers=headers\n)\nresp_data = response.json()\nprint(resp_data['data'])",{"lang":148,"source":149},"cURL","curl -X 'GET' \\\n      'https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fmodels' \\\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\">models \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> client.list_models()\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79C0FF\">print\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(models)\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\">    \"models\"\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_ratios\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: [\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#A5D6FF\">          \"9:16\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#A5D6FF\">          \"16:9\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#A5D6FF\">          \"1:1\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">        ],\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">        \"description\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"Character Model v4 provides improved motion quality and stability.\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">        \"max_duration_seconds\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\">600\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\">        \"resolutions\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: [\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#A5D6FF\">          \"720p\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#A5D6FF\">          \"1080p\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#A5D6FF\">          \"2k\"\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:#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>",1788547144489]