Tải tư liệu lên

Tải tư liệu lên nhóm tư liệu người thật hoặc nhân vật ảo bằng định dạng Doubao Action.

Tải hình ảnh, video hoặc âm thanh có thể truy cập công khai lên nhóm tư liệu được chỉ định. Phản hồi 200 chỉ cho biết yêu cầu tải lên đã được tiếp nhận; cần tiếp tục truy vấn tư liệu cho đến khi trạng thái chuyển sang Active hoặc Failed.

Tư liệu trong nhóm người thật phải khớp với khuôn mặt đã được xác minh; nếu không khớp, tư liệu chuyển sang trạng thái thất bại và trả về FaceMismatch.

POST/v1/assets/doubao/

Yêu cầu tải lên được xử lý bất đồng bộ; phản hồi thành công chỉ cho biết tác vụ đã được tiếp nhận, cần tiếp tục gọi GetAsset để truy vấn trạng thái.

Xác thực

bearerAuth

Xác thựcBearer <token>

Vị trí truyền: header

Tham số truy vấn

Action*"CreateAsset"

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

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

Giá trị được phép

"CreateAsset"

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.

GroupId*string

ID nhóm tư liệu đích.

URL*string

URL tư liệu công khai mà máy chủ có thể truy cập trực tiếp.

Định dạnguri

AssetType*string

Loại tư liệu.

Giá trị được phép

"Image"
"Video"
"Audio"

Name?string

Tên tư liệu.

Description?string

Mô tả tư liệu.

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ụ.

Moderation?

Cấu hình lọc trước nội dung cho một lần tải tư liệu lên.

Nội dung phản hồi

`application/json`

curl -X POST "https://example.com/v1/assets/doubao/?Action=CreateAsset&Version=2024-01-01" \  -H "Content-Type: application/json" \  -d '{    "GroupId": "group-20260807163049-f9mfw",    "URL": "https://example.com/portrait.png",    "AssetType": "Image",    "Name": "Hình ảnh nhân vật",    "Description": "Ảnh chính diện",    "Moderation": {      "Strategy": "Skip"    }  }'

{
  "ResponseMetadata": {
    "RequestId": "20260807163106A12C89",
    "Action": "CreateAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "xx-xxxxxx"
  },
  "Result": {
    "Id": "asset-20260807163106-krnhc"
  }
}

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

404

503

5XX

`application/json`