Theme
Upload asset
Import an asset into a specified asset group. URL pulls a public HTTPS resource into the asset library (moderation / transcoding is handled server-side). On success, an AssetId is returned. In Create video, prefer referencing it as asset://{assetId} instead of repeating the public URL.
http
POST /v1/seedance/asset/CreateAssetHeaders
| Name | Type | Required | Description |
|---|---|---|---|
| string | Yes | Request authentication. Use a Bearer Token, for example: | |
| string | Yes | Request content type. Must be set to |
Request body
| Name | Type | Required | Description |
|---|---|---|---|
| string | Yes | Asset group ID from data.Id returned by Create asset group | |
| string | Yes | Public HTTPS URL of the asset to import | |
| string | Yes | Asset type: , , | |
| string | Yes | Asset name |
Request example
bash
curl -X POST https://octopusx.ai/v1/seedance/asset/CreateAsset \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"GroupId": "group-20260412163933-zwxdc",
"URL": "https://example.com/source.webp",
"AssetType": "Image",
"Name": "child"
}'Response example
json
{
"state": 1,
"data": {
"Id": "asset-xxx",
"task_id": "task_xxx"
},
"error": null
}Response fields
| Name | Type | Description |
|---|---|---|
| integer | Business status. means success | |
| string | Asset ID (). Reference as in generation requests | |
| string | Import task ID for polling via Get asset | |
| object | Error information. on success |