Routescope APIRoutescope API
Model API DocumentationVideo Models

Upload Assets and Create Asset Group

Upload one or more asset files and create a new Video Studio asset group.

Upload one or more asset files and create a new upstream asset group. After creation succeeds, this project stores the ownership relation between the current user and the upstream groupId. Later list, append, update, and delete operations depend on that local ownership relation for permission checks. This endpoint requires an available channel with video_studio_asset_base_url configured under the current token group.

POST
/v1/api/video-studio/assets/ecloud/upload-and-save
curl -X POST "https://api.routescope.ai/v1/api/video-studio/assets/ecloud/upload-and-save" \  -F files="[\n  \"string\"\n]"
{
  "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

AuthorizationBearer <token>

Use this project's gateway token: Authorization: Bearer <API_TOKEN>. This is not the upstream asset-library API key.

In: header

Request Body

multipart/form-data

files*array<file>

Asset file array, up to 20 files. Supports jpg, jpeg, png, mp4, mov, mp3, and wav.

Itemsitems <= 20
displayName?string

Asset group display name.

groupName?string

Asset group name, usually the same as displayName.

Response Body

application/json

application/json

application/json

Last updated on