자료 업로드

Doubao Action 형식으로 실제 인물 또는 가상 캐릭터 자료 그룹에 자료를 업로드합니다.

공개적으로 접근 가능한 이미지, 비디오 또는 오디오를 지정한 자료 그룹에 업로드합니다. API가 200을 반환하는 것은 업로드 요청이 접수되었다는 의미일 뿐이며 상태가 Active 또는 Failed가 될 때까지 자료를 계속 조회해야 합니다.

실제 인물 자료 그룹의 자료는 확인된 얼굴과 일치해야 합니다. 일치하지 않으면 자료가 실패 상태가 되고 FaceMismatch를 반환합니다.

POST/v1/assets/doubao/

업로드 요청은 비동기로 처리됩니다. 성공 응답은 작업이 접수되었다는 의미일 뿐이며 계속 GetAsset을 호출하여 상태를 조회해야 합니다.

인증

bearerAuth

인증Bearer <token>

전달 위치: header

쿼리 매개변수

Action*"CreateAsset"

CreateAsset으로 고정됩니다.

기본값"CreateAsset"

허용 값

"CreateAsset"

Version*"2024-01-01"

API 버전이며 2024-01-01로 고정됩니다.

기본값"2024-01-01"

허용 값

"2024-01-01"

요청 본문

application/json

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

GroupId*string

대상 자료 그룹 ID입니다.

URL*string

서버에서 직접 접근할 수 있는 공개 자료 URL입니다.

형식uri

AssetType*string

자료 유형입니다.

허용 값

"Image"
"Video"
"Audio"

Name?string

자료 이름입니다.

Description?string

자료 설명입니다.

ProjectName?string

플랫폼에서 통합 관리하며 전달한 값은 비즈니스 분할에 사용하지 않습니다.

Moderation?

단일 자료 업로드의 콘텐츠 사전 필터링 설정입니다.

응답 본문

`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": "캐릭터 이미지",
    "Description": "정면 사진",
    "Moderation": {
      "Strategy": "Skip"
    }
  }'

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

인증

쿼리 매개변수

요청 본문

응답 본문

200application/json

400

401

404

503

5XX

`application/json`