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/videos

Phần thân yêu cầu

TrườngLoạiBắt buộcMô tả
promptstringCóMô tả bằng văn bản về bối cảnh và chuyển động của video mong muốn.
modelstringKhôngMã định danh mô hình video, ví dụ kling-v4 hoặc doubao-seedance-2-0-260128.
duration_secondsnumberKhôngThời lượng video tính bằng giây (số dương tối đa 300, hoặc bí danh duration).
Additional fieldsobjectKhôngCá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/assets
GET/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ộc sourceUrl và assetType (image hoặc video), cùng displayName tù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, failed và 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/videos là bí danh phương tiện cũ của POST /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/generations chấp nhận tải trọng định dạng CreateVideoGenerationRequest.
  • Đường ống bất đồng bộ hợp nhất: POST /v1/async-tasks/video-generations cung cấp hợp đồng vòng đời tác vụ bất đồng bộ chuẩn của v4.