获取模型列表 - VidoCraft API 文档

GET/api/v1/models

返回全部可用模型：复合 id、基础积分价格和参数 schema。id 形如 <scene>:<model>，创建任务时作为 model 传入。

高级模型始终会列出，但账户没有有效订阅时标记为 available: false。每个条目的 params 数组描述 input 对象接受的键——类型、是否必填、枚举值与数值范围。

部分选项同样需要订阅，通常是更高的分辨率和质量档：参数 oneOf 里的每个选项也带 premium 与 available。标记 premium: true 的参数，没有订阅时只能保持默认值。default 是你的账户省略该参数时实际使用的值——没有订阅时，若默认值是高级选项，会改用第一个可用的选项。

图片、视频、音频参数还带有一个 media 对象，列出它们的限制：kind（素材类型）、是接收列表（multiple）还是首尾帧（frames）、maxItems、maxFileSize（字节）、accept（MIME 类型），视频和音频另有 minDuration / maxDuration / maxTotalDuration（秒）；部分图片参数还有 minWidth / minHeight（像素）和 minAspectRatio / maxAspectRatio（宽 ÷ 高），超出范围的图片会在扣费前以 invalid_request 拒绝。这些参数的值必须是 POST /api/v1/uploads 返回的链接。

与某个素材参数共享合计上限的数量参数会带上 sharedLimit: { with, total }，例如 Seedream 的 max_images 为 { "with": "image_input", "total": 15 }：参考图张数加 max_images 不能超过 15。

可选查询参数：?mediaType=image|video|audio|music

curl "https://vidocraft.com/api/v1/models?mediaType=image" \
  -H "Authorization: Bearer sk_test_xxxxxxxx"

{
  "count": 42,
  "models": [
    {
      "id": "text-to-image:rikcgfbufzdm",
      "scene": "text-to-image",
      "mediaType": "image",
      "model": "rikcgfbufzdm",
      "premium": false,
      "available": true,
      "creditCost": 1,
      "params": [
        { "key": "prompt", "type": "string", "required": true },
        { "key": "aspect_ratio", "type": "string", "required": false,
          "enum": ["1:1", "16:9", "9:16", "4:3", "3:4"] }
      ]
    }
  ]
}