> ## 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 — 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"}
}
```

创建成功后，可在 [创建任务](/cn/api-reference/endpoint/seedance-2.0-new/create-video-generation) 里用 `asset://asset-20260710-xyz` 引用。