模型列表

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 時，解析度與單價以所選檔為準
specs[].credits	該檔單價。影片按 billing 計費：per_sec 乘時長，per_unit 不乘時長
specs[].min_sec / max_sec	該檔允許的長度區間（秒）。超出範圍的 duration 會被自動夾到邊界

生圖／生影片不傳 model 時平台會用預設模型，但預設模型可能隨平台調整而變化，對穩定性有要求請明確指定。type=text 的項目用於 /v1/chat/completions，那個介面的 model 必填、沒有預設值。