Resource Groups

The Resource Management API allows users to manage assets that can be referenced by models, making it easier to reuse assets across requests. Currently, this feature is only available for the Volcengine Seedance series of models.

Note: Some API Key resource groups do not support Resource Management. See Seedance for details.

Note: The API Key used for asset management and video generation must belong to the same resource group. Therefore, when creating an API Key, make sure to select a specific resource group if you intend to use Resource Management.

Auth: Authorization: Bearer <api-key>

Enums: status: 1 Available / 2 Processing / 3 Failed / 4 Deleted

Create Resource Group

POST /api/model-resources/groups

Field	Type	Required	Description
name	string	Yes	Group name
description	string	No	Group description

curl --location 'https://neolink.com/api/api/model-resources/groups' \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "User Group 1",
    "description": "This is a note"
  }'

Response:

{
  "success": true,
  "message": "",
  "data": {
    "id": 8,
    "name": "User Group 1",
    "description": "This is a note",
    "busi_type": 1,
    "created_at": 1779330365,
    "updated_at": 1779330365,
    "deleted_at": null
  }
}

Query Resource Group List

GET /api/model-resources/groups

Field	Type	Required	Description
p	int	No	Page number, default 1
page_size	int	No	Items per page
keyword	string	No	Search by name or description

curl --location 'https://neolink.com/api/api/model-resources/groups?p=1&page_size=20' \
  --header 'Authorization: Bearer <api-key>'

Response:

{
  "success": true,
  "message": "",
  "data": {
    "page": 1,
    "page_size": 20,
    "total": 1,
    "items": [
      {
        "id": 8,
        "name": "User Group 1",
        "description": "This is a note",
        "busi_type": 1,
        "created_at": 1779330365,
        "updated_at": 1779330365,
        "deleted_at": null
      }
    ]
  }
}

Query Resource Group Details

GET /api/model-resources/groups/{id}

curl --location 'https://neolink.com/api/api/model-resources/groups/8' \
  --header 'Authorization: Bearer <api-key>'

Response fields are the same as creating a resource group.

Update Resource Group

PATCH /api/model-resources/groups/{id}
PUT /api/model-resources/groups/{id}

Field	Type	Required	Description
name	string	No	New group name
description	string	No	New description

curl --location --request PATCH 'https://neolink.com/api/api/model-resources/groups/8' \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "User Group 1 - Updated",
    "description": "New note"
  }'