Upload an asset

Upload an asset to a real-person or virtual-character asset group with the Doubao Action format.

Upload a publicly accessible image, video, or audio file to the specified asset group. A 200 response only means the upload request has been accepted. Continue retrieving the asset until its status changes to Active or Failed.

An asset in a real-person asset group must match the verified face. A mismatch causes the asset to enter the failed state and return FaceMismatch.

POST/v1/assets/doubao/

The upload request is processed asynchronously. A successful response only means the task was accepted; continue calling GetAsset to retrieve its status.

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Query Parameters

Action*"CreateAsset"

Always CreateAsset.

Default"CreateAsset"

Value in

"CreateAsset"

Version*"2024-01-01"

API version, always 2024-01-01.

Default"2024-01-01"

Value in

"2024-01-01"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

GroupId*string

Target asset group ID.

URL*string

Public asset URL that the server can access directly.

Formaturi

AssetType*string

Asset type.

Value in

"Image"
"Video"
"Audio"

Name?string

Asset name.

Description?string

Asset description.

ProjectName?string

Managed by the platform. A supplied value is not used for business partitioning.

Moderation?

Content pre-filtering configuration for a single asset upload.

Response Body

`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": "Character image",    "Description": "Front-facing portrait",    "Moderation": {      "Strategy": "Skip"    }  }'

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

Authorization

Query Parameters

Request Body

Response Body

200application/json

400

401

404

503

5XX

`application/json`