Tạo nhóm tài sản

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

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

Tạo một nhóm cho nội dung hình ảnh, video và âm thanh được sử dụng bởi quy trình làm việc của Seedance.

Cánh đồng	Loại	Bắt buộc	Mô tả	Ví dụ
Name	string	Có	Tên của nhóm tài sản.	my-project-assets
model	string	Không	Mô hình thanh toán. Mặc định là volc-asset.	volc-asset

Ví dụ về JSON:

JSON

{
  "Name": "my-project-assets",
  "model": "volc-asset"
}

ví dụ về cURL:

bash

curl --request POST https://modelflare.dev/volc/asset/CreateAssetGroup \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "Name": "my-project-assets",
  "model": "volc-asset"
}'

Phản hồi

Nhóm đã được tạo.

Cánh đồng	Loại	Bắt buộc	Mô tả	Ví dụ
Id	string	Có	ID nhóm nội dung mới.	group-20260320141746-zsf6b

Ví dụ phản hồi:

JSON

{
  "Id": "group-20260320120601-hsw4s"
}

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.