列出可用于数字人视频的渲染模型。每项包含支持的宽高比、分辨率和最大视频时长。将模型的 model_id 传入 POST /api/v1/video。
请求头
X-API-Keystring必填你的 VisionStory API Key（sk-vs-...），请仅保存在服务端。可在 API Key 管理 中创建或管理，需要 Pro 或更高方案。
响应
200请求成功
application/json
dataGetModelsResponse | null必填可为空当前接口的响应数据，字段定义见该接口的响应结构。仅当操作不返回数据时为 null。
modelsModelDto[]必填可用的数字人渲染模型及其支持的选项。
aspect_ratiosstring[]此模型可渲染的宽高比。创建视频时，将其中一个值作为 aspect_ratio 传入。
descriptionstring必填便于阅读的模型优势及适用场景简介。
max_duration_secondsinteger必填此模型单次请求可生成的最长视频时长，单位为秒。
model_idstring必填稳定的模型标识符。创建视频时作为 model_id 传入，例如 vs_character_v4。已退役的 vs_talk_* ID 仍可使用，并会自动映射到 vs_character_v4。
resolutionsstring[]此模型支持的输出分辨率；将其中一个值作为 resolution 传入。更高的分辨率消耗更多点数，渲染时间也更长。
messagestring便于阅读的状态消息；调用成功时为 "success"。
server_timestring · date-time必填服务端生成响应时的时间戳，使用 ISO 8601 格式（UTC）。
default错误响应。所有失败均使用统一结构：error 对象包含数字错误码 code、便于阅读的 message、可选的 details 字符串，以及提供后续处理建议的可选 hint（便于 AI Agent 使用）。
application/json
errorErrorDetail必填codeinteger必填机器可读的错误码。传输层失败时对应 HTTP 状态码（例如 401、404、422、500），其他情况可能使用业务专用错误码。
detailsstring | null可为空可选的结构化错误详情，例如 422 响应中逐字段校验错误的 JSON 字符串。无补充信息时不返回。
hintstring | null可为空供用户和 AI Agent 参考的错误处理建议，例如如何修正请求或在哪里获取 API Key。可能不返回此字段。
messagestring必填便于阅读的错误原因说明，可安全记录到日志或展示给最终用户；此返回值未本地化。