Alibaba: HappyHorse 1.1
Alibaba HappyHorse 1.1 tạo video ngắn có âm thanh từ yêu cầu viết, một ảnh khung đầu hoặc đến chín ảnh tham chiếu. Cấu hình nhà sản xuất nhấn mạnh chuyển động, chi tiết da và tính nhất quán nhân vật giữa đoạn được cải thiện. Đầu ra là MP4 3–15 giây ở 24 fps, với lựa chọn 480p, 720p hoặc 1080p.
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.
Alibaba HappyHorse 1.1 là phiên bản tạo video với cấu hình có tên riêng cho chuyển văn bản thành video, ảnh khung đầu thành video và tham chiếu thành video. Nhà sản xuất nhấn mạnh cải thiện chi tiết hình ảnh, chuyển động, danh tính nhân vật giữa đoạn, ổn định chữ và đồng bộ âm thanh–hình ảnh. Kết quả là video ngắn có âm thanh, hữu ích cho cú sản phẩm, chân dung được tạo chuyển động hoặc cảnh nhân vật nhỏ. Chọn chế độ theo yếu tố cần xác định cảnh: ý tưởng viết, ảnh mở chính xác hoặc nhiều tham chiếu hình ảnh.
Với chuyển văn bản thành video, mô tả chủ thể, địa điểm, hành động, bố cục, chuyển động máy quay và ý định âm thanh. Với cảnh hành động ngắn, cho người đi xe đạp dừng cạnh quán cà phê ven sông trong khi máy quay tiến nhẹ tới xe đã dựng. Giữ hành động phù hợp đoạn ngắn và mô tả khoảnh khắc cuối. Hướng dẫn văn bản hiện tại cho đến 5,000 ký tự không phải tiếng Trung hoặc 2,500 ký tự tiếng Trung, cắt văn bản vượt. Tổ chức yêu cầu để chủ thể và hành động thiết yếu tường minh thay vì chìm trong tính từ lặp.
Chuyển ảnh khung đầu thành video dùng đúng một ảnh làm mở đầu. Chuẩn bị chủ thể, bố cục và phần cắt dự kiến trong ảnh rồi mô tả điều cần chuyển động hoặc máy quay cần đổi. Định dạng ảnh được mô tả là JPEG/JPG, PNG và WEBP, đến 20 MB, cả hai chiều ít nhất 300 pixel và tỷ lệ từ 1:2.5 đến 2.5:1. Đầu ra xấp xỉ cấp độ phân giải đã chọn trong khi giữ tỷ lệ ảnh nguồn. Kết quả dọc vì thế bắt đầu từ bố cục dọc phù hợp thay vì chỉ dẫn tỷ lệ không liên quan.
Tạo từ tham chiếu nhận một đến chín ảnh. Lời nhắc dùng [Image 1], [Image 2] và vị trí sau để xác định theo thứ tự đầu vào. Nêu vai trò từng tham chiếu và gọi vật hoặc người liên quan để ảnh cảnh không bị nhầm nguồn nhân vật. Hướng dẫn tham chiếu nhận JPEG/JPG, PNG hoặc WEBP đến 20 MB, yêu cầu cạnh ngắn nhất ít nhất 400 pixel và khuyến nghị tham chiếu rõ ở 720p trở lên. Tránh tham chiếu nén mạnh đã mất chi tiết nhận diện.
Với cảnh nhiều tham chiếu, đặt người từ ảnh này vào phòng từ ảnh khác trong khi giữ áo hoặc sản phẩm từ ảnh thứ ba. Mô tả tương tác và máy quay trong cùng yêu cầu. Cấu hình tham chiếu 1.1 nhấn ổn định chủ thể, phong cách cảnh và chuyển động điện ảnh; kiểm tra kết quả thực về danh tính, dấu hiệu sản phẩm và vị trí không gian dự kiến. Nhiều ảnh cho yêu cầu thêm thông tin, nhưng xem xét vẫn cần kiểm tra đặc điểm nào đi vào video.
Nhà sản xuất liệt kê đầu ra 480p, 720p và 1080p cho các chế độ tạo 1.1, thời lượng nguyên giây từ ba đến mười lăm và MP4 ở 24 fps. Phản hồi API mô tả mã hóa H.264. Tạo văn bản và tham chiếu cung cấp hình gồm 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 và 21:9; tạo khung đầu theo ảnh đầu vào. Chọn hình cho nơi dùng và chừa chỗ phụ đề hoặc yếu tố bố cục thêm sau. Kiểm tra bố cục thực tế video trả về ở kích thước hiển thị dự kiến.
Đầu ra họ mô hình gồm âm thanh. Cho diễn xuất hoặc không khí vai trò rõ trong yêu cầu, xem mọi hội thoại, hiệu ứng hoặc rãnh nền cùng hình. Giữ lời đủ ngắn cho hành động và khoảng dừng thay vì nén kịch bản dài vào cú ngắn. Kiểm tra chuyển động môi, gán người nói và câu chữ thực khi có lời. Chấp nhận ngôn ngữ lời nhắc tự nó không xác định phát âm bảo đảm hoặc đầu vào tham chiếu giọng riêng.
Quy trình nhà sản xuất được mô tả là bất đồng bộ: mã tác vụ theo dõi xử lý, kết quả thành công cung cấp vị trí video. Liên kết kết quả và truy vấn tác vụ được mô tả có thời hạn hai mươi bốn giờ. Lưu đoạn hoàn tất, tham chiếu và lời nhắc làm hồ sơ sửa. Hướng dẫn còn mô tả điều khiển seed và watermark. Seed cố định có thể giúp so sánh, nhưng nhà sản xuất nêu rõ không bảo đảm kết quả giống hệt, nên đánh giá sản phẩm trả về thay vì giả định một thiết lập cố định mọi khung.
HappyHorse 1.0 và 1.1 là phiên bản riêng. Bảng đầu ra 1.1 thêm 480p vào lựa chọn 720p và 1080p của 1.0, và trang mô hình 1.1 mô tả nâng cấp chi tiết, chuyển động, tính nhất quán. Cấu hình chỉnh sửa video HappyHorse 1.0 có tên riêng có đầu vào và giới hạn riêng, không phải chế độ chỉnh sửa âm thầm gán cho 1.1. Xem toàn đoạn 1.1 về danh tính, chuyển động, bố cục, chữ và âm thanh rồi sửa cụ thể trong khi giữ phần yêu cầu thành công.
Ailoot Ultra · Video POST /v1/videos alibaba/happyhorse-1.1
alibaba/happyhorse-1.1Bắt đầu
Alibaba HappyHorse 1.1 tạo video ngắn có âm thanh từ yêu cầu viết, một ảnh khung đầu hoặc đến chín ảnh tham chiếu. Cấu hình nhà sản xuất nhấn mạnh chuyển động, chi tiết da và tính nhất quán nhân vật giữa đoạn được cải thiện. Đầu ra là MP4 3–15 giây ở 24 fps, với lựa chọn 480p, 720p hoặc 1080p.
- Đầu vào được chấp nhận
- Văn bản
- Kết quả
- Video
Có trên Ailoot · đầu vào & phương thức
Ailoot Ultra · Video POST /v1/videos
- Đầu vào
text- Đầu ra
video- Định dạng đầu ra
- mp4
- Số đầu ra
- Tối đa 4 đầu ras
| 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 alibaba/happyhorse-1.1 | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn Độ dài tối thiểu: 1 Số byte tối đa: 10.000 Đơn vị: byte UTF8 | Mặc định— |
Trườngduration | Loạiinteger | Yêu cầuBắt buộc | Giá trị & giới hạn Tối thiểu: 3 Tối đa: 15 Đơn vị: giây | Mặc định— |
Trườngresolution | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn 720p | Mặc định— |
Trườngaspect_ratio | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn 16:9 | Mặc định— |
Tổ hợp tư liệu đầu vào
Văn bản thành video · Bắt buộc: prompt
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, prompt, duration, resolution, aspect_ratio |
Tham sốother_options | Hợp đồngfalse |
Tham sốresolution | Hợp đồng720p |
Tham sốprompt_max_bytes | Hợp đồng10000 |
Tham sốduration_integer_range | Hợp đồng3, 15 |
Tham sốaspect_ratio | Hợp đồng16:9 |
Tham sốgenerate_audio | Hợp đồngphải bỏ qua (không đặt false); có AAC |
Tham sốmaterial_types | Hợp đồngtext |
Tham sốadditional_properties | Hợp đồngfalse |
Bí danh phương thức: /v1/videos/generations, /videos, /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
Tạo một lần và lưu ID được trả về.
Thăm dò trạng thái ban đầu; giữ lại mọi tài sản đã hoàn tất và thời lượng.
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í | 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í— | 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 giây video | Điều kiện tính phíresolution: 1080p | Phí Đầu ra · Giá video · Ước tính chỉ để so sánh $0.2556 mỗi giây video |
| Cấu hìnhGiá video | Biểu mức phí— | Số lượng dự báo— | Đơn vị tính phímỗi giây video | Điều kiện tính phíresolution: 720p | Phí Đầu ra · Giá video · Ước tính chỉ để so sánh $0.1976 mỗi giây video |
| 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í— | Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh $0.5928 ướ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 →
Chi tiết giá cước tham chiếu
Biểu tham chiếu cấp mô hình không thay đổi việc chọn phương thức, báo giá hoặc khoản phí. Khoản phí đang áp dụng dùng mức phí phương thức Ailoot đã chọn.
Tham chiếu giá theo cấu hình video
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 | Điều kiện tính phí | Phí |
|---|---|---|
| Cấu hìnhGiá video | Điều kiện tính phíresolution: 720p | Phí Đầu ra · Giá video $0.1976 mỗi giây video Giá tham khảo được công bố cho cấu hình đang hiển thị. Khoản phí cuối cùng dựa trên cấu hình thực tế được ghi nhận khi tính phí. |
| Cấu hìnhGiá video | Điều kiện tính phíresolution: 1080p | Phí Đầu ra · Giá video $0.2556 mỗi giây video Giá tham khảo được công bố cho cấu hình đang hiển thị. Khoản phí cuối cùng dựa trên cấu hình thực tế được ghi nhận khi tính phí. |
Ví dụ yêu cầu
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "alibaba/happyhorse-1.1", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 3, "resolution": "720p", "aspect_ratio": "16:9"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
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 result.json
Nhận và lưu kết quả
Ailoot Ultra · Video
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Kiểm tra trạng thái tác vụ
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Lượt đọc nội dung khác
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
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ề.
data[] khi hoàn tất chứa tất cả URL nội dung đã ký thuộc quyền sở hữu. Truy xuất từng URL được trả về, hoặc dùng điểm cuối nội dung với index đặt thành một chỉ số đầu ra thực tế. Tác vụ gốc thất bại có thể trả về charge_pending_check; kiểm tra tác vụ gốc đó thay vì tạo lại.
Nếu cần kiểm tra phản hồi gốc
Đọc tác vụ gốc hiện có; tuyệt đối không gửi lại lần gửi chưa rõ kết quả.
Số đầu ra tối đa: 4.
Trường phản hồi
| Trường | Loại | Ý nghĩa |
|---|---|---|
Trườngid | Loạistring | Ý nghĩa— |
Trườngobject | Loạistring | Ý nghĩa— |
Trườngmodel | Loạistring | Ý nghĩa— |
Trườngstatus | Loạistring | Ý nghĩa— |
Trườngdata[] | Loạisigned content URL | Ý nghĩa— |
Trườngcharge_pending_check | Loạiboolean | Ý nghĩa— |
Trườngerror.code | Loạistring | Ý nghĩa— |
Trườngerror.message | Loạistring | Ý nghĩa— |
Trườngoperation_id | Loạistring | Ý nghĩaPhản hồi trạng thái/nội dung gốc HTTP503 result_pending_check: cùng ID video công khai ban đầu trong id. |
Trườngerror.type | Loạistring | Ý nghĩaserver_error khi HTTP503 result_pending_check. |
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ệnKhông thể đọc nội dung yêu cầu thô trước khi phân tích hồ sơ video | Bước tiếp theoGiữ lại phản hồi được trả về và sửa nội dung yêu cầu không đọc được. |
Phản hồi422 · price_unavailable | Điều kiệnKhông thể phân tích hồ sơ video chính xác, hoặc hồ sơ đã phân tích đầy đủ chưa có bảng giá sẵn sàng áp dụng khớp chính xác với hồ sơ đó | Bước tiếp theoGiữ lại phản hồi; dùng hồ sơ đầy đủ, chính xác đã được cho phép và bảng giá đã công bố của hồ sơ đó. Nhánh này chạy trước khi gửi đến nhà cung cấp. |
Phản hồi409 · video_not_ready | Điều kiệnNội dung kết quả ban đầu chưa có sẵn | Bước tiếp theoThăm dò ID ban đầu được trả về và tuân thủ Retry-After. |
Phản hồiserver_error | Điều kiệnPhản hồi trả về cho biết thao tác hoặc kết quả cần được kiểm tra | Bước tiếp theoGiữ lại ID thao tác/tác vụ gốc đã trả về, các header của yêu cầu và toàn bộ phản hồi; tiếp tục truy xuất thao tác gốc đó bằng các phương thức được hỗ trợ. Không gửi lại yêu cầu tạo. |
Phản hồi503 · result_pending_check | Điều kiệnGET trạng thái/nội dung gốc: tác vụ chưa được công bố, tác vụ gốc không ở trạng thái failed/cancelled/expired và trạng thái cục bộ là unknown hoặc trạng thái tác vụ gốc là completed. | Bước tiếp theoGiữ lại id và operation_id ban đầu (cùng ID video công khai), phản hồi và tiêu đề; chỉ đọc trạng thái/nội dung ban đầu. Tuyệt đối không gửi yêu cầu tạo mới. |
Bí danh
Bí danh mô hình
Ailoot Ultra alibaba/happyhorse-1.1
Bí danh đường dẫn phương thức
/v1/videos/generations, /videos, /videos/generations
ID gọi liên quan
FAQ · Alibaba: HappyHorse 1.1
- Có những đầu vào và kết quả nào?
POST /v1/videos·alibaba/happyhorse-1.1:text→video- Yêu cầu sử dụng những trường nào?
POST /v1/videos·alibaba/happyhorse-1.1:model,prompt,duration,resolution,aspect_ratio- Áp dụng những giới hạn nào?
POST /v1/videos·alibaba/happyhorse-1.1:duration.minimum:3;duration.maximum:15