자료 조회

자료 처리 상태, 임시 접근 주소 및 오류 정보를 조회합니다.

업로드 후 약 3초 간격으로 자료 상태를 조회할 수 있습니다. Processing은 처리 중, Active는 생성에 사용 가능, Failed는 처리 실패를 나타내며 Result.Error를 읽어야 합니다.

Result.URL은 유효 기간이 약 11.5시간인 서명된 주소이며 영구 주소로 저장하거나 공개 배포해서는 안 됩니다. 자료는 현재 API 키가 속한 계정에 연결되며 존재하지 않거나 접근 권한이 없으면 ResourceNotFound를 반환할 수 있습니다.

POST/v1/assets/doubao/

자료 상태를 조회합니다. Processing이면 계속 폴링하고 Active이면 사용할 수 있으며 Failed이면 Result.Error를 읽어야 합니다.

인증

bearerAuth

인증Bearer <token>

전달 위치: header

쿼리 매개변수

Action*"GetAsset"

GetAsset으로 고정됩니다.

기본값"GetAsset"

허용 값

"GetAsset"

Version*"2024-01-01"

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

기본값"2024-01-01"

허용 값

"2024-01-01"

요청 본문

application/json

TypeScript 타입 정의

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

Id*string

asset- 접두사가 붙는 자료 ID입니다.

ProjectName?string

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

응답 본문

`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": "캐릭터 이미지",
    "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"
  }
}

인증

쿼리 매개변수

요청 본문

응답 본문

200application/json

400

401

404application/json

503

5XX

`application/json`

`application/json`