指南：把圖片變成影片

影片需要幾分鐘而不是幾秒，所以影片整合的核心是任務與 Webhook，而不是一個一直等待的請求。這篇指南用真實的模型 ID 說明常見的做法。

讓一張圖動起來

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "alibaba/wan-3.0/image-to-video",
    "input": {
      "image_url": "https://media.popnow.ai/movie/lighthouse.webp",
      "prompt": "Waves roll in slowly, clouds drift, the camera pushes gently toward the lighthouse",
      "resolution": "480p",
      "duration_seconds": 5
    },
    "callBackUrl": "https://your-app.example.com/hooks/popnow"
  }'

你會立刻收到帶有 taskId 的 202。幾分鐘後，Webhook 會送來完成的任務，你也可以用 recordInfo 讀取。影片在 output.assets[0]，附有 durationSeconds、width 與 height。

要花多少

多數影片模型依輸出秒數計費，解析度越高單價越高。以 alibaba/wan-3.0/image-to-video 為例：480p 每秒 6.75 點，720p 每秒 13.5 點，1080p 每秒 27 點——所以上面的請求會保留 34 點（5 × 6.75，無條件進位），成功時也扣這麼多。

• 調整提示詞時先用最低解析度與較短長度，定稿時再調高。
• 顯示價格給使用者之前，先用 jobs/quote 取得確切數字。
• 失敗或過期的影片不收費。

指定首影格與尾影格

許多圖片生成影片的模型也接受 last_image_url。影片從 image_url 開始，並且正好停在 last_image_url——適合做變身效果，或首尾用同一張圖做出無縫循環。

參考影片：讓角色或產品保持一致

reference-to-video 模型不是讓指定的首影格動起來，而是圍繞一張或多張參考圖（部分模型也接受參考影片或音訊）打造新的場景：

{
  "model": "minimax/h3/reference-to-video",
  "input": {
    "prompt": "The same lighthouse at night, its beam sweeping over a calm sea while the camera circles slowly",
    "reference_image_urls": ["https://media.popnow.ai/movie/lighthouse.webp"],
    "duration_seconds": 6
  }
}

每個模型在提示詞中如何指稱參考素材都不同；它參考頁上的欄位說明會寫清楚。

讓片段更長

video-extend 模型會從現有片段的最後一個影格接著往下拍。把片段放進 video_url，再描述接下來發生的事：

{
  "model": "minimax/h3/video-extend",
  "input": {
    "video_url": "https://media.popnow.ai/showcase/moon-picnic-loop.mp4",
    "prompt": "The camera keeps drifting right as the picnic blanket ripples in the breeze"
  }
}

會把前後接起來的延長模型回傳兩個檔案：先是接好的完整影片（role: "video"），再是單獨的新片段（role: "segment"）。

聲音

有 generate_audio 的模型會為影片配上聲音；部分模型關閉它可以便宜一些。想替現有影片加上聲音，可用 popnow/foley-v1/video-to-audio，它會回傳同一段影片並配上生成的聲音。

好用的影片提示詞

描述動態，而不只是場景：什麼在動、動得多快、鏡頭怎麼移動。「鏡頭緩緩推近，人物轉向光源」給了模型可以做的事；「一座美麗的燈塔」則沒有。圖片已經說明了東西長什麼樣——把字數花在「變化」上。

正式環境的做法

1. 上傳或儲存來源圖片，記下它的 popnow:// URI。
2. 先報價並顯示價格，再以從你自己的工作 ID 推導出的 Idempotency-Key 與 callBackUrl 呼叫 createTask。
3. 在 Webhook 中驗證簽章、先回覆收到，再把影片下載到你自己的儲存空間。
4. 每天用 GET /api/v1/jobs 列出近期任務一次，補讀沒收到 Webhook 的那些。

其餘事項請見上線檢查清單。