aisplice

按能力

影片

影片都按任務處理：提交後查結果或等回呼。時長越長、清晰度越高越貴。

#1. 選模型

#3. 拿到結果

提交後馬上回傳 task_id。每隔幾秒查一次，直到 status 變成 completed；也可以傳 webhook_url，完成後我們會回呼你。

GET https://www.aisplice.store/v1/videos/{task_id}

GET https://www.aisplice.store/v1/videos/{task_id}/content

時長和解析度決定價格檔位。進行中的任務可以取消，見 API 參考。

成功才扣費

失敗或取消的任務自動退款，請求日誌裡能看到每個任務的最終費用。

狀態值和輪詢方式 →改用回呼，不用反覆查詢 →

#出錯了怎麼辦

  • 400 並提示某個欄位：這個模型不支援該選項，用第 2 步列出的取值。
  • 參考圖或影片被拒：必須是模型能下載的公開網址。
  • 內容被模型拒絕：換個說法重寫提示詞；被拒絕的請求不扣費。
  • 402：餘額不夠這次請求，到「錢包」儲值後重試。
  • 429：請求太快，按 Retry-After 給的秒數等一下再試。
  • 503 model_not_found：模型名寫錯了或模型暫時下線，從第 1 步重新選一個。

查詢其他錯誤 →

#首尾影格、參考圖和參考影片

支援的模型會在第 2 步顯示這些欄位：首影格、尾影格、參考圖或參考影片。填公開網址，本機檔案先上傳。

怎麼上傳本機檔案 →

做進你的產品裡先給你的使用者放哪些選項，哪些以後再加。
先給使用者放哪些選項先放提示詞和一個影響價格的選項，基礎流程跑通後再加其他的。+

創作意圖

像 prompt 這樣的欄位應該出現在 UI 中，因為使用者能直接理解它會改變什麼結果。

成本倍率項

像 duration、resolution、size、count 這樣的欄位，只有在價格已經能被清楚解釋時才應引入。

模式切換項

像 image、mask 或 continuation ID 這類欄位會改變整個工作流程本身，只應出現在專門模式中。

系統接線項

像 webhook_secret 這樣的欄位是給整合方用的，不是給一般創作者用的，所以不要放進預設 UI。

  • prompt
    何時開放
    始終開放。它定義場景內容或運動方向。
    建議預設值
    在 UI 中設為必填。
    為什麼重要
    沒有它，使用者就無法控制影片意圖。
  • image / images
    何時開放
    僅在參考素材驅動或圖生影片產品中開放。
    建議預設值
    在純 prompt 流程中隱藏。
    為什麼重要
    它會改變創作模式，因此應是明確的產品決策，而不是預設開放。
  • duration
    何時開放
    只有在基礎非同步流程穩定、價格清楚顯示後再開放。
    建議預設值
    從模型支援的最短時長起步。
    為什麼重要
    它是影片生成裡最主要的成本和延遲放大項之一。
  • resolution
    何時開放
    只有當使用者明確會比較 720p、1080p 或 4K 輸出時再開放。
    建議預設值
    先在伺服器端固定一個建議解析度。
    為什麼重要
    更高解析度會提高成本、排隊時間和失敗敏感度。
  • webhook_url / webhook_secret
    何時開放
    只給後端整合方使用，不對一般終端使用者開放。
    建議預設值
    在 UI 產品中優先採用輪詢。
    為什麼重要
    它們解決的是系統整合問題，不是終端使用者創作問題，所以不應進入面向使用者的控制區。
recommended-rollout.txt
Phase 1
- prompt
- one size or one duration default
- submit -> poll -> content

Phase 2
- one quality or resolution selector
- clear pricing hint

Phase 3
- advanced controls such as reference media, continuation, webhook, or vendor-specific tuning

結果只保留一個可信來源

任務完成後，讓應用程式統一圍繞 /content 回傳的平台 URL 運作。這樣既能隱藏上游供應商細節，也能讓歷史回放更穩定。

還是沒解決？

把請求 ID 或錯誤訊息傳給我們，我們來查。

上一頁圖片下一頁音樂