參考
主要內容API 參考
PopNow API 的所有端點一頁看完，並附完整 OpenAPI 合約的連結。
完整、機器可讀的合約是 openapi.yaml（OpenAPI 3.1）。可以匯入 Postman、Insomnia 或程式碼產生器，也可以直接交給 AI 代理。本頁是給人看的總覽。
- Base URL：
https://api.popnow.ai/api/v1（OpenAI 相容路由：https://api.popnow.ai/v1） - **驗證：**每個請求都帶
Authorization: Bearer sk-popnow-… - 外層：
{ "code", "msg", "data", "request_id" }；code: 200代表成功 - **金額：**整數點數（
credits、maxCredits…），並附上等額的美元字串；1 點 = $0.01
任務
| 方法與路徑 | 作用 | 頁面 |
|---|---|---|
POST /jobs/createTask | 建立生成任務（可選 ?wait=，最多 60 秒） | 任務 |
GET /jobs/recordInfo?taskId= | 讀取任務狀態與結果 | 任務 |
GET /jobs | 列出這把金鑰的任務 | 任務 |
POST /jobs/quote | 不執行，只報價 | 點數與計費 |
POST /jobs/retry | 以失敗或過期的任務建立新任務 | 任務 |
POST /jobs/purge | 刪除已結束任務的內容 | 任務 |
模型
檔案與素材
| 方法與路徑 | 作用 | 頁面 |
|---|---|---|
POST /common/upload-url | 直接上傳的票證 | 上傳與下載 |
POST /files/{fileId}/commit | 完成上傳並取得 popnow:// URI | 上傳與下載 |
POST /files/import | 從連結匯入 LoRA 檔案 | 素材庫 |
POST /common/download-url | 為任務產出產生新的簽名連結 | 上傳與下載 |
GET /assets, POST /assets | 列出或儲存素材 | 素材庫 |
GET, PATCH, DELETE /assets/{assetId} | 讀取、重新命名或刪除單一素材 | 素材庫 |
GET /assets/entities | 你的角色 | 素材庫 |
GET /assets/usage | 儲存方案與用量 | 素材庫 |
帳戶
OpenAI Videos 相容（/v1）
| 方法與路徑 | 作用 | 頁面 |
|---|---|---|
POST /v1/videos | 建立影片任務 | OpenAI Videos |
GET /v1/videos/{id} | 讀取它 | OpenAI Videos |
GET /v1/videos/{id}/content | 重新導向到檔案 | OpenAI Videos |
GET /v1/models | OpenAI 格式的模型清單 | OpenAI Videos |