Liệt kê các 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/ListAssetGroups

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ê các nhóm với các bộ lọc tên, ID và loại nhóm tùy chọn. Việc đọc không phải chịu phí tạo.

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 mờ.	my-project
Filter.GroupIds	string[]	Không	Lọc chính xác theo danh sách ID nhóm.	["group-20260320141746-zsf6b"]
Filter.Id	string	Không	Lọc chính xác theo một 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": "my-project",
    "GroupIds": [
      "group-20260320141746-zsf6b"
    ],
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}

ví dụ về cURL:

bash

curl --request POST https://modelflare.dev/volc/asset/ListAssetGroups \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "volc-asset",
  "Filter": {
    "Name": "my-project",
    "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	Nhóm nội dung có Id, Name, GroupType và Status.	{ Id, Name, GroupType, Status }
Items[].Id / Name	string	Không	Nhận dạng nhóm và tên hiển thị.	group-20260320141746-zsf6b / my-project-assets
Items[].GroupType / Status	string	Không	Loại nhóm và trạng thái hiện tại.	AIGC / Active
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ố nhóm phù hợp.	1

Ví dụ phản hồi:

JSON

{
  "Items": [
    {
      "Id": "group-20260320141746-zsf6b",
      "Name": "my-project-assets",
      "GroupType": "AIGC",
      "Status": "Active"
    }
  ],
  "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.