자산 생성 (CreateAsset)

소개

자산 그룹 내에 자산을 생성합니다. URL은 공개 접근 가능한 주소여야 하며, Base64 / 로컬 파일 직접 업로드는 지원하지 않습니다. 생성 성공 후 asset://<Id>로 비디오 생성 작업에서 참조할 수 있습니다.

요청 주소

POST

https://api.gravitex.ai/api/v3/seedance?Action=CreateAsset&Version=2024-01-01

쿼리 파라미터

string

필수

작업 이름, 고정값 CreateAsset

string

필수

버전, 고정값 2024-01-01

인증

string

필수

Bearer Token, 예: Bearer sk-your_token_key

요청 매개변수

string

필수

자산 그룹 ID

string

필수

자산의 공개 접근 가능 URL

string

필수

Image / Video / Audio

string

자산 이름, ListAssets 퍼지 검색에만 사용되며 모델 추론에는 사용되지 않음

object

콘텐츠 사전 검토 정책, {"Strategy": "Default"|"Skip"}; Default(기본값) = 사전 검토 활성화, Skip = 대부분의 비기준 콘텐츠 안전 검토 정책 건너뛰기

Moderation.Strategy = "Skip"은 대부분의 비기준 검토만 건너뛰며, 완전히 비활성화하는 것은 아닙니다.

자산 유형 제한

유형	형식	길이	해상도/크기	종횡비 (W/H)	크기	프레임률
`Image`	jpeg / png / webp / bmp / tiff / gif / heic / heif	—	가로세로 300–6000px	0.4–2.5	< 30 MB	—
`Video`	mp4 / mov	2–15초	480p/720p/1080p, 가로세로 300–6000px, 총 픽셀 (W×H) 409600–2086876	0.4–2.5	≤ 50 MB	24–60 fps
`Audio`	wav / mp3	2–15초	—	—	≤ 15 MB	—

요청 예제

curl -X POST "https://api.gravitex.ai/api/v3/seedance?Action=CreateAsset&Version=2024-01-01" \
  -H "Authorization: Bearer sk-your_token_key" \
  -H "Content-Type: application/json" \
  -d '{
    "GroupId": "group-20260710-abcde",
    "URL": "https://your-cdn.com/portrait.jpg",
    "AssetType": "Image",
    "Name": "portrait.jpg"
  }'

응답 예제

{
  "ResponseMetadata": {"Action": "CreateAsset"},
  "Result": {"Id": "asset-20260710-xyz"}
}

생성 성공 후 작업 생성에서 asset://asset-20260710-xyz로 참조할 수 있습니다.

API 문서

대화 및 텍스트

안전 및 오디오

이미지 시리즈

비디오 시리즈

텍스트 완성 및 임베딩

인터페이스 모듈

소개

요청 주소

쿼리 파라미터

인증

요청 매개변수

자산 유형 제한

요청 예제

응답 예제

​소개

​요청 주소

​쿼리 파라미터

​인증

​요청 매개변수

​자산 유형 제한

​요청 예제

​응답 예제

소개

요청 주소

쿼리 파라미터

인증

요청 매개변수

자산 유형 제한

요청 예제

응답 예제