> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gravitex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 자산 생성 (CreateAsset)

> CreateAsset — POST /api/v3/seedance

## 소개

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

## 인증

<ParamField header="Authorization" type="string" required>
  Bearer Token, 예: `Bearer sk-your_token_key`
</ParamField>

## 요청 매개변수

<ParamField body="GroupId" type="string" required>
  자산 그룹 ID
</ParamField>

<ParamField body="URL" type="string" required>
  자산의 공개 접근 가능 URL
</ParamField>

<ParamField body="AssetType" type="string" required>
  `Image` / `Video` / `Audio`
</ParamField>

<ParamField body="Name" type="string">
  자산 이름, `ListAssets` 퍼지 검색에만 사용되며 **모델 추론에는 사용되지 않음**
</ParamField>

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

<ParamField body="ProjectName" type="string" default="default">
  프로젝트 이름
</ParamField>

<Warning>
  `Moderation.Strategy = "Skip"`은 대부분의 비기준 검토만 건너뛰며, 완전히 비활성화하는 것은 아닙니다. 콘텐츠 자체가 민감/성인 콘텐츠이고 승인을 받은 경우, `seedance-2-0-NSFW` 모델로 생성 작업을 시작하는 것을 권장합니다.
</Warning>

## 자산 유형 제한

| 유형      | 형식                                                 | 길이    | 해상도/크기                                                      | 종횡비 (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  | —         |

## 요청 예제

```bash theme={null}
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"
  }'
```

## 응답 예제

```json theme={null}
{
  "ResponseMetadata": {"Action": "CreateAsset"},
  "Result": {"Id": "asset-20260710-xyz"}
}
```

생성 성공 후 [작업 생성](/ko/api-reference/endpoint/seedance-2.0-new/create-video-generation)에서 `asset://asset-20260710-xyz`로 참조할 수 있습니다.