> ## 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.

# Create asset (CreateAsset)

> CreateAsset — POST /api/v3/seedance

## Introduction

Create an asset within an asset group. `URL` must be a publicly accessible address; **Base64 / local file upload is not supported**. After creation, reference it in video generation tasks with `asset://<Id>`.

## Authentication

<ParamField header="Authorization" type="string" required>
  Bearer Token, e.g. `Bearer sk-your_token_key`
</ParamField>

## Request parameters

<ParamField body="GroupId" type="string" required>
  Asset group ID
</ParamField>

<ParamField body="URL" type="string" required>
  Publicly accessible URL for the asset
</ParamField>

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

<ParamField body="Name" type="string">
  Asset name; used only for fuzzy search in `ListAssets`, **not used in model inference**
</ParamField>

<ParamField body="Moderation" type="object">
  Content pre-moderation policy, `{"Strategy": "Default"|"Skip"}`; `Default` (default) = pre-moderation enabled, `Skip` = skip most non-baseline content safety policies
</ParamField>

<ParamField body="ProjectName" type="string" default="default">
  Project name
</ParamField>

<Warning>
  `Moderation.Strategy = "Skip"` only skips most non-baseline moderation—it does not fully disable it. For sensitive/adult content with authorization, use the `seedance-2-0-NSFW` model for generation tasks instead.
</Warning>

## Asset type limits

| Type    | Formats                                            | Duration | Resolution / size                                                           | Aspect ratio (W/H) | Size     | Frame rate |
| ------- | -------------------------------------------------- | -------- | --------------------------------------------------------------------------- | ------------------ | -------- | ---------- |
| `Image` | jpeg / png / webp / bmp / tiff / gif / heic / heif | —        | 300–6000px width/height                                                     | 0.4–2.5            | \< 30 MB | —          |
| `Video` | mp4 / mov                                          | 2–15s    | 480p/720p/1080p, 300–6000px width/height, total pixels (W×H) 409600–2086876 | 0.4–2.5            | ≤ 50 MB  | 24–60 fps  |
| `Audio` | wav / mp3                                          | 2–15s    | —                                                                           | —                  | ≤ 15 MB  | —          |

## Request example

```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"
  }'
```

## Response example

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

After creation, reference `asset://asset-20260710-xyz` in [Create video generation task](/en/api-reference/endpoint/seedance-2.0-new/create-video-generation).