列出可用的 AI 视频模型，包括每个参数的可选值与默认值，以及 first_frame 和多模态 refs 的媒体限制。不包含价格；请调用 GET /api/v1/ai_video/cost 获取准确的费用估算。
Beta：所有有效付费订阅账户均可使用，适用标准的单 API Key 请求频率限制。
请求头
X-API-Keystring必填你的 VisionStory API Key（sk-vs-...），请仅保存在服务端。可在 API Key 管理 中创建或管理，需要 Pro 或更高方案。
响应
200请求成功
application/json
dataGetAiVideoModelsResponse | null必填可为空当前接口的响应数据，字段定义见该接口的响应结构。仅当操作不返回数据时为 null。
modelsAiVideoModelDto[]必填机器可读的模型能力，包括各参数的可选值与默认值，以及媒体限制。不包含价格，请调用 GET /api/v1/ai_video/cost。
capabilitiesstring[]必填支持的生成模式，例如 text_to_video 和 image_to_video。
descriptionstring必填模型的公开简介。
model_idstring必填AI 视频请求使用的公开模型 ID。
paramsAiVideoModelParams必填aspect_ratioStringChoices必填defaultstring | null必填可为空请求省略此参数时使用的值。
valuesstring[]必填此模型当前接受的值。
duration_secDurationChoices必填defaultinteger | null必填可为空省略参数时使用的视频时长。
valuesinteger[]必填接受的视频时长整数值，单位为秒。
first_frameMediaConstraints | null必填可为空首帧图像限制；不支持图生视频时为 null。
aspect_ratio_range[number | integer | null, number | integer | null] | null可为空宽高比的最小值与最大值。
dimension_px[integer | null, integer | null] | null可为空每条边的最小与最大像素长度。
duration_sec_range[number | integer | null, number | integer | null] | null可为空单个参考素材的最短和最长时长，单位为秒。
formatsstring[] | null可为空此媒体输入接受的文件扩展名。
fps_range[number | integer | null, number | integer | null] | null可为空最低与最高帧率；上限为 null 时表示没有上限。
max_mbinteger | null可为空媒体文件的最大大小，单位为 MiB，已包含网关限制。
generate_audioAudioCapability必填defaultboolean必填省略参数时是否生成原生音轨；不影响价格。
promptPromptCapability必填max_lengthinteger | null必填可为空提示词的最大字符数；未指定时为 null。
supports_ref_syntaxboolean | null可为空支持在提示词中使用参考素材引用语法时返回。
refsVideoReferences必填acceptstring[]必填接受的媒体类型：image、video 或 audio。
audioMediaConstraints必填aspect_ratio_range[number | integer | null, number | integer | null] | null可为空宽高比的最小值与最大值。
dimension_px[integer | null, integer | null] | null可为空每条边的最小与最大像素长度。
duration_sec_range[number | integer | null, number | integer | null] | null可为空单个参考素材的最短和最长时长，单位为秒。
formatsstring[] | null可为空此媒体输入接受的文件扩展名。
fps_range[number | integer | null, number | integer | null] | null可为空最低与最高帧率；上限为 null 时表示没有上限。
max_mbinteger | null可为空媒体文件的最大大小，单位为 MiB，已包含网关限制。
imageMediaConstraints必填aspect_ratio_range[number | integer | null, number | integer | null] | null可为空宽高比的最小值与最大值。
dimension_px[integer | null, integer | null] | null可为空每条边的最小与最大像素长度。
duration_sec_range[number | integer | null, number | integer | null] | null可为空单个参考素材的最短和最长时长，单位为秒。
formatsstring[] | null可为空此媒体输入接受的文件扩展名。
fps_range[number | integer | null, number | integer | null] | null可为空最低与最高帧率；上限为 null 时表示没有上限。
max_mbinteger | null可为空媒体文件的最大大小，单位为 MiB，已包含网关限制。
maxinteger必填所有媒体类型的参考素材总数上限；为 0 表示不支持参考素材。
max_per_kindReferenceKindLimits | null可为空除总数上限 max 外，可选的各媒体类型数量限制。
audiointeger | null可为空指定时表示音频参考素材的数量上限。
imageinteger | null可为空指定时表示参考图像的数量上限。
videointeger | null可为空指定时表示视频参考素材的数量上限。
total_duration_sec_maxReferenceDurationLimits | null可为空可选的按媒体类型划分的总时长限制。
audionumber | integer | null可为空所有音频参考素材的总时长上限，单位为秒。
videonumber | integer | null可为空所有视频参考素材的总时长上限，单位为秒。
videoMediaConstraints必填aspect_ratio_range[number | integer | null, number | integer | null] | null可为空宽高比的最小值与最大值。
dimension_px[integer | null, integer | null] | null可为空每条边的最小与最大像素长度。
duration_sec_range[number | integer | null, number | integer | null] | null可为空单个参考素材的最短和最长时长，单位为秒。
formatsstring[] | null可为空此媒体输入接受的文件扩展名。
fps_range[number | integer | null, number | integer | null] | null可为空最低与最高帧率；上限为 null 时表示没有上限。
max_mbinteger | null可为空媒体文件的最大大小，单位为 MiB，已包含网关限制。
resolutionStringChoices必填defaultstring | null必填可为空请求省略此参数时使用的值。
valuesstring[]必填此模型当前接受的值。
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必填便于阅读的错误原因说明，可安全记录到日志或展示给最终用户；此返回值未本地化。