Black Forest Labs: FLUX Video Upscale
FLUX Video Upscale phóng lớn đoạn video có sẵn bằng tăng cường chi tiết trung thành với nguồn hoặc sáng tạo. Cấu hình được mô tả cung cấp mức phóng 1.5×–3×, giữ âm thanh và bố cục nguồn, đồng thời giới hạn độ dài nguồn, độ phân giải đầu vào và diện tích khung đầu ra.
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.
FLUX Video Upscale là quy trình siêu phân giải video của Black Forest Labs, được vận hành bằng FLUX 3. Quy trình nhận đoạn video có sẵn và trả MP4 phóng lớn, đưa bố cục và âm thanh nguồn vào kết quả. Mô tả ngắn tùy chọn có thể định hướng chi tiết hình ảnh được tăng cường. Hai chế độ tạo lựa chọn có ý nghĩa giữa giữ gần diện mạo cung cấp và tạo chi tiết mạnh hơn, thay vì coi mọi hình ảnh lớn hơn là bản tái dựng trung thành như nhau.
Chọn tăng cường chính xác hoặc sáng tạo
Thiết lập creativity chọn chế độ. Giá trị 0 là cấu hình chính xác, trung thành với nguồn: nhà sản xuất khuyến nghị khi khuôn mặt, sản phẩm hoặc tài sản thương hiệu cần giữ danh tính. Giá trị 1 bật tăng cường chi tiết sáng tạo và là mặc định. Chế độ này có thể phục hồi hoặc sáng tạo kết cấu mạnh hơn, hữu ích cho cảnh quay được tạo, phong cảnh, đám đông hoặc bề mặt có chi tiết có thể phát triển sáng tạo.
Nhà sản xuất cảnh báo rõ rằng tăng cường sáng tạo không giữ khuôn mặt và sản phẩm nghiêm ngặt như vậy. Kiểm tra đặc điểm phải còn nhận diện được: diện mạo khuôn mặt, đường nét sản phẩm, chữ, hoa văn chất liệu hoặc logo. Hình trông sắc nét hơn vẫn có thể chứa chi tiết thay đổi hoặc mới được tạo ra. Với trình diễn sản phẩm, dùng diện mạo sản phẩm dự kiến làm tiêu chí xem xét thay vì chỉ chọn phiên bản có kết cấu cầu kỳ hơn.
Lời nhắc tùy chọn mô tả nội dung đoạn video để hướng dẫn tăng cường; mô tả trống yêu cầu phóng lớn trung tính. Bản mô tả cảnh được tạo ban đầu có thể xác định tường đá phủ rêu, ánh sáng ban ngày dịu và kết cấu lá tinh tế. Tập trung câu chữ vào tư liệu cần tinh chỉnh. Yêu cầu thay vật, dựng lại bối cảnh hoặc đổi hội thoại thuộc quyết định biên tập, trong khi cấu hình này giữ rãnh âm thanh nguồn.
Hệ số phóng và diện tích khung đầu ra
upscale_factor được mô tả có phạm vi từ 1.5 đến 3, với 2 là mặc định. Thiết lập tăng độ phân giải nguồn trong khi giữ tỷ lệ khung hình. Hệ số đã chọn và kích thước đầu vào xác định đầu ra dự kiến, vì vậy video ngang và bố cục dọc cần được lên kế hoạch từ khung thực tế. Chuẩn bị kích thước hiển thị đích trước khi chọn mức phóng hữu ích.
Đặc tả chính xác giới hạn mỗi khung đầu ra ở 13.75 đơn vị megapixel của nhà sản xuất. Tài liệu định nghĩa một đơn vị đó là 1,048,576 pixel, cho trần 14,417,920 pixel, xấp xỉ 14.4 triệu. Điều này giải thích cách ghi làm tròn 14.4 megapixel trong hướng dẫn. Vì vậy, nguồn lớn có thể được phóng ít hơn hệ số yêu cầu. Kiểm tra kích thước được giao thay vì giả định yêu cầu 3× luôn tạo gấp ba mỗi chiều nguồn.
Trần độ phân giải nguồn được công bố là 2560×1440. Quy trình tăng nguồn đủ điều kiện đến gần 4K và cao hơn; nó không chấp nhận nguồn vốn lớn hơn chỉ vì mong muốn đầu ra cao hơn. Giảm kích thước hoặc chuẩn bị bản làm việc phù hợp trước khi dùng cấu hình được mô tả đó. Giữ bản ghi gốc riêng để so sánh cuối không chỉ giới hạn ở bản trung gian đã đổi kích thước.
Chuẩn bị nguồn ngắn, rõ
Hướng dẫn chuẩn bị thông thường của nhà sản xuất giới hạn nguồn ở hai mươi giây và năm mươi MB. Đoạn video được cung cấp qua URL video hoặc MP4 mã hóa. Tài liệu tham chiếu chính xác lưu ý quá trình xử lý bao quát hai mươi giây đầu: vượt thời lượng ít có thể chỉ được xử lý đến mốc đó, còn đoạn dài hơn đáng kể bị từ chối. Không có dung sai bằng số được công bố. Cắt thành đoạn dự kiến dài hai mươi giây hoặc ngắn hơn thay vì phụ thuộc hành vi biên chưa được quy định.
Chọn phiên bản ít nén nhất có sẵn. Lỗi do nén giới hạn chi tiết thật mà bộ phóng có thể phục hồi, và tăng cường sáng tạo có thể tạo kết cấu hợp lý mà không xác lập cảnh gốc chứa gì. Hoàn tất chỉnh sửa và cắt mong muốn trước khi phóng đoạn đã chọn. Quy trình ban đầu có thể hoàn thiện cú máy sản phẩm, chọn khoảng hành động hữu ích rồi phóng phần chọn cuối đó, giữ nguồn chưa đổi để so sánh.
Kết quả giữ rãnh âm thanh nguồn. Kiểm tra thời điểm khớp với hình, đặc biệt đầu và cuối đoạn đã chọn. Cấu hình được mô tả không cung cấp bộ chọn tốc độ khung hình độc lập, tạo hội thoại mới hoặc điều khiển chỉnh sửa bằng ảnh tham chiếu. Mục đích là video lớn hơn với cách xử lý chi tiết đã chọn, giữ tư liệu thời gian và âm thanh nguồn trong đoạn được xử lý.
Lưu và kiểm tra đoạn được giao
Quy trình nhà sản xuất là bất đồng bộ: tác vụ đã gửi cung cấp mã định danh và vị trí trạng thái, còn kết quả hoàn tất chứa liên kết MP4 có chữ ký. Liên kết hết hạn sau khoảng một giờ. Lưu đoạn video thực tế, nguồn, hệ số đã chọn, chế độ creativity và mô tả nội dung thay vì phụ thuộc vị trí tạm. Phân biệt trạng thái thất bại hoặc bị kiểm duyệt với video hoàn tất.
Xem xét từng khung về khuôn mặt, dấu hiệu và thay đổi bề mặt, rồi xem toàn chuỗi về tính liên tục, chuyển động và khớp âm thanh. Đầu ra chính xác và sáng tạo đáp ứng yêu cầu hình ảnh khác nhau; sản phẩm hữu ích là đoạn phóng lớn đạt mục tiêu trung thực đã chọn ở kích thước hiển thị dự kiến. Độ phân giải lớn hơn đơn thuần không phải bằng chứng danh tính, câu chữ hoặc chi tiết tinh của nguồn vẫn đúng.
Ailoot Ultra · Tạo video POST /v1/videos black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscaleBắt đầu
FLUX Video Upscale phóng lớn đoạn video có sẵn bằng tăng cường chi tiết trung thành với nguồn hoặc sáng tạo. Cấu hình được mô tả cung cấp mức phóng 1.5×–3×, giữ âm thanh và bố cục nguồn, đồng thời giới hạn độ dài nguồn, độ phân giải đầu vào và diện tích khung đầu ra.
- Đầu vào được chấp nhận
- Văn bản · Ảnh · Âm thanh · Video
- 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
text,image,audio,video- Đầu ra
video
| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
|---|---|---|---|---|
Trườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn black-forest-labs/flux-video-upscale | Mặc định— |
Trườnginput_references | Loạiarray | Yêu cầuBắt buộc | Giá trị & giới hạn Số mục tối thiểu: 1 Số mục tối đa: 1 | Mặc định— |
Trườngupscale_factor | Loạinumber | Yêu cầuBắt buộc | Giá trị & giới hạn Tối thiểu: 1,5 Tối đa: 3 | Mặc định— |
Trườngcreativity | Loạiinteger | Yêu cầuBắt buộc | Giá trị & giới hạn 0, 1 | Mặc định— |
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, input_references, upscale_factor, creativity |
Tham sốmaterial_types | Hợp đồngtext, image, audio, video |
Tham sốmaterial_conditions | Hợp đồngDùng đúng một URL nội dung của tài sản video thực tế đã hoàn tất, thuộc quyền sở hữu cùng chữ ký được trả về. Chủ sở hữu, kiểu và bằng chứng byte đã lưu của tài sản phải khớp với yêu cầu. |
Vòng đời: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · id hoặc polling_url thực tế được trả về
GET /v1/videos/{request_id}/content
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 | Đơn vị tính phí | Điều kiện tính phí | Số điểm ảnh mỗi megapixel | 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— | Đơn vị tính phí— | Điều kiện tính phí— | Số điểm ảnh mỗi megapixel— | 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ìnhGiá video | Biểu mức phí— | Số lượng dự báo— | Đơn vị tính phímỗi megapixel-giây | Điều kiện tính phíchất lượng: creative | Số điểm ảnh mỗi megapixel1.048.576 | Phí Đầu ra · Giá video · Ước tính chỉ để so sánh $0.21 mỗi megapixel-giây |
| Cấu hìnhGiá video | Biểu mức phí— | Số lượng dự báo— | Đơn vị tính phímỗi megapixel-giây | Điều kiện tính phíquality: precise | Số điểm ảnh mỗi megapixel1.048.576 | Phí Đầu ra · Giá video · Ước tính chỉ để so sánh $0.15 mỗi megapixel-giây |
| 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 | Đơn vị tính phí— | Điều kiện tính phí— | Số điểm ảnh mỗi megapixel— | Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh $0.15 ướ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
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_INPUT_REFERENCES_JSON:?Set the actual documented input value}"
export AILOOT_INPUT_REFERENCES_JSON
: "${AILOOT_UPSCALE_FACTOR:?Set the actual documented input value}"
export AILOOT_UPSCALE_FACTOR
: "${AILOOT_CREATIVITY:?Set the actual documented input value}"
export AILOOT_CREATIVITY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'black-forest-labs/flux-video-upscale', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}', 'upscale_factor': '${ACTUAL_UPSCALE_FACTOR}', 'creativity': '${ACTUAL_CREATIVITY}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
request['upscale_factor']=float(os.environ['AILOOT_UPSCALE_FACTOR'])
request['creativity']=int(os.environ['AILOOT_CREATIVITY'])
Path('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
Nhận và lưu kết quả
Ailoot Ultra · Tạo video
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Lưu tất cả tài nguyên đã hoàn tất
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
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ề.
Giữ lại toàn bộ phản hồi và các header, mọi đầu ra thực tế, các định danh gốc đã trả về và mọi trường usage. Khôi phục thao tác gốc mà không gửi lại yêu cầu tạo.
Nếu cần kiểm tra phản hồi gốc
Giữ lại X-Client-Request-ID, X-Ailoot-Task-Id và id/polling_url thực tế được trả về. Tiếp tục tác vụ ban đầu; không gửi lại yêu cầu tạo.
Trường phản hồi
| Trường | Loại |
|---|---|
Trườngid | Loại |
Trườngstatus | Loại |
Trườngdata[] | Loại |
Trườngoutputs[] | Loại |
Bí danh
Bí danh mô hình
Ailoot Ultra black-forest-labs/flux-video-upscale
Bí danh đường dẫn phương thức
Dùng các đường dẫn phương thức hiển thị ở trên.
ID gọi liên quan
FAQ · Black Forest Labs: FLUX Video Upscale
- Có những đầu vào và kết quả nào?
POST /v1/videos·black-forest-labs/flux-video-upscale:text,image,audio,video→video- Yêu cầu sử dụng những trường nào?
POST /v1/videos·black-forest-labs/flux-video-upscale:model,input_references,upscale_factor,creativity- Áp dụng những giới hạn nào?
POST /v1/videos·black-forest-labs/flux-video-upscale:upscale_factor.minimum:1.5;upscale_factor.maximum:3