Tạo Video và Quản lý Tài nguyên
Tạo video bằng các mô hình Kling v4 và Seedance, đồng thời tham chiếu các tài nguyên đã ủy quyền.
Gửi tác vụ tạo video và quản lý tài nguyên phương tiện được ủy quyền thông qua các điểm cuối video gốc.
POST
/v1/videosPhần thân yêu cầu
| Trường | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
prompt | string | Có | Mô tả bằng văn bản về bối cảnh và chuyển động của video mong muốn. |
model | string | Không | Mã định danh mô hình video, ví dụ kling-v4 hoặc doubao-seedance-2-0-260128. |
duration_seconds | number | Không | Thời lượng video tính bằng giây (số dương tối đa 300, hoặc bí danh duration). |
| Additional fields | object | Không | Các tham số video mở rộng (như resolution, aspect_ratio, first_frame_url, last_frame_url) được chuyển tiếp nguyên vẹn đến công cụ ngược dòng. |
Tài nguyên ủy quyền Seedance
POST
/v1/seedance/assetsGET
/v1/seedance/assets/{asset_id}- Đăng ký tài sản: Gửi
POST /v1/seedance/assets(operationId: seedance_assets.create) với JSON chứa các trường bắt buộcsourceUrlvàassetType(imagehoặcvideo), cùngdisplayNametùy chọn. - Tham chiếu URI: Tham chiếu trực tiếp phương tiện đã đăng ký bằng
asset://{asset_id}trong URL khung hình hoặc tham số nâng cao. - Cô lập khách thuê: Tài sản được cô lập an toàn trong thư viện tài sản hiện tại của khách thuê và được xác minh đối với bộ lưu trữ thượng nguồn.
Trạng thái tác vụ và Tải xuống
GET
/v1/videos/{task_id}- Thăm dò trạng thái: Truy vấn trạng thái tác vụ qua
GET /v1/videos/{task_id}(operationId: legacy_media.video.get), hỗ trợ 9 trạng thái:queued,submitting,submitted,running,ingesting_artifacts,cancel_requested,completed,failedvàcancelled. - Tải xuống kết quả: Tải xuống tệp video nhị phân hoàn tất qua
GET /v1/videos/{task_id}/content. - Hỗ trợ Kling v4: Hỗ trợ đầy đủ tạo video từ văn bản, hình ảnh khung hình đầu và chuyển tiếp khung hình cuối.
Bí danh tương thích
- Bí danh phương tiện cũ:
POST /openai/v1/videoslà bí danh phương tiện cũ củaPOST /v1/videos(legacy_media.video.create.alias), tuân theo cùng cấu trúc. - Tuyến tác vụ cũ: Tuyến
POST /v1/videos/generationschấp nhận tải trọng định dạngCreateVideoGenerationRequest. - Đường ống bất đồng bộ hợp nhất:
POST /v1/async-tasks/video-generationscung cấp hợp đồng vòng đời tác vụ bất đồng bộ chuẩn của v4.