HeyGen: HeyGen Video
HeyGen Video tạo cảnh 5–15 giây có hội thoại, âm nền và hiệu ứng từ văn bản, ảnh đầu hoặc tham chiếu hình ảnh và âm thanh. Mô hình đa dụng heygen-video-1 hỗ trợ cú máy sản phẩm và nhân vật, với điều khiển tham chiếu và đầu ra MP4. Hành động rõ ràng, gói gọn giúp tạo một bản yêu cầu sản xuất hữu ích cho mô hình.
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.
HeyGen Video là mô hình tạo cảnh đa dụng của HeyGen, được nhà sản xuất xác định là heygen-video-1. Mô hình tạo chủ thể, bối cảnh, ánh sáng và âm thanh cùng nhau từ yêu cầu sáng tạo. Mỗi đoạn dài 5–15 giây và chứa rãnh âm thanh được tạo, gồm hội thoại, âm nền và hiệu ứng. Đầu vào sản xuất hữu ích gồm mô tả cảnh, ảnh sản phẩm hoặc tư liệu xác lập người, nơi hay chuyển động. Tài sản kết quả là cảnh ngắn cho trình bày sản phẩm, đoạn chèn hướng dẫn ban đầu, góc nhìn bất động sản hoặc tác phẩm video biên tập khác.
Ba chế độ cho đầu vào vai trò khác nhau. Chuyển văn bản thành video tạo cảnh từ lời nhắc. Chuyển ảnh thành video bắt đầu đúng trên ảnh cung cấp rồi theo yêu cầu hành động. Tạo từ tham chiếu dùng ảnh, video và âm thanh tùy chọn để hướng dẫn cảnh bố cục mới; cần ít nhất một ảnh hoặc video tham chiếu. Chọn ảnh khung đầu khi bố cục mở phải khớp ảnh tĩnh, hoặc tham chiếu khi vật đã biết cần xuất hiện trong bố cục khác. Mô hình cảnh này khác các bộ máy dựng avatar và quy trình bố cục Video Agent của HeyGen.
Hướng dẫn nhà sản xuất ưu tiên chỉ dẫn cú máy chi tiết, cụ thể: một chủ thể, một địa điểm và một hành động gọn, với máy quay khóa hoặc chuyển động nhẹ. Mô tả vị trí máy quay, ý định ống kính hoặc độ sâu trường ảnh, ánh sáng, kết cấu bề mặt và xử lý màu. Giải thích nơi vật chạm nhau khi hành động phụ thuộc tiếp xúc. Với ví dụ sản phẩm ban đầu, dùng ảnh tham chiếu bình giữ nhiệt du lịch và yêu cầu nó đứng trên quầy gỗ trong khi người dẫn nói cạnh đó, với chuyển động máy quay nhỏ tới bình. Kiểm tra hình dạng, vị trí và dấu hiệu nhìn thấy của bình trong kết quả.
Danh sách tham chiếu hỗ trợ đến chín ảnh, ba video và ba mục âm thanh, tổng tối đa mười hai tham chiếu. Ảnh, video và âm thanh được đánh số riêng trong định dạng lời nhắc nhà sản xuất: ảnh đầu là <Picture 1>, video đầu là <Video 1>. Cho từng tham chiếu vai trò và xác định tường minh trong yêu cầu. Mô hình đọc năm giây đầu mỗi video tham chiếu, nên chuẩn bị phần liên quan ở đầu. Tham chiếu API còn quy định tỷ lệ video tham chiếu từ 1:4 đến 4:1. Đoạn dài chỉ chứa chuyển động mong muốn ở cuối là chuẩn bị kém cho cửa sổ đầu vào năm giây đó.
Giao diện tham chiếu được mô tả nhận tài nguyên HTTPS truy cập trực tiếp, mã tài sản tải lên hoặc base64 nội tuyến. Hướng dẫn liệt kê ảnh tối đa 16 MB qua URL và 5 MB nội tuyến; video hoặc âm thanh có thể đến 32 MB qua URL và 16 MB nội tuyến. Chuẩn bị nguồn dễ đọc với chủ thể quan trọng dễ phân biệt và không có chỉ dẫn cạnh tranh giữa tham chiếu. Giữ hướng dự kiến trong ảnh khung đầu. Các chi tiết đầu vào này thuộc quy trình tham chiếu nhà sản xuất và giúp tổ chức tư liệu sáng tạo cho chế độ đã chọn.
Chỉ đạo âm thanh trong cùng yêu cầu với hình. Nêu hội thoại, cách thể hiện giọng, âm phòng và hiệu ứng cụ thể, gồm âm thanh nên gần hay xa. Chỉ định xử lý nhạc dự kiến khi cảnh chỉ cần lời nói và âm nền. Hướng dẫn gợi ước lượng lập kế hoạch khoảng 2.5 từ nói mỗi giây, nên chừa chỗ cho khoảng dừng và hành động nhìn thấy. Giới thiệu ngắn có thể lên kế hoạch một câu rồi một nhịp hé lộ sản phẩm. Nghe các từ thực tế và âm thanh được tạo có phù hợp không gian và hành động hay không.
Thời lượng đầu ra chọn theo giây nguyên từ năm đến mười lăm, mặc định năm giây. Độ phân giải là lớp kích thước: 480p, 768p, 1080p hoặc 2k. Lựa chọn bố cục được mô tả là 21:9, 16:9, 4:3, 1:1, 3:4 và 9:16. Với tạo từ văn bản và tham chiếu ở 1080p hoặc 2k, chọn 16:9 hoặc 9:16; bố cục tham chiếu thích ứng được mô tả ở 480p và 768p. Tạo từ ảnh theo tỷ lệ ảnh đầu, nên cắt trước khi tạo khi hình dạng yêu cầu thay đổi. Xem kích thước thực tế kết quả hoàn tất thay vì giả định nhãn lớp kích thước hàm ý cặp pixel thông thường duy nhất.
Hướng dẫn mô hình quy định video MP4 với hình mã H.264 và âm thanh AAC ở 32 kHz stereo. Tạo được xử lý bất đồng bộ, công việc hoàn tất cung cấp vị trí video phát được, thời lượng và kích thước. Vị trí video có chữ ký có thể được làm mới bằng truy xuất công việc lại. Giữ đoạn thực tế, tư liệu tham chiếu và yêu cầu để xem xét biên tập. Bản ghi chờ hoặc xử lý theo dõi tạo; video hoàn tất là sản phẩm sản xuất để đánh giá hình, lời và âm thanh.
Nhà sản xuất mô tả lựa chọn tăng cường lời nhắc turbo, quality và disabled; disabled giữ nguyên câu chữ đã chuẩn bị. Seed cố định hữu ích khi so thay đổi một mệnh đề trong khi giữ đầu vào khác. Ghi seed và thiết lập đã chọn cùng yêu cầu cú máy. Với chữ trên hình, giữ cụm dự kiến ngắn và viết chính xác; hướng dẫn khuyên ghép đoạn văn, chữ nhỏ và sơ đồ gắn nhãn sau. Kiểm tra từng ký tự nhìn thấy trong tiêu đề được tạo thay vì giả định câu chữ tái hiện đúng.
Hướng dẫn xác định văn bản dài trên hình, chuyển động hữu cơ mềm như cánh hoa, giấy hoặc tóc và thao tác tay cận là các vùng kém tin cậy hơn. Với giải thích quy trình, để câu viết rõ truyền đạt bước trong khi hình cho người hoặc vật ổn định; dùng hình ảnh đã kiểm tra riêng khi chính thao tác vật lý phải chính xác. Xem toàn cú về tính liên tục vật, tiếp xúc, chi tiết mặt và tay, hội thoại và âm thanh. Danh sách ngắn nội dung cần đổi trong bản tiếp giữ yêu cầu sản xuất chi tiết có tính thực tế.
Ailoot Ultra · Video POST /v1/videos heygen/heygen-video-1
heygen/heygen-video-1Bắt đầu
HeyGen Video tạo cảnh 5–15 giây có hội thoại, âm nền và hiệu ứng từ văn bản, ảnh đầu hoặc tham chiếu hình ảnh và âm thanh. Mô hình đa dụng heygen-video-1 hỗ trợ cú máy sản phẩm và nhân vật, với điều khiển tham chiếu và đầu ra MP4. Hành động rõ ràng, gói gọn giúp tạo một bản yêu cầu sản xuất hữu ích cho mô hình.
- Đầ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 · Video POST /v1/videos
- Đầu vào
text,image,audio,video- Đầu ra
video- Định dạng đầu ra
- byte MP4 gốc; không chuẩn hóa hoặc chuyển mã
| 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 heygen/heygen-video-1 | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngduration | Loạiinteger | Yêu cầuBắt buộc | Giá trị & giới hạn 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Tối thiểu: 1 Tối đa: 600 | Mặc định— |
Trườngresolution | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 480p, 768p, 2K | Mặc định— |
Trườngaspect_ratio | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Mặc định— |
Trườnggenerate_audio | Loạiboolean | Yêu cầuKhông bắt buộc | Giá trị & giới hạn false | Mặc định— |
Trườngframe_images | Loạiarray | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Số mục tối thiểu: 1 Số mục tối đa: 1 Nội dung đầu vào: Mảng đối tượng khung hình. Mỗi đối tượng có type=image_url, image_url chứa url và frame_type. Dùng URL ảnh HTTPS và đặt frame_type thành first_frame. Mỗi vai trò khung hình xuất hiện tối đa một lần. Khóa chính xác: type, image_url, frame_type Điều kiện: Các khóa này mô tả từng đối tượng khung hình; image_url chỉ chứa url. Bỏ frame_images đối với yêu cầu chỉ có văn bản. | Mặc định— |
Trườnginput_references | Loạiarray | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngseed | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: -9.223.372.036.854.775.808 Tối đa: 9.223.372.036.854.775.807 | Mặc định— |
Trườngcallback_url | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Mẫu: ^https:// | Mặc định— |
Trườngsession_id | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngtrace | Loạiobject | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườnguser | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Tổ hợp tư liệu đầu vào
Văn bản thành video · Câu lệnh dạng văn bản. · Bắt buộc: model, prompt, duration
Cung cấp prompt dạng văn bản và duration là số giây nguyên. Chọn độ phân giải được hỗ trợ và tỷ lệ khung hình nếu cần.
model: Loại: string · heygen/heygen-video-1
prompt: Loại: string · Số byte UTF-8 tối đa: 10.000 · Bắt buộc có ký tự không phải khoảng trắng: Có
Ảnh thành video · Câu lệnh dạng văn bản và ảnh khung hình đầu tiên. · Bắt buộc: model, prompt, duration, frame_images
frame_images là một mảng. Mỗi đối tượng khung hình có type, image_url và frame_type; image_url chứa url. Đặt type thành image_url. Dùng first_frame. Mỗi vai trò khung hình xuất hiện tối đa một lần. Cung cấp URL ảnh HTTPS công khai cho mỗi khung hình. Chọn độ phân giải được hỗ trợ và tỷ lệ khung hình nếu cần.
Khóa chính xác: type, image_url, frame_type
model: Loại: string · heygen/heygen-video-1
prompt: Loại: string · Số byte UTF-8 tối đa: 10.000 · Bắt buộc có ký tự không phải khoảng trắng: Có
Reference to video · Câu lệnh dạng văn bản và các tham chiếu ảnh, video, âm thanh được hỗ trợ. · Bắt buộc: model, prompt, duration, input_references
input_references là một mảng đối tượng. Đặt type thành image_url, video_url, audio_url và dùng trường tương ứng chứa url. Dùng các URL HTTPS công khai. Bỏ frame_images để chọn chế độ tham chiếu. Chọn độ phân giải được hỗ trợ và tỷ lệ khung hình nếu cần.
model: Loại: string · heygen/heygen-video-1
prompt: Loại: string · Số byte UTF-8 tối đa: 10.000 · Bắt buộc có ký tự không phải khoảng trắng: Có
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 |
Tham sốmaterial_types | Hợp đồngtext, image, audio, video |
Tham sốadditional_properties | Hợp đồngfalse |
Tham sốoptional_controls | Hợp đồngresolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user |
Vòng đời: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_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í | 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: 2k | Phí Đầu ra · Giá video · Ước tính chỉ để so sánh $0.2 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: 480p | Phí Đầu ra · Giá video · Ước tính chỉ để so sánh $0.04 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: 768p | Phí Đầu ra · Giá video · Ước tính chỉ để so sánh $0.072 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íchế độ tạo: reference; độ phân giải: 2k | Phí Đầu ra · Giá video · Ước tính chỉ để so sánh $0.36 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íchế độ tạo: reference; độ phân giải: 480p | Phí Đầu ra · Giá video · Ước tính chỉ để so sánh $0.14 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íchế độ tạo: reference; độ phân giải: 768p | Phí Đầu ra · Giá video · Ước tính chỉ để so sánh $0.2 mỗi giây video |
| Cấu hìnhảnh tham chiếu đầu vào | Biểu mức phí— | Số lượng dự báo— | Đơn vị tính phímỗi ảnh tham chiếu đầu vào | Điều kiện tính phí— | Phí Đầu vào · ảnh tham chiếu đầu vào · Ước tính chỉ để so sánh $0.08 mỗi ảnh tham chiếu đầu vào |
| 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.2 ướ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: 2k | Phí Đầu ra · Giá video $0.18 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: 480p | Phí Đầu ra · Giá video $0.04 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: 768p | Phí Đầu ra · Giá video $0.06 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íchế độ tạo: reference; độ phân giải: 2k | Phí Đầu ra · Giá video $0.36 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íchế độ tạo: reference; độ phân giải: 480p | Phí Đầu ra · Giá video $0.08 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íchế độ tạo: reference; độ phân giải: 768p | Phí Đầu ra · Giá video $0.12 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'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"heygen/heygen-video-1","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', 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 result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.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
Nhận và lưu kết quả
Ailoot Ultra · Video
các URL nội dung đã ký thuộc quyền sở hữu
GET /v1/videos/{public_id}GET /v1/videos/{public_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ề.
Giữ lại mọi đầu ra thực tế thuộc quyền sở hữu và siêu dữ liệu đo lường được trả về.
Nếu cần kiểm tra phản hồi gốc
503 result_pending_check + id ban đầu + X-Should-Retry:false; tuyệt đối không gửi lại yêu cầu ban đầu
Trường phản hồi
| Trường | Loại | Ý nghĩa |
|---|---|---|
Trườngindex | Loạiinteger | Ý nghĩaVị trí bắt đầu từ không của video này trong danh sách outputs. |
Trườngcontent_url | Loạistring | Ý nghĩaURL tải xuống HTTPS đã ký cho video đã hoàn tất này. |
Trườngsha256 | Loạistring | null | Ý nghĩaGiá trị băm SHA-256 của các byte video gốc; null nếu không có dữ liệu. |
Trườngsize_bytes | Loạiinteger | null | Ý nghĩaDung lượng tệp video gốc tính bằng byte; null nếu không có dữ liệu. |
Trườngduration_ms | Loạiinteger | null | Ý nghĩaThời lượng video đo được tính bằng mili giây; null nếu không có dữ liệu. |
Trườngwidth | Loạiinteger | null | Ý nghĩaChiều rộng video tính bằng pixel; null nếu không có dữ liệu. |
Trườngheight | Loạiinteger | null | Ý nghĩaChiều cao video tính bằng pixel; null nếu không có dữ liệu. |
Trườngvideo_codec | Loạistring | null | Ý nghĩaMã định danh codec video; null nếu chưa được ghi nhận. |
Trườnghas_audio | Loạiboolean | null | Ý nghĩaVideo có chứa bản âm thanh hay không; null nếu chưa được đo. |
Trườngaudio_codec | Loạistring | null | Ý nghĩaMã định danh codec âm thanh; null khi chưa ghi nhận mã định danh. |
Lỗi và bước tiếp theo
| Phản hồi | Điều kiện | Bước tiếp theo |
|---|---|---|
Phản hồi404 · not_found_error | Điều kiệnKhông thể truy cập video hoặc không tìm thấy ID video này. | Bước tiếp theoKiểm tra quyền truy cập video. Với video hiện có, dùng ID công khai ban đầu và cùng khóa API. |
Phản hồi401 · authentication_error | Điều kiệnKhóa API không khớp với tài khoản đã xác thực. | Bước tiếp theoKiểm tra khóa API và quyền truy cập tài khoản trước khi gửi. |
Phản hồi400 · invalid_request_error | Điều kiệnKhông thể đọc yêu cầu hoặc chỉ số tải xuống không hợp lệ. | Bước tiếp theoSửa nội dung yêu cầu. Để tải xuống, chọn một chỉ số đầu ra được tác vụ ban đầu trả về. |
Phản hồi422 · price_unavailable | Điều kiệnKhông thể định giá cấu hình video đã chọn. | Bước tiếp theoChọn cấu hình video được hỗ trợ và điền đầy đủ các tùy chọn bắt buộc trước khi gửi yêu cầu đã sửa. |
Phản hồi422 · invalid_request_error | Điều kiệnĐầu vào video hoặc tác vụ tiếp nối ban đầu không hợp lệ. | Bước tiếp theoDùng đầu vào HTTPS hợp lệ. Để tiếp nối, dùng ID video công khai ban đầu đã hoàn tất của bạn với cùng khóa API. |
Phản hồi402 · billing_error | Điều kiệnSố dư khả dụng hoặc các giới hạn không cho phép giữ trước số tiền. | Bước tiếp theoKiểm tra số dư khả dụng và các giới hạn trước khi gửi yêu cầu mới. |
Phản hồi503 · server_error | Điều kiệnTạm thời không thể xác minh video, lưu trữ hoặc truy cập dịch vụ. | Bước tiếp theoĐợi dịch vụ khả dụng. Nếu đã có ID video, kiểm tra tác vụ ban đầu đó thay vì tạo thêm video. |
Phản hồi503 · result_pending_check | Điều kiệnKết quả video và khoản phí ban đầu cần được kiểm tra. | Bước tiếp theoGiữ lại ID video được trả về và kiểm tra tác vụ đó. Không gửi yêu cầu tạo thay thế trong khi tác vụ đang được kiểm tra. |
Phản hồi503 · owned_result_unavailable | Điều kiệnTạm thời không thể tải xuống video hiện có. | Bước tiếp theoKiểm tra lại cùng tác vụ video sau và tải xuống đầu ra hiện có. Một lần tạo mới sẽ tạo thao tác riêng. |
Phản hồi409 · video_not_ready | Điều kiệnNội dung video chưa được công bố. | Bước tiếp theoKiểm tra trạng thái tác vụ ban đầu. Tải xuống sau khi trạng thái là completed; nếu là failed, làm theo thông báo kiểm tra khoản phí. |
Bí danh
Bí danh mô hình
Ailoot Ultra heygen/heygen-video-1
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 · HeyGen: HeyGen Video
- Có những đầu vào và kết quả nào?
POST /v1/videos·heygen/heygen-video-1:text,image,audio,video→video- Yêu cầu sử dụng những trường nào?
POST /v1/videos·heygen/heygen-video-1:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,seed,callback_url,session_id,trace,user- Áp dụng những giới hạn nào?
POST /v1/videos·heygen/heygen-video-1:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807