创建素材

简介

在素材组内创建素材。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 文档

对话与文本

安全与音频

图像系列

视频系列

文本补全和向量嵌入

接口模块

简介

请求地址

查询参数

认证

请求参数

素材类型限制

请求示例

响应示例

​简介

​请求地址

​查询参数

​认证

​请求参数

​素材类型限制

​请求示例

​响应示例

简介

请求地址

查询参数

认证

请求参数

素材类型限制

请求示例

响应示例