Associate Digital Human Organization
Updated: 2026-07-13 11:57:31
Interface Description
1、将数字人和组织架构关联，单次请求最多100个数字人，对应子账号
2、接口支持https协议
Interface URL
http://api.polyv.net/live/v4/ai/digital-human/set-organizations
Request Method
POST
Interface Constraints
- The interface supports both HTTP and HTTPS. HTTPS is recommended to ensure interface security. Interface calls have frequency limits. See details
Request Parameter Description
| Parameter | Required | Type | Description |
|---|---|---|---|
| appId | true | String | Account appId [See Get Secret Key] |
| timestamp | true | Long | Current 13-digit millisecond timestamp, valid within 3 minutes |
| sign | true | String | Signature, a 32-character uppercase MD5 value. The appSecret key used to generate the signature is critical for communication data security. It must not be stored or used directly on the client side. All APIs must be called through the customer's own server to relay requests to the POLYV server for response data. [See Signature Generation Rules] |
Request Body Parameter Description
| Parameter | Required | Type | Description |
|---|---|---|---|
| aiDigitalHumanId | true | Integer | Digital human ID |
| organizationIds | true | List<Integer> | Organization structure IDs, empty to clear association settings |
| includeChildren | false | Boolean | Whether to include child nodes, true-include, false-exclude (default) |
Example
http://api.polyv.net/live/v4/ai/digital-human/set-organizations?appId=frlr1zacn3&sign=0F412B15C2DC032517E1D29BD4452C43×tamp=1630996829815
Request body JSON parameters:
[
{"aiDigitalHumanId":1, "organizationIds":[2,3,5], "includeChildren":false},
{"aiDigitalHumanId":2, "organizationIds":[2,3,9], "includeChildren":true}
]
Response Parameter Description
| Parameter | Type | Description |
|---|---|---|
| code | Integer | Response status code, 200 for success, non-200 for failure |
| status | String | Response result, determined by business, success returns success, failure returns error |
| success | Boolean | Response result, determined by business, success returns true, failure returns false |
| data | Object | Channel details on successful response [See data field description] |
| error | Object | Error information when status code is non-200 [See Error field description] |
| requestId | String | Request ID, a unique UUID generated for each request, only for troubleshooting and debugging, should not be tied to business |
Error Parameter Description
| Parameter | Type | Description |
|---|---|---|
| code | Integer | Error code, used to identify the specific error reason |
| desc | String | Error description, corresponds to error.code |
Data Parameter Description
| Parameter | Type | Description |
|---|
Response Example
Success Example
{
"code": 200,
"status": "success",
"requestId": "dc7ae621ef8e4f4a8e4976833f1dbbd4.66.16309975070362179",
"data": {},
"success": true
}
Error Example
{
"code": 400,
"status": "error",
"requestId": "d310b70bc329403f87f77f9203d50f89.128.16360828899123425",
"success": false
}
