Liệt kê nội dung

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

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

Liệt kê nội dung bằng các bộ lọc tên, nhóm và loại nhóm tùy chọn. Đợi Status: Active trước khi sử dụng ID trong yêu cầu Seedance.

Cánh đồng	Loại	Bắt buộc	Mô tả	Ví dụ
model	string	Có	Mô hình thanh toán. Mặc định là volc-asset.	volc-asset
Filter.Name	string	Không	Bộ lọc tên nội dung mờ.	character
Filter.GroupIds	string[]	Không	Lọc theo ID nhóm.	["group-20260320141746-zsf6b"]
Filter.GroupType	AIGC	LivenessFace	Không	Lọc theo loại nhóm.
PageNumber	integer	Không	Số trang. Mặc định là 1.	1
PageSize	integer	Không	Mục trên mỗi trang. Mặc định là 10.	10

Ví dụ về JSON:

JSON

{
  "model": "volc-asset",
  "Filter": {
    "Name": "character",
    "GroupIds": [
      "group-20260320141746-zsf6b"
    ],
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}

ví dụ về cURL:

bash

curl --request POST https://modelflare.dev/volc/asset/ListAssets \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "volc-asset",
  "Filter": {
    "Name": "character",
    "GroupIds": [
      "group-20260320141746-zsf6b"
    ],
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}'

Phản hồi

Yêu cầu đã thành công.

Cánh đồng	Loại	Bắt buộc	Mô tả	Ví dụ
Items[]	object[]	Không	Đối tượng nội dung có danh tính, loại, nhóm, trạng thái, dự án và dấu thời gian.	{ Id, Name, AssetType, GroupId, Status, ... }
Items[].Id / Name	string	Không	Nhận dạng nội dung và tên hiển thị.	asset-20260528140922-d9646 / character-reference
Items[].AssetType / GroupId	string	Không	Loại tài sản và nhóm sở hữu.	Image / group-20260320141746-zsf6b
Items[].Status / ProjectName	string	Không	Trạng thái xử lý và tên dự án.	Active / default
Items[].CreateTime / UpdateTime	string	Không	Dấu thời gian tạo và cập nhật ISO 8601.	2026-03-20T14:25:01Z
Items[].URL	string	Không	URL tệp tạm thời. Thời gian tồn tại được ghi nhận là 12 giờ; sử dụng asset://<ID> cho các yêu cầu tạo.	https://example.com/temporary-asset
Items[].Error	object	Không	Lỗi xử lý với Code và Message khi Status là Failed.	{ Code, Message }
PageNumber	integer	Không	Số trang được trả về.	1
PageSize	integer	Không	Kích thước trang được trả về.	10
TotalCount	integer	Không	Tổng số tài sản phù hợp.	2

Ví dụ phản hồi:

JSON

{
  "Items": [
    {
      "Id": "asset-20260528140922-d9646",
      "Name": "character-reference",
      "AssetType": "Image",
      "GroupId": "group-20260320141746-zsf6b",
      "Status": "Active",
      "ProjectName": "default"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1
}

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.