API 文件

平台介紹

把站內的生圖與生影片能力直接接進你自己的產品。

開放平台把創作台裡那套生成能力原樣開放出來:同一批模型、同一套計費口徑、同一條算圖流程。你在網頁裡能出的圖、能出的片,用金鑰呼叫介面一樣能出,產物同時落進你帳號的素材庫。

能做什麼

文生圖 / 圖生圖支援參考圖、畫面比例與 1K/2K/4K 清晰度檔,單次最多 4 張。
文生影片 / 圖生影片支援首尾影格、參考圖與多檔解析度,長度依所選規格檔夾取。
模型自選平台上架的模型都能用,呼叫前先查 /v1/models 取得可用 id 與單價。
算力自查隨時查詢帳戶可用算力,避免任務送到一半才發現餘額不夠。

介面設計

介面風格貼近 OpenAI:金鑰形如 sk- 開頭的長字串,統一放在 Authorization: Bearer 裡;路徑以 /v1 開頭;出錯時回傳結構固定的 error 物件。用過 OpenAI SDK 的話,改個 baseURL 與路徑就能上手。

出圖有同步與非同步兩種用法:預設同步,等圖出完才回應,回傳形狀與 OpenAI 的 images/generations 一致,OpenAI SDK 與各類中轉閘道可以直接把本站當相容通道掛上去;在請求裡加 async: true 則改為非同步,送出即取得任務 id,再用 GET /v1/tasks/{id} 取結果。

出影片只有非同步一種:出片以分鐘計,同步等待會把連線壓在閘道逾時邊緣,逾時重試還會重複計費。跑批、排隊量大或對延遲敏感的場景,出圖也建議走非同步。

所有介面的基底位址:https://open.pikpikgo.com/v1

下一步