Higgsfield: DOP Turbo
DOP Turbo 是 Higgsfield 圖片轉影片工作流程中的 dop-turbo 選擇碼。提供參考圖片和所選動作範本，再將強度、prompt、seed 和已完成影片保留為一筆生成紀錄。
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。
DOP Turbo 透過 Higgsfield 文件所述的圖片轉影片工作流程，讓所提供的圖像動起來。確切選擇碼為 dop-turbo。請將 dop-turbo 用於頂層 model 選擇，以及文件中 params 物件內的 model 值。圖片提供視覺素材，而動作範本和書面指示控制所要求的動作與效果。
請準備能清楚看見目標主體、重要細節和周遭空間的參考圖片。指南建議使用高解析度圖片，讓細節更清晰。針對商品場景，請選擇能顯示物件形狀，以及在移動中應保持可辨識表面的視角。針對人物或環境，請指出動作應強調的視覺特徵。請透過方法範例使用的圖片輸入提供實際參考圖片 URL。
此操作記載了使用一個或兩個動作範本的方式。提供兩個範本時，指南說明其效果會結合。預設效果的描述包含相機移動、主體旋轉和視覺變化；例如，Dolly In 描述相機靠近，而 3D Rotation 描述主體或商品在原地旋轉。請選擇符合預期動作流程、已有文件記載的範本識別碼，並將各識別碼與其強度值一併保留。
動作強度是 0 到 1 的數值，文件記載的預設值為 0.8。指南將 0.3 描述為細微效果，1 則為強烈動作。請依必須保持清楚可讀的細節選擇強度，並檢查生成的完整動作。動作描述與強度各有用途：範本選擇效果，強度則控制效果的強弱。
依欄位描述，必須提供 prompt 欄位，但允許空字串。針對範本驅動的效果，指南建議讓 prompt 保持空白；提供文字時，則建議加入範本描述，因為 prompt 可能大幅改變結果。enhance_prompt 控制項啟用提示詞最佳化，文件記載其預設為 true。比較不同版本時，請將文字和這個控制項與參考圖片及所選範本一同保留。
seed 控制項接受 1 到 1000000 的整數。請將選定的 seed 與生成設定一同記錄。請求也提供整數型別的 seconds 欄位；請將使用的值與產生的片段一同保留，並檢查片段的實際時間表現和取景。check_nsfw 布林值啟用文件所述的內容篩選，預設為 true。這些控制項屬於圖片轉影片請求，應與確切選定的模型保持對應。
生成採非同步方式。依設定查詢狀態和結果時，請保留回傳的任務識別資訊。完成結果的對應設定會讀取已完成的工作項目及其原始結果 URL。請儲存每個已完成的影片結果，將工作識別碼與回傳 URL 一併保留，並把所有已完成項目放在一起，作為該操作的結果。
請依所提供圖片、所選效果和書面指示檢查完整影片：主體外觀、動作、取景和結尾畫面。修改時，請指出要改變的具體視覺細節，並保留請求中成功的部分。請將原始圖片參照、確切選擇碼、prompt、動作識別碼、強度、seed、所要求設定和已完成素材一同保留，讓下一次比較以實際生成結果為依據。
Ailoot Ultra · 影片 POST /v1/videos dop-turbo
dop-turbo入門
DOP Turbo 是 Higgsfield 圖片轉影片工作流程中的 dop-turbo 選擇碼。提供參考圖片和所選動作範本，再將強度、prompt、seed 和已完成影片保留為一筆生成紀錄。
- 接受的輸入
- 圖片 · 文字
- 結果
- 影片
Ailoot 可用 · 輸入與方法
Ailoot Ultra · 影片 POST /v1/videos
- 輸入
image,text- 輸出
video
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 dop-turbo 條件: Ailoot 模型選擇器。 | 預設值— |
欄位params | 類型object | 要求必填 | 值與限制 條件: 圖片生成影片的參數；請保留此封裝結構。 | 預設值— |
欄位params.model | 類型string | 要求必填 | 值與限制 dop-turbo 條件: 請使用與頂層 model 相同的選擇值。 | 預設值— |
欄位params.prompt | 類型string | 要求必填 | 值與限制 條件: 請保留此欄位；文件允許空字串。文字指示會強烈影響所選的動作效果。 | 預設值— |
欄位params.seconds | 類型integer | 要求選填 | 值與限制 條件: 要求的長度；此處未宣稱文件記載的範圍或預設值。 | 預設值— |
欄位params.motions | 類型array | 要求選填 | 值與限制 條件: 請選擇文件記載的一或兩個動作範本。 | 預設值— |
欄位params.motions[].id | 類型string | 要求必填 | 值與限制 條件: 文件所載成功請求範例中的動作識別碼。 | 預設值— |
欄位params.motions[].strength | 類型number | 要求必填 | 值與限制 最小值: 0 最大值: 1 條件: 動作強度：文件將 0.3 描述為細微，1 描述為強烈。 | 預設值0.8 |
欄位params.input_images | 類型array | 要求選填 | 值與限制 條件: 參考圖片，請使用成功範例所示的 image_url 物件陣列。 | 預設值— |
欄位params.input_images[].type | 類型string | 要求必填 | 值與限制 image_url 條件: 參考資料的表示方式。 | 預設值— |
欄位params.input_images[].image_url | 類型string | 要求必填 | 值與限制 條件: 您實際使用且可存取的參考圖片 URL。 | 預設值— |
欄位params.enhance_prompt | 類型boolean | 要求選填 | 值與限制 條件: 提示詞增強。 | 預設值true |
欄位params.check_nsfw | 類型boolean | 要求選填 | 值與限制 條件: 內容篩選。 | 預設值true |
欄位params.seed | 類型integer | 要求選填 | 值與限制 最小值: 1 最大值: 1,000,000 條件: 用來維持輸出一致性的隨機種子。 | 預設值— |
欄位webhook | 類型object | 要求選填 | 值與限制 條件: 文件記載的選填 webhook 設定；取得自有結果時使用 Ailoot 工作路徑。 | 預設值— |
欄位webhook.url | 類型string | 要求選填 | 值與限制 條件: 您的接收端 URL。 | 預設值— |
欄位webhook.secret | 類型string | 要求選填 | 值與限制 條件: 您的接收端密鑰。 | 預設值— |
欄位callback | 類型string | 要求選填 | 值與限制 條件: 選填的 callback 接收端；文件記載的接收端會回應 HTTP 200。 | 預設值— |
輸入素材組合
方法參數與生命週期
| 參數 | 規格 |
|---|---|
參數content_type | 規格application/json |
參數required | 規格model, params |
參數optional | 規格params.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback |
參數material_types | 規格image, text |
參數additional_properties | 規格true |
參數validation_scope | 規格模型決定請求路由；參數封裝結構依照所示的圖片生成影片請求。 |
方法別名： /v1/videos/generations
生命週期： submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
頂層與 params 內請使用相同的模型選擇值。
僅建立一次，接著使用回傳的公開 id 與 polling_url 查詢原始操作。
請取得每個已完成的自有影片，並查看結果中的實際長度與尺寸。
請將範例中的 YOUR_ACCESSIBLE_IMAGE_URL 替換為實際參考圖片的 URL。
方案
最終費用的計算方式
顯示的費率用於在生成前估算費用。最終費用依原始生成作業記錄的成本計算。實測的輸出時間長度與預估數量並非最終計費數量。
費率資訊不會增加請求選項。支援的參數列於所選方法中。
- 快速模式
- 未指定 選取快速模式時
- flex 模式
- 未指定 選取 flex 模式時
- 最高推理強度
- 未指定 最高推理強度採用 default 調整值時
供比較的預估費率
各設定的價格
請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。
| 設定 | 費率表 | 預估數量 | 費用 |
|---|---|---|---|
| 設定基礎 token 費率 | 費率表基本費率 | 預估數量— | 費用 輸入 · 輸入 Token · 僅供比較的估算 — / 1K Token 輸出 · 輸出 Token · 僅供比較的估算 — / 1K Token 輸入 · 讀取快取 · 僅供比較的估算 — / 1K Token 輸入 · 寫入快取 · 僅供比較的估算 — / 1K Token 輸入 · 寫入快取，1 小時 · 僅供比較的估算 — / 1K Token |
| 設定預估生成費用 | 費率表— | 預估數量單次生成估算值 | 費用 輸出 · 預估生成費用 · 僅供比較的估算 $1.24 生成前估算 此估算並非額外費用，也不是本次生成完成後的固定費率。 |
Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →
請求範例
Ailoot Ultra · 影片
{
"model": "dop-turbo",
"params": {
"model": "dop-turbo",
"prompt": "a cat",
"seed": 500000,
"motions": [
{
"id": "2bae49e6-ffe7-42a8-a73f-d44632c4acaa",
"strength": 0.5
}
],
"input_images": [
{
"type": "image_url",
"image_url": "YOUR_ACCESSIBLE_IMAGE_URL"
}
],
"enhance_prompt": true,
"check_nsfw": true
}
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i:raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use the actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
接收並儲存結果
Ailoot Ultra · 影片
請保留回傳的作業及其狀態，並讀取每個已完成的自有影片結果。
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
保留所有已完成的結果
請儲存每部已完成的影片或傳回的檔案，並從實際傳回的每個素材 URL 取得素材。
請取得每個實際已完成的輸出，切勿假定固定數量。
需要檢查原始回應時
請保留原始回應與回傳的工作身分；無法辨識的狀態或結果不明的傳送均不代表可以再次建立。
回應欄位
| 欄位 | 類型 | 含義 |
|---|---|---|
欄位id | 類型string | 含義公開的 Ailoot 工作或操作識別碼。 |
欄位provider_task_id | 類型string | 含義原始工作識別碼，與公開的 id 分開。 |
欄位polling_url | 類型string | 含義回傳的 Ailoot 查詢路徑。 |
欄位jobs[].id | 類型string | 含義實際回傳的作業識別碼。 |
欄位jobs[].status | 類型string | 含義每個回傳作業的狀態。 |
欄位jobs[].results.raw.url | 類型string | 含義每個已完成的影片都會透過 Ailoot 自有的簽署 URL 提供。 |
錯誤與後續步驟
| 回應 | 條件 | 下一步 |
|---|---|---|
回應400 · invalid_request_error | 條件JSON/model 無效，或內容索引無效。 | 下一步 |
回應401 · authentication_error | 條件Ailoot API 金鑰無效。 | 下一步 |
回應403 · permission_error | 條件此 API 金鑰群組未獲准使用這條媒體路由。 | 下一步 |
回應404 · not_found_error | 條件原始工作或要求的輸出不存在，或不屬於同一使用者／API 金鑰／群組。 | 下一步 |
回應502 · result_pending_check | 條件原始提交內容或狀態不完整，或無法核對一致；請保留原始 ID，切勿重新提交。 | 下一步 |
回應503 · result_pending_check | 條件原始綁定、路由或自有媒體仍在查核中；請繼續查核該原始操作。 | 下一步 |
回應503 · server_error | 條件媒體服務或原始工作的儲存系統無法使用。 | 下一步 |
別名
模型別名
Ailoot Ultra dop-turbo
方法路徑別名
/v1/videos/generations
相關呼叫用 ID
FAQ · Higgsfield: DOP Turbo
- 可以使用哪些輸入與結果？
POST /v1/videos·dop-turbo:image,text→video- 請求使用哪些欄位？
POST /v1/videos·dop-turbo:model,params,webhook,callback- 適用哪些限制？
POST /v1/videos·dop-turbo:params.motions[].strength.minimum:0;params.motions[].strength.maximum:1;params.seed.minimum:1;params.seed.maximum:1000000