Higgsfield: DOP Lite

DOP Lite tạo chuyển động cho ảnh được cung cấp bằng các mẫu chuyển động đã được tài liệu hóa, cường độ có thể điều chỉnh và chỉ dẫn bằng văn bản. Bộ chọn dop-lite này dùng yêu cầu ảnh thành video và trả về video qua tác vụ bất đồng bộ.

Ailoot Ultra · Tạo video POST /v1/videos dop-lite

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 Lite 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-lite. Dùng dop-lite 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-lite

dop-lite

Higgsfield /dop-lite

Bắt đầu

Đầ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-lite Đ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-lite Đ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 →

Ví dụ yêu cầu

Ailoot Ultra · Tạo video

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

{
  "model": "dop-lite",
  "params": {
    "model": "dop-lite",
    "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

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

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

/v1/videos/generations

ID gọi liên quan

dop-lite

FAQ · Higgsfield: DOP Lite

Có những đầu vào và kết quả nào?: POST /v1/videos · dop-lite: image, text → video
Yêu cầu sử dụng những trường nào?: POST /v1/videos · dop-lite: model, params, webhook, callback
Áp dụng những giới hạn nào?: POST /v1/videos · dop-lite: params.motions[].strength.minimum: 0; params.motions[].strength.maximum: 1; params.seed.minimum: 1; params.seed.maximum: 1000000

Higgsfield: DOP Lite