Tạo nội dung video

Sẵn có

Trang này ghi lại lộ trình quản lý tài sản Modelflare. Cuộc gọi yêu cầu Khóa API thông minh hợp lệ hoặc khóa API nhóm phương tiện, kênh phương tiện có sẵn và quyền cần thiết.

Ghi chú

Cổng ghi lại ID tài sản của nhà cung cấp, trạng thái và quyền sở hữu của người dùng. Thư viện cục bộ Castaly vẫn tách biệt với không gian tên tài sản của nhà cung cấp.

Điểm cuối

POST https://modelflare.dev/volc/asset/CreateAsset

Xác thực

Sử dụng khóa API Modelflare:

bash

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Gửi Idempotency-Key với các yêu cầu tạo, cập nhật và xóa. Việc thử lại cùng một khóa cho cùng một người dùng sẽ phát lại phản hồi đã lưu mà không lặp lại đột biến.

Yêu cầu

Thêm video vào nhóm hiện có. ID được trả về có thể được sử dụng bởi các quy trình công việc Seedance được hỗ trợ sau khi xử lý.

Cánh đồng	Loại	Bắt buộc	Mô tả	Ví dụ
GroupId	string	Có	ID nhóm nội dung mục tiêu.	group-20260320141746-zsf6b
AssetType	Video	Có	Phải là Video.	Video
URL	string	Có	URL video công khai. Video Base64 không được chấp nhận. Sử dụng MP4 hoặc MOV, 2–30 giây, 24–60 FPS, 300–6000 px mỗi bên, tỷ lệ khung hình 0,4–2,5, 480p/720p/1080p/4K, tổng số pixel 407696–2086876 và không quá 200 MB.	https://example.com/video.mp4
file	binary	Không	Nhiều phần thay thế cho URL có cùng giới hạn video.	video.mp4
Name	string	Không	Tên hiển thị/tìm kiếm, tối đa 64 ký tự.	scene-clip
model	string	Có		volc-asset-video
ProjectName	string	Không	Tên dự án. Nó phải phù hợp với nhóm mục tiêu; mặc định là default.	default

Ví dụ về JSON:

JSON

{
  "model": "volc-asset-video",
  "GroupId": "group-20260320141746-zsf6b",
  "Name": "scene-clip",
  "AssetType": "Video",
  "URL": "https://example.com/video.mp4",
  "ProjectName": "default"
}

ví dụ về nhiều phần/biểu mẫu dữ liệu:

bash

curl --request POST https://modelflare.dev/volc/asset/CreateAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --form "model=volc-asset-video" \
  --form "GroupId=group-20260320141746-zsf6b" \
  --form "file=@video.mp4"

Phản hồi

Video đã được xử lý không đồng bộ. Thăm dò GetAsset cho đến khi Status là Active hoặc Failed. Không có SLA thời gian tải lên; một video thông thường mất khoảng 9–12 giây, trong khi hàng đợi xem xét bận rộn có thể mất khoảng 10 giây đến 2 phút.

Cánh đồng	Loại	Bắt buộc	Mô tả	Ví dụ
Id	string	Có	ID nội dung. Chỉ sử dụng asset://<ID> sau khi trạng thái là Active.	asset-20260528140922-d9646

Ví dụ phản hồi:

JSON

{
  "Id": "asset-20260528140922-d9646"
}

Lỗi

Trạng thái	Ý nghĩa
400	Yêu cầu không hợp lệ.
401	Khóa API bị thiếu hoặc trái phép.

Ví dụ về nội dung lỗi (khi được trả về):

JSON

{
  "error": {
    "code": "invalid_request",
    "message": "Request validation failed."
  }
}

Việc tạo hình ảnh, video và âm thanh không đồng bộ. Sau khi nhận được ID nội dung, hãy gọi GetAsset và chỉ sử dụng tham chiếu asset://<ID> khi trạng thái là Active.