Create asset (CreateAsset)

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

Request URL

POST

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

Query Parameters

string

required

Action name, fixed as CreateAsset

string

required

Version, fixed as 2024-01-01

Authentication

string

required

Bearer Token, e.g. Bearer sk-your_token_key

Request parameters

string

required

Asset group ID

string

required

Publicly accessible URL for the asset

string

required

Image / Video / Audio

string

Asset name; used only for fuzzy search in ListAssets, not used in model inference

object

Content pre-moderation policy, {"Strategy": "Default"|"Skip"}; Default (default) = pre-moderation enabled, Skip = skip most non-baseline content safety policies

Moderation.Strategy = "Skip" only skips most non-baseline moderation—it does not fully disable it.

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

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

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

After creation, reference asset://asset-20260710-xyz in Create video generation task.

API documentation

Chat & text

Safety & audio

Image Series

Video Series

Completions & Embeddings

Interface module

Introduction

Request URL

Query Parameters

Authentication

Request parameters

Asset type limits

Request example

Response example

​Introduction

​Request URL

​Query Parameters

​Authentication

​Request parameters

​Asset type limits

​Request example

​Response example

Introduction

Request URL

Query Parameters

Authentication

Request parameters

Asset type limits

Request example

Response example