Source: https://ailoot.ai/models/vi/dop-preview/
Canonical: https://ailoot.ai/models/vi/dop-preview/
Language: vi

# Higgsfield: DOP Preview

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

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

DOP Preview chuyển hình ảnh được cung cấp thành video bằng quy trình mẫu chuyển động đã được tài liệu hóa. Bộ chọn dop-preview chính xác hỗ trợ một hoặc hai hiệu ứng, với các điều khiển cường độ, prompt và seed được giữ cùng kết quả hoàn tất.

- [**Ailoot Ultra · Tạo video** `POST /v1/videos` `dop-preview`](https://ailoot.ai/models/vi/dop-preview/#method-0)

Về mô hình

Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.

DOP Preview tạo chuyển động cho hình ảnh được cung cấp qua quy trình ảnh thành video đã được Higgsfield tài liệu hóa. Bộ chọn chính xác là dop-preview. Dùng dop-preview làm lựa chọn model ở cấp ngoài cùng và làm giá trị model bên trong đối tượng params được mô tả trong tài liệu. Hình ảnh cung cấp chất liệu trực quan, còn mẫu chuyển động và chỉ dẫn bằng văn bản điều khiển chuyển động cùng hiệu ứng được yêu cầu.

Chuẩn bị ảnh tham chiếu thể hiện rõ chủ thể dự kiến, các chi tiết quan trọng và khoảng không xung quanh. Hướng dẫn khuyến nghị ảnh độ phân giải cao để chi tiết rõ hơn. Với cảnh sản phẩm, chọn góc nhìn cho thấy hình dạng vật thể và các bề mặt cần còn nhận ra được khi chuyển động. Với người hoặc môi trường, xác định đặc điểm trực quan mà chuyển động cần nhấn mạnh. Cung cấp URL ảnh tham chiếu thực tế qua đầu vào image được dùng trong ví dụ của phương thức.

Tài liệu thao tác mô tả một hoặc hai mẫu chuyển động. Khi cung cấp hai mẫu, hướng dẫn mô tả hiệu ứng của chúng được kết hợp. Mô tả các thiết lập sẵn bao gồm chuyển động máy quay, xoay chủ thể và biến đổi trực quan; chẳng hạn, Dolly In mô tả máy quay tiến lại gần, còn 3D Rotation mô tả chủ thể hoặc sản phẩm xoay tại chỗ. Chọn mã định danh mẫu trong tài liệu phù hợp với chuỗi chuyển động dự kiến và giữ mỗi mã cùng giá trị cường độ của nó.

Cường độ chuyển động là số từ 0 đến 1, với giá trị mặc định được tài liệu hóa là 0.8. Hướng dẫn mô tả 0.3 là hiệu ứng nhẹ và 1 là chuyển động mạnh. Chọn cường độ theo chi tiết cần giữ rõ, rồi rà soát toàn bộ chuyển động được tạo. Mô tả chuyển động và cường độ có vai trò khác nhau: mẫu chọn hiệu ứng, còn cường độ kiểm soát mức mạnh của hiệu ứng.

Theo mô tả, trường prompt bắt buộc phải có, nhưng cho phép chuỗi rỗng. Với hiệu ứng dựa trên mẫu, hướng dẫn khuyến nghị để prompt rỗng; khi cung cấp văn bản, hướng dẫn khuyến nghị đưa cả mô tả của mẫu vào vì prompt có thể thay đổi mạnh kết quả. Điều khiển enhance\_prompt bật tối ưu hóa prompt và được tài liệu hóa là mặc định true. Giữ văn bản và điều khiển này cùng ảnh tham chiếu, các mẫu đã chọn khi so sánh các phiên bản.

Điều khiển seed nhận số nguyên từ 1 đến 1000000. Ghi lại seed đã chọn cùng thiết lập tạo video. Yêu cầu cũng cung cấp trường seconds kiểu số nguyên; giữ giá trị đã dùng cùng clip kết quả và kiểm tra thời lượng, bố cục khung hình thực tế của clip. Giá trị boolean check\_nsfw bật bộ lọc nội dung được tài liệu hóa và mặc định là true. Các điều khiển này thuộc yêu cầu ảnh thành video và cần được giữ gắn với đúng mô hình đã chọn.

Quá trình tạo diễn ra bất đồng bộ. Giữ mã định danh tác vụ được trả về trong khi thực hiện truy vấn trạng thái và kết quả đã được cấu hình. Phần ánh xạ khi hoàn tất đọc các mục công việc đã hoàn tất và URL kết quả thô của chúng. Lưu mọi kết quả video đã hoàn tất và giữ mã định danh công việc cùng URL trả về, giữ tất cả các mục đã hoàn tất chung thành kết quả của thao tác.

Rà soát toàn bộ video so với ảnh đã cung cấp, hiệu ứng đã chọn và chỉ dẫn bằng văn bản: ngoại hình chủ thể, chuyển động, bố cục khung hình và góc nhìn kết thúc. Khi sửa, xác định chi tiết trực quan cụ thể cần thay đổi và giữ các phần đã thành công của yêu cầu. Giữ tham chiếu ảnh gốc, bộ chọn chính xác, prompt, mã định danh chuyển động, các giá trị cường độ, seed, thiết lập được yêu cầu và tài nguyên đã hoàn tất cùng nhau để lần so sánh tiếp theo dựa trên lần tạo thực tế.

**Ailoot Ultra · Tạo video** `POST /v1/videos` `dop-preview`

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

Higgsfield /`dop-preview`

### Bắt đầu

DOP Preview chuyển hình ảnh được cung cấp thành video bằng quy trình mẫu chuyển động đã được tài liệu hóa. Bộ chọn dop-preview chính xác hỗ trợ một hoặc hai hiệu ứng, với các điều khiển cường độ, prompt và seed được giữ cùng kết quả hoàn tất.

Đầu vào được chấp nhận

Ảnh · Văn bản

Kết quả

Video

### Có trên Ailoot · đầu vào & phương thức

**Ailoot Ultra · Tạo video** `POST /v1/videos`

Đầu vào

`image`, `text`

Đầu ra

`video`

| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
| --- | --- | --- | --- | --- |
| Trường`model` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn dop-preview Điều kiện: Bộ chọn mô hình Ailoot. | Mặc định— |
| Trường`params` | Loại`object` | Yêu cầuBắt buộc | Giá trị & giới hạn Điều kiện: Các tham số tạo video từ ảnh; giữ nguyên cấu trúc bao này. | Mặc định— |
| Trường`params.model` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn dop-preview Điều kiện: Dùng cùng bộ chọn với mô hình ở cấp cao nhất. | Mặc định— |
| Trường`params.prompt` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn Điều kiện: Giữ trường này trong yêu cầu; tài liệu cho phép chuỗi rỗng. Hướng dẫn bằng văn bản ảnh hưởng mạnh đến hiệu ứng chuyển động đã chọn. | Mặc định— |
| Trường`params.seconds` | Loại`integer` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: Thời lượng yêu cầu; không khẳng định khoảng giá trị hoặc mặc định theo tài liệu. | Mặc định— |
| Trường`params.motions` | Loại`array` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: Chọn một hoặc hai mẫu chuyển động theo tài liệu. | Mặc định— |
| Trường`params.motions[].id` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn Điều kiện: Mã định danh chuyển động trong ví dụ yêu cầu đã hoạt động được tài liệu mô tả. | Mặc định— |
| Trường`params.motions[].strength` | Loại`number` | Yêu cầuBắt buộc | Giá trị & giới hạn Tối thiểu: 0 Tối đa: 1 Điều kiện: Cường độ chuyển động: 0.3 được mô tả là nhẹ và 1 là mạnh. | Mặc định0,8 |
| Trường`params.input_images` | Loại`array` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: Ảnh tham chiếu, dùng mảng đối tượng image\_url như trong ví dụ đã hoạt động. | Mặc định— |
| Trường`params.input_images[].type` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn image\_url Điều kiện: Biểu diễn dữ liệu tham chiếu. | Mặc định— |
| Trường`params.input_images[].image_url` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn Điều kiện: URL ảnh tham chiếu thực tế có thể truy cập của bạn. | Mặc định— |
| Trường`params.enhance_prompt` | Loại`boolean` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: Tăng cường câu lệnh. | Mặc địnhtrue |
| Trường`params.check_nsfw` | Loại`boolean` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: Lọc nội dung. | Mặc địnhtrue |
| Trường`params.seed` | Loại`integer` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 1 Tối đa: 1.000.000 Điều kiện: Giá trị seed để tạo đầu ra nhất quán. | Mặc định— |
| Trường`webhook` | Loại`object` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: Các thiết lập webhook tùy chọn theo tài liệu; truy xuất kết quả thuộc quyền sở hữu dùng các đường dẫn tác vụ Ailoot. | Mặc định— |
| Trường`webhook.url` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: URL bộ nhận của bạn. | Mặc định— |
| Trường`webhook.secret` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: Bí mật của bộ nhận của bạn. | Mặc định— |
| Trường`callback` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: Bộ nhận callback tùy chọn; bộ nhận được tài liệu mô tả phản hồi bằng HTTP 200. | Mặc định— |

Tổ hợp tư liệu đầu vào

Tham số phương thức và vòng đời

| Tham số | Hợp đồng |
| --- | --- |
| Tham số`content_type` | Hợp đồngapplication/json |
| Tham số`required` | Hợp đồngmodel, params |
| Tham số`optional` | Hợp đồngparams.seconds, params.motions, params.input\_images, params.enhance\_prompt, params.check\_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback |
| Tham số`material_types` | Hợp đồngimage, text |
| Tham số`additional_properties` | Hợp đồngtrue |
| Tham số`validation_scope` | Hợp đồngmodel định tuyến yêu cầu; cấu trúc chứa tham số tuân theo yêu cầu tạo video từ ảnh đã được minh họa. |

Bí danh phương thức: `/v1/videos/generations`

Vòng đời: `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`

Dùng cùng bộ chọn mô hình ở cấp cao nhất và bên trong params.

Tạo một lần, sau đó dùng id công khai và polling\_url được trả về cho thao tác ban đầu.

Truy xuất mọi video đã hoàn tất thuộc quyền sở hữu; kiểm tra thời lượng và kích thước thực tế trong kết quả.

Thay YOUR\_ACCESSIBLE\_IMAGE\_URL trong ví dụ bằng URL ảnh tham chiếu thực tế của bạn.

### Bảng giá

##### Cách tính phí cuối cùng

Các đơn giá hiển thị dùng để ước tính chi phí trước khi tạo. Khoản phí cuối cùng được tính dựa trên chi phí ghi nhận cho lượt tạo gốc. Thời lượng đầu ra đo được và số lượng dự kiến không phải là số lượng cuối cùng dùng để tính phí.

Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.

Chế độ nhanh

Chưa chỉ định Khi chọn chế độ nhanh

Chế độ Flex

Chưa chỉ định Khi chọn chế độ flex

Mức độ suy luận tối đa

Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa

#### Mức phí ước tính để so sánh

#### Giá theo cấu hình

Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế.

| Cấu hình | Biểu mức phí | Số lượng dự báo | Phí |
| --- | --- | --- | --- |
| Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Số lượng dự báo— | Phí Đầu vào · Token đầu vào · Ước tính chỉ để so sánh **—** / 1K token Đầu ra · Token đầu ra · Ước tính chỉ để so sánh **—** / 1K token Đầu vào · Đọc bộ nhớ đệm · Ước tính chỉ để so sánh **—** / 1K token Đầu vào · Ghi bộ nhớ đệm · Ước tính chỉ để so sánh **—** / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ · Ước tính chỉ để so sánh **—** / 1K token |
| Cấu hìnhChi phí tạo ước tính | Biểu mức phí— | Số lượng dự báoước tính cho một lần tạo | Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh **$1.24** ước tính trước khi tạo Ước tính này không phải là khoản phí bổ sung hay mức giá cố định cho lượt tạo đã hoàn tất. |

Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. [Cách hoạt động của cơ chế tạm giữ và quyết toán →](https://ailoot.ai/docs/vi/billing/reserve/)

### Ví dụ yêu cầu

#### Ailoot Ultra · Tạo video

JSON · tạo videocurl · đọc tác vụ gốc

```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
```

### Nhận và lưu kết quả

#### Ailoot Ultra · Tạo video

Giữ lại các tác vụ được trả về và trạng thái của chúng. Đọc mọi kết quả video đã hoàn tất thuộc quyền sở hữu.

- `GET /v1/videos/{request_id}`
- `GET /v1/videos/generations/{request_id}`
- `GET /v1/videos/{request_id}/content`
- `GET /v1/videos/generations/{request_id}/content`

##### Lưu tất cả kết quả đã hoàn tất

Lưu mọi video đã hoàn tất hoặc tệp trả về; truy xuất từng URL tài nguyên thực tế được trả về.

Truy xuất mọi đầu ra thực tế đã hoàn tất; không giả định số lượng cố định.

##### Nếu cần kiểm tra phản hồi gốc

Giữ nguyên phản hồi ban đầu và mã định danh tác vụ được trả về; trạng thái không nhận diện được hoặc lần gửi không rõ kết quả không cho phép tạo mới.

Trường phản hồi

| Trường | Loại | Ý nghĩa |
| --- | --- | --- |
| Trường`id` | Loạistring | Ý nghĩaMã định danh tác vụ hoặc thao tác Ailoot công khai. |
| Trường`provider_task_id` | Loạistring | Ý nghĩaMã định danh tác vụ ban đầu, riêng biệt với id công khai. |
| Trường`polling_url` | Loạistring | Ý nghĩaĐường dẫn tra cứu Ailoot được trả về. |
| Trường`jobs[].id` | Loạistring | Ý nghĩaMã định danh tác vụ thực tế được trả về. |
| Trường`jobs[].status` | Loạistring | Ý nghĩaTrạng thái của từng tác vụ được trả về. |
| Trường`jobs[].results.raw.url` | Loạistring | Ý nghĩaMỗi video đã hoàn tất được cung cấp qua URL đã ký thuộc quyền sở hữu của Ailoot. |

Lỗi và bước tiếp theo

| Phản hồi | Điều kiện | Bước tiếp theo |
| --- | --- | --- |
| Phản hồi400 · `invalid_request_error` | Điều kiệnJSON/model hoặc chỉ số nội dung không hợp lệ. | Bước tiếp theo |
| Phản hồi401 · `authentication_error` | Điều kiệnKhóa API Ailoot không hợp lệ. | Bước tiếp theo |
| Phản hồi403 · `permission_error` | Điều kiệnNhóm của khóa API không được phép sử dụng tuyến đa phương tiện này. | Bước tiếp theo |
| Phản hồi404 · `not_found_error` | Điều kiệnTác vụ ban đầu hoặc đầu ra được yêu cầu không tồn tại hoặc không thuộc cùng người dùng/khóa API/nhóm. | Bước tiếp theo |
| Phản hồi502 · `result_pending_check` | Điều kiệnLần gửi hoặc trạng thái ban đầu chưa đầy đủ hoặc chưa thể đối soát; hãy giữ nguyên ID ban đầu và không gửi lại. | Bước tiếp theo |
| Phản hồi503 · `result_pending_check` | Điều kiệnLiên kết, tuyến hoặc nội dung đa phương tiện thuộc quyền sở hữu ban đầu vẫn đang được kiểm tra; tiếp tục kiểm tra thao tác ban đầu đó. | Bước tiếp theo |
| Phản hồi503 · `server_error` | Điều kiệnDịch vụ đa phương tiện hoặc kho lưu trữ tác vụ ban đầu không khả dụng. | Bước tiếp theo |

### Bí danh

#### Bí danh mô hình

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

#### Bí danh đường dẫn phương thức

`/v1/videos/generations`

#### ID gọi liên quan

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

FAQ · Higgsfield: DOP Preview

Có những đầu vào và kết quả nào?

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

Yêu cầu sử dụng những trường nào?

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

Áp dụng những giới hạn nào?

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

Kết nối Ailoot với Claude Code, OpenCode, Hermes hoặc ứng dụng của bạn.

## Công ty và danh mục dự án của công ty

Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng.

## Mua token với giá ưu đãi.

Ưu đãi thuê bao cho nhu cầu thường xuyên. Mã khuyến mãi giảm đến 50% khi mua token.

Thuê bao

Chọn gói ưu đãi cho các yêu cầu thường xuyên của bạn.

Mã giảm đến 50%

Nhập mã khi mua. Giá được tính lại theo chương trình đang áp dụng.

Chi phí trong lịch sử

Mô hình, token và số tiền được lưu cho mỗi yêu cầu.

[Chọn gói thuê bao](https://ailoot.ai/docs/vi/billing/subscriptions/) · [Xem giá mô hình](https://ailoot.ai/models/vi/)

## Kết nối API vào sản phẩm bạn đang bán.

SaaS, ứng dụng và bot — theo đề nghị giao kết chính thức và thỏa thuận cấp phép Ailoot. Muốn bán lại, hãy yêu cầu giấy phép bán lại.

Ứng dụng thương mại

Tích hợp tạo văn bản, ảnh, video và âm thanh vào các tính năng trả phí của dịch vụ.

Giấy phép bán lại

Gửi mô tả dự án và cách cung cấp quyền truy cập. Yêu cầu điều khoản sử dụng và bán lại bằng văn bản.

Tài liệu trên website

Đề nghị giao kết, thỏa thuận cấp phép và chính sách xử lý dữ liệu có sẵn trước khi kết nối.

[Yêu cầu giấy phép bán lại](mailto:support@ailoot.ai) · [Đề nghị giao kết và thỏa thuận cấp phép](https://ailoot.ai/legal/offer?lang=vi)

## Ailoot · Công ty và danh mục dự án của công ty





Ailoot dựa trên kinh nghiệm vận hành tích lũy, cơ sở khách hàng lớn, dịch vụ ổn định và việc kiểm soát KPI liên tục.





Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng.





Ailoot áp dụng kinh nghiệm vận hành này để cung cấp quyền truy cập API vào các tính năng AI trong sản phẩm của khách hàng, tác tử, ứng dụng và quy trình tự động hóa.