Nhận 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/GetAsset

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

Đọc một nội dung theo ID. Sử dụng lộ trình này để thăm dò nội dung tải lên không đồng bộ cho đến khi Status là Active hoặc Failed.

Cánh đồng	Loại	Bắt buộc	Mô tả	Ví dụ
Id	string	Có	ID nội dung cần truy vấn.	asset-20260528140922-d9646

Ví dụ về JSON:

JSON

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

ví dụ về cURL:

bash

curl --request POST https://modelflare.dev/volc/asset/GetAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "Id": "asset-20260528140922-d9646"
}'

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ụ
Id	string	Có	ID nội dung.	asset-20260528140922-d9646
Name	string	Không	Tên nội dung.	character-reference
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ờ; không duy trì nó như là tài liệu tham khảo thế hệ.	https://example.com/temporary-asset
AssetType	Image	Video	Audio	Không
GroupId	string	Không	Sở hữu ID nhóm.	group-20260320141746-zsf6b
Status	Processing	Active	Failed	Không
ProjectName	string	Không	Tên dự án.	default
CreateTime / UpdateTime	string	Không	Dấu thời gian ISO 8601.	2026-05-28T06:09:31Z

Ví dụ phản hồi:

JSON

{
  "Id": "asset-20260528140922-d9646",
  "Name": "character-reference",
  "AssetType": "Image",
  "GroupId": "group-20260320141746-zsf6b",
  "Status": "Active",
  "ProjectName": "default",
  "CreateTime": "2026-05-28T06:09:22Z",
  "UpdateTime": "2026-05-28T06:09:31Z"
}

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.