aisplice

按能力

音樂

音樂按任務處理：提交提示詞，再查結果或等回呼。先只用提示詞。

#1. 選模型

#3. 拿到結果

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

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

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

成功才扣費

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

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

#出錯了怎麼辦

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

查詢其他錯誤 →

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

創作意圖

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

成本倍率項

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

模式切換項

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

系統接線項

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

  • prompt
    何時開放
    始終開放。它是音樂生成的最小可用輸入。
    建議預設值
    在 UI 中設為必填。
    為什麼重要
    它承載了主題、流派和情緒方向。
  • instrumental / make_instrumental
    何時開放
    只有當產品明確區分有人聲和純音樂輸出時才開放。
    建議預設值
    除非使用者真的需要在有人聲和純音樂之間切換，否則留在伺服器端。
    為什麼重要
    它會改變輸出類型，因此應對應清楚的業務選擇。
  • title / tags
    何時開放
    只有當使用者已經理解只用 prompt 的生成方式後再開放。
    建議預設值
    作為選填的進階欄位處理。
    為什麼重要
    它們有助於控制風格，但不應阻礙使用者第一次成功生成。
  • version / mv
    何時開放
    只有當使用者必須選擇模型家族或生成模式時才開放。
    建議預設值
    先在伺服器端固定一個建議版本。
    為什麼重要
    它會增加決策負擔，通常更適合留在營運或系統控制層。
  • continue_clip_id / continue_at
    何時開放
    僅在續寫或延長流程中開放。
    建議預設值
    在標準創作流程中隱藏。
    為什麼重要
    這些屬於專家控制項，過早顯示會讓初次使用的使用者困惑。
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 或錯誤訊息傳給我們，我們來查。

上一頁影片下一頁3D 模型