Skip to main content
POST
자산 생성

소개

그룹 내에 자산을 생성합니다. Content-Type: application/json; 공개 https URL만 지원(BytePlus가 직접 가져올 수 있어야 함). Base64 / Data URI / multipart 업로드는 지원하지 않습니다. 로컬 파일은 먼저 OSS / TOS / S3 등에 업로드하세요. aigcliveness_face 라이브러리 모두 Image / Video / Audio를 지원합니다. 초기 statuspending이며, asset:// 사용 전 active가 될 때까지 폴링하세요(보통 1~3분).
BytePlus CreateAsset은 2026년부터 Base64를 더 이상 지원하지 않습니다. Create an Asset 참조.

인증

string
필수
Bearer Token, 예: Bearer sk-xxxxxxxxxx

요청 본문

string
필수
공개 https URL; 게이트웨이가 업스트림에 그대로 전달
string
필수
string
기본값:"Image"
Image / Video / Audio(대소문자 구분 없음)
string
표시 이름(≤ 64자; UI/검색 전용, 추론에 사용되지 않음)

형식 및 크기 제한

이미지 (Image)

비디오 (Video)

오디오 (Audio)

게이트웨이는 URL 접미사만 검사합니다. 크기/길이 등은 BytePlus가 비동기로 검증합니다. 유효하지 않은 자산은 status: failed로 종료됩니다.

예제

이미지, 비디오, 오디오 모두 동일한 JSON 구조—asset_type과 URL만 다릅니다:

응답

다음 단계: 자산 목록 조회 또는 자산 조회로 상태 폴링.