產品影片

產品影片 是做什麼的？

將產品（最好附上照片）轉換成短影片片段。請使用使用者所使用的語言回覆。所有價格均以美元（USD）計價。

1. 收集簡報

僅詢問缺少的項目：

• 產品：產品是什麼、材質、顏色、尺寸、一個要展示的特色。
• 產品照片：一個公開的 https 連結，指向一張乾淨的照片。本機檔案和私人連結無法使用；使用者必須先將圖片託管在公開的 HTTPS URL 上。
• 使用場合：這將設定長寬比。
  • TikTok、Reels、Shorts、限時動態：9:16
  • 網站主視覺、YouTube、登陸頁面：16:9
  • 市集商品頁面、動態消息貼文：1:1（如果模型有此選項）
• 長度與預算：大多數片段長度為 5 到 10 秒。如果影片較長，請規劃數個短片，而非一個長片。

2. 選擇模型與模式

呼叫 list_models，然後再次呼叫並將 model 設為候選 ID，以查看其 modes、aspect_ratios、durations、options 和 max_prompt_chars。

• 有照片可用：使用 i2v 模式，並將照片設為 image_url。這能保留真實產品的形狀、標籤和顏色。
• 多張參考照片（從不同角度拍攝的產品）：如果模型有 r2v 模式，則使用它，並附上 reference_images，確保不超過 max_references。
• 沒有照片：使用 t2v 模式，並精確描述產品。
• 如果模型在 options 中列出了 negative_prompt，你可以用它來排除如「變形標籤、多餘零件、模糊」等情況。

3. 撰寫提示詞

一個片段，一個鏡頭。按以下順序建構提示詞：

1. 主體：精確的產品，包含材質和顏色（例如「一個霧面黑色陶瓷咖啡杯，搭配軟木底座」）。
2. 動作或鏡頭運動：僅一個動作，例如緩慢推近、流暢的 360 度環繞、俯視揭曉、微距橫掃紋理、手將其拿起。
3. 場景與光線：表面、背景、光線（例如「放在淺色橡木桌上，柔和晨光透過窗戶，淺景深」）。
4. 風格與節奏：例如「乾淨的商業風格，節奏平穩」。

提示：

• 不要要求模型渲染文字、價格或標誌，因為它們常常會變得難以辨識。請稍後在編輯器中加入文字。
• 使用 i2v 時，只描述動作和場景，不需再次描述產品外觀；照片已經定義了它。
• 請勿超過 max_prompt_chars。

範例：

一個霧面黑色陶瓷咖啡杯，搭配軟木底座，放在淺色橡木桌上，蒸氣裊裊升起，攝影機緩緩推近，柔和晨光透過窗戶，淺景深，乾淨的商業風格，節奏平穩。

4. 解析度與價格

• 先以 720p 繪製草稿來檢查動作和構圖；成本較低。最終版本再以 1080p 製作，用於網站、廣告或大螢幕。720p 通常已足夠用於手機動態消息。

• 針對草稿和最終選項呼叫 estimate_cost，並在執行任何任務前向使用者顯示兩種價格：

  {"input": {"model": "<模型 ID>", "mode": "i2v", "prompt": "一個霧面黑色陶瓷咖啡杯放在淺色橡木桌上，蒸氣裊裊升起，攝影機緩緩推近，柔和晨光", "image_url": "https://example.com/mug.jpg", "duration": 5, "resolution": "720p", "aspect_ratio": "9:16"}}
  

5. 在使用者同意後生成

只有在使用者看到價格並表示同意後，才能呼叫 generate。如果使用者已經設定了預算並指示你繼續進行，只要 amount_usd 在該預算範圍內，你可以直接開始而無需再次詢問；但仍應使用 amount_usd，而非預算，作為 max_cost_usd。

• max_cost_usd：必填。使用 estimate_cost 回傳的已核准 amount_usd，確切值。如果價格更高，任務將被拒絕。
• request_id：必填，且每個新任務必須是唯一值，可列印的 ASCII 字元，不含空格，最多 64 個字元，例如 mug-orbit-720p-1。已使用過的 ID 不得重複用於不同的任務。
• 如果 generate 因網路錯誤、超時、系統錯誤或「請求過多」而失敗，請等待幾秒鐘，然後使用相同的 input、相同的 max_cost_usd 和相同的 request_id 重試。相同的 ID 會回傳相同的任務，且絕不會被重複收費。

{"input": {"model": "<模型 ID>", "mode": "i2v", "prompt": "一個霧面黑色陶瓷咖啡杯放在淺色橡木桌上，蒸氣裊裊升起，攝影機緩緩推近，柔和晨光", "image_url": "https://example.com/mug.jpg", "duration": 5, "resolution": "720p", "aspect_ratio": "9:16"}, "max_cost_usd": "<來自 estimate_cost 的 amount_usd>", "request_id": "mug-orbit-720p-1"}

使用 check_job 並傳入 job_id 和設為 55 的 wait_s 來等待；如果任務仍在執行中，請遵循 next_step 並再次呼叫，wait_s 設為 55。不要緊密迴圈輪詢。

成功時，從 outputs 和 console_url 取得結果連結。連結會在 24 小時後過期；check_job 會回傳新的連結。如果某個輸出的 state 為 blocked 且沒有 url，表示安全審查在生成後隱藏了該結果；該任務仍會被收費，使用者可以聯絡 Makernice 要求審查。失敗的任務不會被收費；請將 error 中的原因告知使用者。

對於多片段影片，每個片段執行一個任務，每個任務都有各自的 estimate_cost、max_cost_usd 和新的 request_id，並將累計總額告知使用者。

處理拒絕情況

• 價格高於 max_cost_usd：顯示新價格，並在使用者同意後，使用新的 max_cost_usd 和新的 request_id 重新嘗試。
• 超過每個任務限制：建議使用 720p 或更短的持續時間，或者使用者可以在 Makernice 上提高每個任務的限制。
• 餘額不足或達到每日限制：呼叫 get_balance 並說明情況。如果 get_topup_link 工具可用，且使用者詢問如何加值，則提供一次連結。
• 已排隊任務的設定錯誤：使用其 job_id 呼叫 cancel_job 可全額釋放已凍結的金額。