模型列表

GET /v1/models

返回当前可用的生图与生视频模型。只列出平台已配置好凭据且处于启用状态的模型，所以这份列表随时可能变化——建议在应用启动时拉一次，不要把 id 写死。

请求

bash

curl https://open.pikpikgo.com/v1/models \
  -H "Authorization: Bearer $PIKPIK_API_KEY"

json

{
  "object": "list",
  "data": [
    {
      "id": "img-std-1",
      "object": "model",
      "type": "image",
      "credits": 10,
      "max_reference_images": 4,
      "specs": [
        { "key": "2k", "name": "2K", "resolution": "2k", "quality": "2k", "credits": 10, "min_sec": 0, "max_sec": 0 }
      ]
    }
  ]
}

字段说明

字段	说明
id	模型标识。下单时 model 参数传这个值；传列表里没有的 id 会直接报错，不会静默换成默认模型
type	image=生图 / video=生视频 / text=文本
credits	模型顶层单价。生图/生视频实际以 specs[].credits 为准，价格为 0 的规格不会下发
max_reference_images	最多能传几张参考图。0 表示该模型不支持参考图
aspect_ratios	仅视频返回。该模型支持的画面比例；空数组表示不限。传了不在列表里的比例会被拒单
supports_last_frame	仅视频返回。false 表示该模型只收首帧，传 image_last 会被拒单
max_reference_videos	仅视频返回。最多能传几段参考视频。0 表示该模型不支持
max_reference_audios	仅视频返回。最多能传几段参考音频。0 表示该模型不支持
specs	规格档位。传了 spec 时，分辨率与单价以所选档为准
billing	仅视频返回。per_sec=按秒计费，per_unit=按次一口价
specs[].credits	该档单价。视频按 billing 计费：per_sec 乘时长，per_unit 不乘时长
specs[].min_sec / max_sec	该档允许的时长区间（秒）。超出范围的 duration 会被自动夹到边界

生图/生视频不传 model 时平台会用默认模型，但默认模型可能随平台调整而变化，对稳定性有要求请显式指定。type=text 的项用于 /v1/chat/completions，那个接口的 model 必填、没有默认值。