AI 影片生成 · 流程速覽（JS 管線） / Wizardx07

①四步流程

JS 管線(一支 Node 腳本)會自動把這四步一次跑完：上傳圖 → 建任務 → 輪詢 → 下載。

flowchart LR
    P["📜 prompt.txt 劇本"] --> GEN
    R["🖼️ refs/ 參考圖"] --> UP["⬆️ 上傳 換成公開 URL"]
    UP --> GEN["🎬 建生成任務"]
    GEN --> T["🎟️ task_id"]
    T --> POLL["🔁 輪詢狀態"]
    POLL --> DL["⬇️ 下載 .mp4"]
    DL --> OUT["✅ 成片 video.mp4"]
    style OUT fill:#16241b,stroke:#8ef6c8,color:#f1e7d0

②它跟伺服器之間發生什麼

把腳本與 apimart.ai 之間的對話攤開看，就是「送出 → 拿編號 → 一直問 → 取件」：

sequenceDiagram
    autonumber
    participant U as JS 管線 (seedance.mjs)
    participant API as apimart.ai

    U->>API: POST /v1/uploads/images（參考圖）
    API-->>U: 回圖片公開 URL
    U->>API: POST /v1/videos/generations（劇本 + 圖 URL + 參數）
    API-->>U: 回 task_id（任務編號）
    loop 每 5 秒問一次
        U->>API: GET /v1/tasks/{task_id}
        API-->>U: pending → processing → completed
    end
    U->>API: 取影片 URL
    API-->>U: 影片檔 (.mp4)
    Note over U: 自動存到本地

③四步在做什麼

上傳參考圖：生成服務只吃圖片「網址」，所以腳本先把本地圖上傳，換成公開 URL。
建生成任務：把劇本、圖片 URL 和參數送出，伺服器立刻回一個 task_id，不等影片算完。
輪詢：拿著 task_id 每隔幾秒問一次「好了嗎」，直到狀態變 completed。
下載：取得影片 URL，馬上把檔案存到本地（URL 會過期）。

💡 為什麼要「輪詢」影片要算好幾分鐘，連線不可能一直掛著等。所以做成非同步：先拿一張「取件單」(task_id)，再每隔幾秒回去問好了沒——這個重複問的動作就叫輪詢。

💸 先便宜驗證每跑一次都會扣費。先用便宜檔(fast + 720p)確認效果，對了再升全品質。

想看實際怎麼下指令、各參數怎麼調、以及「參考圖 → 成片」的實際範例影片，請看完整教學頁（JS 管線）。