Clip video và lô clip

Tạo một clip

1. Mở Clip nhanh trong ứng dụng web, ở tab Một clip.
2. Viết prompt, chọn thời lượng, tỉ lệ và độ phân giải, và thêm ảnh tham chiếu nếu clip cần bắt đầu từ ảnh của bạn.
3. Xem báo giá rồi bắt đầu clip. Giá được lưu lại ngay khi báo giá.
4. Khi clip xong, tải về dưới dạng tệp MP4.

Ảnh tham chiếu

• Có ảnh tham chiếu thì clip được tạo theo kiểu ảnh thành video: clip bắt đầu từ ảnh của bạn.
• Ảnh phải là ảnh JPG, PNG hoặc WebP đã sẵn sàng trong cùng không gian làm việc. Ảnh khác bị từ chối với VIDEO_CLIP_REFERENCE_INVALID.
• reference_asset_id không tồn tại trong không gian làm việc của bạn sẽ nhận NOT_FOUND. Hãy dùng một ảnh trong thư viện của chính bạn.
• Nếu chưa xác nhận quyền dùng ảnh, báo giá kèm cảnh báo REFERENCE_RIGHTS_UNCONFIRMED. Cảnh báo không chặn clip; hãy xác nhận rằng bạn được phép dùng ảnh.

Tuyến

Mỗi clip được tạo trên một tuyến. Khi bạn không chọn, hệ thống dùng tuyến GPU của nền tảng sẵn sàng đầu tiên phù hợp với các tùy chọn. Nếu không tuyến nào phù hợp, báo giá bị từ chối với VIDEO_CLIP_ROUTE_UNAVAILABLE (HTTP 409); hãy đổi tùy chọn rồi báo giá lại.

• GPU nền tảng: clip được tạo trên GPU của chính chúng tôi và không có dữ liệu nào gửi tới nhà cung cấp mô hình bên ngoài.

Nhãn tuyến hiện cạnh báo giá, nên bạn biết clip sẽ được tạo ở đâu trước khi bắt đầu.

Lô clip

Một lô biến một bảng thành nhiều clip: mỗi dòng là một clip. Tạo lô ở tab Lô của Clip nhanh.

1. Chọn một tệp (CSV, TSV, TXT hoặc XLSX) hoặc dán mỗi dòng một prompt.
2. Có thể viết mẫu (template) với các chỗ giữ chỗ {{column}}. Mỗi dòng điền chỗ giữ chỗ từ các cột của chính nó. Không có mẫu thì cột prompt của dòng là prompt.
3. Có thể thêm các cột route, duration_seconds, ratio, resolution hoặc reference_asset_id. Giá trị trong dòng thay cho cài đặt của lô ở dòng đó.
4. Chọn Kiểm tra và báo giá. Mọi dòng được đọc và tính giá, chưa ghi gì; dòng có vấn đề được liệt kê kèm lý do.
5. Bắt đầu lô. Khi bắt đầu, hệ thống giữ trước tổng tiền của cả lô; các clip sau đó chạy theo nhóm tối đa 10.

product,ratio,duration_seconds
Ceramic mug,9:16,4
Linen shirt,9:16,6

Slow turntable shot of a {{product}} on a bright table

Tên cột được cắt khoảng trắng hai đầu, chuyển thành chữ thường và đổi khoảng trắng thành dấu gạch dưới, nên Product Name là cột product_name. Các cột của tệp CSV có thể ngăn cách bằng dấu phẩy, dấu chấm phẩy hoặc tab.

Trạng thái của lô và của mục

• Một lô là draft, running, paused, completed hoặc cancelled. Lô đang mở là bản nháp, lô đang chạy và lô đang tạm dừng.
• Một mục là pending, queued, running, ready, needs_attention, cancelled hoặc deleted.
• Ở màn hình lô bạn có thể tạm dừng, tiếp tục hoặc hủy lô, xem các dòng, và tải các clip đã xong dưới dạng ZIP.
• Mục cần chú ý giữ lý do của nó dưới dạng mã lỗi. Phần còn lại của lô vẫn chạy tiếp.

Qua MCP và REST

Một clip: quote_media_task với kind là video_clip tạo báo giá (miễn phí, token interactive là đủ). Sau khi người dùng đồng ý với giá, generate_media_task bắt đầu clip (token execute). get_media_task đọc trạng thái.

Một lô dùng ba công cụ. create_media_batch nhận bảng dưới dạng csv, xlsx_base64 hoặc rows (danh sách đối tượng, cột thành giá trị), cùng template và các tùy chọn clip. Lô bắt đầu ngay trừ khi start là false, khi đó tạo một bản nháp miễn phí để người dùng tự bắt đầu trong ứng dụng web. get_media_batch đọc trạng thái, số lượng theo trạng thái và tiến độ. list_media_batch_items liệt kê các mục theo thứ tự dòng và có thể lọc theo state.

quote_media_task {"workspace_id": "<id>", "kind": "video_clip", "prompt": "A ceramic mug on a bright table, slow turn", "duration_seconds": 4, "ratio": "9:16", "request_key": "<uuid>"}
create_media_batch {"workspace_id": "<id>", "rows": [{"product": "Ceramic mug"}, {"product": "Linen shirt"}], "template": "Slow turntable shot of a {{product}} on a bright table", "ratio": "9:16", "start": false, "request_key": "<uuid>"}

Các clip và lô giống như vậy cũng có qua HTTP: xem REST API. Người dùng có thể theo dõi lô trong ứng dụng web trong lúc agent chạy nó.