Create Asset
Create an image, video, or audio asset in a group. The asset URL must be publicly reachable.
Create one asset in an asset group. assetUrl must be a publicly reachable HTTP or HTTPS address; the server downloads the file from it. The asset can be an image, video, or audio file. Each user can own up to 10,000 assets. Each request creates one asset; call this endpoint once per asset when creating several.
Base URL
https://api.autorouter.top— Production
Authentication
BearerAuth: http (bearer)
Authenticate using a Bearer Token.
Format: Authorization: Bearer sk-xxxxxx
Endpoints
POST /seedance/v1/asset
Create Asset
Create one asset. On success, body is the asset ID.
Request Body
Content-Type: application/json
Example:
{
"groupId": "volcano-group-xxx",
"assetName": "产品介绍视频",
"assetUrl": "https://example.com/test.mp4",
"assetType": "Video"
}Properties:
| Name | Type | Required | Description |
|---|---|---|---|
groupId | string | Yes | Asset group ID (Volcano asset group ID) |
assetName | string | Yes | Asset name, up to 64 characters |
assetUrl | string | Yes | Asset URL. Must be a publicly reachable HTTP or HTTPS address |
assetType | string | Yes | Asset type: Image, Video, or Audio |
groupIdstring(Required)
Asset group ID (Volcano asset group ID)
assetNamestring(Required)
Asset name, up to 64 characters
Example: 产品介绍视频
assetUrlstring(Required)
Asset URL. Must be a publicly reachable HTTP or HTTPS address
The server downloads the file from this URL. The link must be reachable from the public internet at request time.
assetTypestring(Required)
Asset type: Image, Video, or Audio
Image: ImageVideo: VideoAudio: Audio
Responses
200: Success
Content-Type: application/json
Request examples
curl -X POST "https://api.autorouter.top/seedance/v1/asset" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxxxxx" \
-d '{
"groupId": "volcano-group-xxx",
"assetName": "产品介绍视频",
"assetUrl": "https://example.com/test.mp4",
"assetType": "Video"
}'Response examples
{
"requestId": "1803ae665a704fbd90d20b3d50085033",
"state": "OK",
"errorCode": "",
"errorMessage": "",
"body": "asset-id"
}Response fields:
| Name | Type | Description |
|---|---|---|
requestId | string | Request ID |
state | string | Call status. OK means success, ERROR means failure |
errorCode | string | Error code. Empty string or null on success |
errorMessage | string | Error message. Empty string or null on success |
body | string | ID of the created asset |
statestring
Call status. OK means success, ERROR means failure
OK: SuccessERROR: Failure. CheckerrorCodeanderrorMessage
bodystring
ID of the created asset
Error handling
When the HTTP status is 200, still check state in the response body.
state | Description |
|---|---|
OK | The call succeeded. Business data is in body |
ERROR | The call failed. errorCode is the error code and errorMessage is the error message |
On success, errorCode and errorMessage may be an empty string or null.