PopNow API 如何運作

API 能做什麼、貫穿所有頁面的五個概念，以及建議的閱讀順序。

PopNow API 讓你自己的軟體也能使用 popnow.ai 上的圖片、影片與音訊模型。同樣的模型、同樣的價格、同樣的點數——只是從點按鈕變成用程式呼叫。

能做什麼

產出	例子
圖片	文字生成圖片、以一張或多張參考圖修圖、放大、去背、圖層拆分
影片	文字生成影片、圖片生成影片、首尾影格影片、參考影片、影片延長與編輯、對嘴、虛擬主播
音訊	音樂、音效、文字轉語音、為現有影片配上音效、語音轉文字

完整清單與每個模型的 ID、價格都在模型頁。API 只涵蓋圖片、影片與音訊生成，不包含聊天與文字模型。

貫穿全站的五個概念

模型 ID

每個可呼叫的項目都有一個 <出品方>/<型號>/<任務> 形式的 ID，例如 alibaba/wan-3.0/image-to-video 或 google/nano-banana-2.1/edit。每個請求都把它填在 model 欄位。圖片編輯一律以 /edit 結尾。PopNow 自家的工具（例如去背）出品方寫成 popnow。

任務

生成需要幾秒到幾分鐘，所以每個請求都會建立一個任務。你會立刻拿到 taskId，等結果好了再讀取。任務會經過 queued → running → 一個終止狀態：succeeded、failed 或 expired。詳見任務。

點數

API 使用的是和網站同一份點數。基準價下 1 點 = $0.01。任務受理時先保留它可能的最高價格；完成後依實際金額扣點（不會超過保留額），其餘退回。失敗的任務不收費。詳見點數與計費。

冪等鍵

網路逾時並不會告訴你伺服器到底有沒有收到請求。每次建立任務都帶上 Idempotency-Key 標頭，用同一個鍵重試時拿回的就是原本的任務，不會再生成、再扣點一次。詳見冪等。

Webhook

與其一再查詢任務，不如給它一個 callBackUrl。任務完成時，PopNow 會把完整結果送到這個網址，並附上簽章，讓你確認訊息確實來自我們。詳見 Webhook。

請求長什麼樣子

POST https://api.popnow.ai/api/v1/jobs/createTask
Authorization: Bearer sk-popnow-...
Idempotency-Key: 7d0c9a52-...

{ "model": "alibaba/wan-3.0/image-to-video",
  "input": { "image_url": "https://…/photo.jpg", "prompt": "The waves roll in slowly" },
  "callBackUrl": "https://your-app.example.com/hooks/popnow" }

所有回應都使用同一個外層：{ "code", "msg", "data", "request_id" }，code: 200 代表成功。

建議閱讀順序

快速入門：五分鐘取得第一個結果。
驗證：如何保管金鑰，以及限制它能做的事。
模型：挑一個模型，讀懂它的參數。
任務與 Webhook：完整的生命週期。
上傳與下載：傳送你自己的圖片、影片與音訊。
錯誤碼與速率限制：上線前必讀。

想在寫程式前先試試模型？popnow.ai 上每個模型的 API 頁面都有 Playground，直接用你的帳戶執行，不需要金鑰。

PopNow API 如何運作

本頁內容