Truy vấn tư liệu

Truy vấn trạng thái xử lý tư liệu, URL truy cập tạm thời và thông tin lỗi.

Sau khi tải lên, có thể truy vấn trạng thái tư liệu mỗi khoảng 3 giây. Processing nghĩa là vẫn đang xử lý, Active nghĩa là có thể dùng để tạo nội dung, Failed nghĩa là xử lý thất bại và cần đọc Result.Error.

Result.URL là URL có chữ ký, có hiệu lực khoảng 11,5 giờ; không nên lưu làm URL cố định hoặc phân phối công khai. Tư liệu được gắn với tài khoản sở hữu API Key hiện tại; nếu không tồn tại hoặc không có quyền truy cập, API có thể trả về ResourceNotFound.

POST/v1/assets/doubao/

Truy vấn trạng thái tư liệu. Với Processing, cần tiếp tục truy vấn định kỳ; với Active, có thể sử dụng; với Failed, cần đọc Result.Error.

Xác thực

bearerAuth

Xác thựcBearer <token>

Vị trí truyền: header

Tham số truy vấn

Action*"GetAsset"

Có giá trị cố định là GetAsset.

Giá trị mặc định"GetAsset"

Giá trị được phép

"GetAsset"

Version*"2024-01-01"

Phiên bản API, có giá trị cố định là 2024-01-01.

Giá trị mặc định"2024-01-01"

Giá trị được phép

"2024-01-01"

Nội dung yêu cầu

application/json

Định nghĩa kiểu TypeScript

Sử dụng kiểu request body trong TypeScript.

Id*string

ID tư liệu có tiền tố asset-.

ProjectName?string

Được nền tảng quản lý tập trung; giá trị được truyền không được sử dụng để phân chia phạm vi nghiệp vụ.

Nội dung phản hồi

`application/json`

curl -X POST "https://example.com/v1/assets/doubao/?Action=GetAsset&Version=2024-01-01" \  -H "Content-Type: application/json" \  -d '{    "Id": "asset-20260807163106-krnhc"  }'

{
  "ResponseMetadata": {
    "RequestId": "20260807163109F1A2",
    "Action": "GetAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "xx-xxxxxx"
  },
  "Result": {
    "Id": "asset-20260807163106-krnhc",
    "Name": "Hình ảnh nhân vật",
    "URL": "https://example.com/signed-asset?X-Tos-Expires=41400",
    "AssetType": "Image",
    "GroupId": "group-20260807163049-f9mfw",
    "Status": "Active",
    "Moderation": {
      "Strategy": "Default"
    },
    "CreateTime": "2026-08-07T08:31:06Z",
    "UpdateTime": "2026-08-07T08:31:09Z"
  }
}

Xác thực

Tham số truy vấn

Nội dung yêu cầu

Nội dung phản hồi

200application/json

400

401

404application/json

503

5XX

`application/json`

`application/json`