Source: https://ailoot.ai/models/zh-hant-tw/dop-preview/
Canonical: https://ailoot.ai/models/zh-hant-tw/dop-preview/
Language: zh-hant-tw

# Higgsfield: DOP Preview

[Markdown](https://ailoot.ai/models/zh-hant-tw/dop-preview/index.md) · [JSON](https://ailoot.ai/models/zh-hant-tw/dop-preview/facts.json)

## [Higgsfield: DOP Preview](https://ailoot.ai/models/zh-hant-tw/dop-preview/)

DOP Preview 透過文件記載的動作範本工作流程，將所提供的圖像轉為影片。確切的 dop-preview 選擇碼支援一個或兩個效果，並將強度、prompt 和 seed 控制項與完成結果一同保留。

- [**Ailoot Ultra · 影片** `POST /v1/videos` `dop-preview`](https://ailoot.ai/models/zh-hant-tw/dop-preview/#method-0)

關於模型

此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。

DOP Preview 透過 Higgsfield 文件所述的圖片轉影片工作流程，讓所提供的圖像動起來。確切選擇碼為 dop-preview。請將 dop-preview 用於頂層 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-preview`

[`dop-preview`](https://ailoot.ai/models/zh-hant-tw/#m=dop-preview&route=Ultra&caller=dop-preview&fmt=videos)

Higgsfield /`dop-preview`

### 入門

DOP Preview 透過文件記載的動作範本工作流程，將所提供的圖像轉為影片。確切的 dop-preview 選擇碼支援一個或兩個效果，並將強度、prompt 和 seed 控制項與完成結果一同保留。

接受的輸入

圖片 · 文字

結果

影片

### Ailoot 可用 · 輸入與方法

**Ailoot Ultra · 影片** `POST /v1/videos`

輸入

`image`, `text`

輸出

`video`

| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
| --- | --- | --- | --- | --- |
| 欄位`model` | 類型`string` | 要求必填 | 值與限制 dop-preview 條件: Ailoot 模型選擇器。 | 預設值— |
| 欄位`params` | 類型`object` | 要求必填 | 值與限制 條件: 圖片生成影片的參數；請保留此封裝結構。 | 預設值— |
| 欄位`params.model` | 類型`string` | 要求必填 | 值與限制 dop-preview 條件: 請使用與頂層 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 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。[預留金額與結算的運作方式 →](https://ailoot.ai/docs/zh-hant-tw/billing/reserve/)

### 請求範例

#### Ailoot Ultra · 影片

JSON · 建立影片curl · 讀取原始任務

```json
{
  "model": "dop-preview",
  "params": {
    "model": "dop-preview",
    "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
  }
}
```

```bash
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}/content`
- `GET /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-preview`](https://ailoot.ai/models/zh-hant-tw/#m=dop-preview&route=Ultra&caller=dop-preview&fmt=videos)

#### 方法路徑別名

`/v1/videos/generations`

#### 相關呼叫用 ID

[`dop-preview`](https://ailoot.ai/models/zh-hant-tw/#m=dop-preview&route=Ultra&caller=dop-preview&fmt=videos)

FAQ · Higgsfield: DOP Preview

可以使用哪些輸入與結果？

`POST /v1/videos` · `dop-preview`: `image`, `text` → `video`

請求使用哪些欄位？

`POST /v1/videos` · `dop-preview`: `model`, `params`, `webhook`, `callback`

適用哪些限制？

`POST /v1/videos` · `dop-preview`: `params.motions[].strength.minimum`: `0`; `params.motions[].strength.maximum`: `1`; `params.seed.minimum`: `1`; `params.seed.maximum`: `1000000`

將 Ailoot 串接 Claude Code、OpenCode、Hermes 或自己的應用程式。

## 公司及其專案組合

公司及其專案組合：數百萬客戶，每月銷售額達數十億。

## 優惠購買 token。

訂閱優惠適合持續工作，折扣碼購買 token 最高可折 50%。

訂閱

為定期請求選擇優惠方案。

最高 50% 折扣碼

購買時輸入代碼，價格依活動重算。

歷史中的費用

每次請求保存模型、token 與金額。

[選擇訂閱](https://ailoot.ai/docs/zh-hant-tw/billing/subscriptions/) · [查看模型價格](https://ailoot.ai/models/zh-hant-tw/)

## 將 API 加入 你銷售的產品。

依 Ailoot 正式服務條款與授權合約串接 SaaS、應用程式與機器人；轉售請申請經銷授權。

商用應用程式

在付費功能加入文字、圖片、影片與聲音生成。

經銷授權

提供專案說明與存取方式，要求書面使用和轉售條件。

網站文件

串接前可閱讀正式服務條款、授權合約與資料處理政策。

[申請經銷授權](mailto:support@ailoot.ai) · [正式服務條款與授權合約](https://ailoot.ai/legal/offer?lang=zh-hant-tw)

## Ailoot · 公司及其專案組合





Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。





公司及其專案組合：數百萬客戶，每月銷售額達數十億。





Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。