Import Single Public Asset URL
Register a single public asset URL into the asset library.
Register one publicly accessible image, video, or audio URL into the asset library. When groupId is provided, the asset is imported into an existing asset group after ownership validation. When groupId is omitted, the upstream service creates a new asset group and this project stores the ownership relation after success.
curl -X POST "https://api.routescope.ai/v1/api/video-studio/assets/ecloud/import-url" \ -H "Content-Type: application/json" \ -d '{ "assetUrl": "https://example.com/path/to/image.png", "assetType": "Image" }'{
"data": {
"group": {
"groupId": "group_xxx",
"groupName": "Product asset group",
"displayName": "Product asset group",
"groupType": "AIGC"
},
"assets": [
{
"fileName": "image.png",
"assetName": "image.png",
"assetType": "Image",
"assetId": "asset_xxx",
"assetUrl": "https://example.com/path/to/asset.png",
"coverUrl": "https://example.com/path/to/asset.png",
"status": "SUCCESS",
"createdTime": "2026-06-30T00:00:00Z"
}
]
},
"error": {
"code": "not_found",
"message": "asset group not found"
},
"request_id": "req_xxx"
}{
"data": null,
"error": {
"code": "not_found",
"message": "asset group not found"
},
"request_id": "req_xxx"
}{
"data": null,
"error": {
"code": "not_found",
"message": "asset group not found"
},
"request_id": "req_xxx"
}Authorization
BearerAuth
Use this project's gateway token: Authorization: Bearer <API_TOKEN>. This is not the upstream asset-library API key.
In: header
Request Body
application/json
Publicly accessible asset URL.
uriAsset name.
Asset type.
"Image" | "Video" | "Audio"Existing asset group ID. When this field is provided, the server first validates whether the current user owns that asset group.
New asset group name. Can be used when groupId is omitted.
Asset group display name. Can be used when groupId is omitted.
Response Body
application/json
application/json
application/json
Last updated on