Creates an artifact upload credential.
Operation description
Obtains the link required to upload content. This operation is applicable to large files.
Try it now
Test
RAM authorization
Request syntax
POST /digitalEmployee/{name}/artifacts/uploadToken HTTP/1.1Path Parameters
|
Parameter |
Type |
Required |
Description |
Example |
| name |
string |
Yes |
The name of the digital human. |
sample-agent |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| artifactPath |
string |
No |
The artifact upload directory, relative to the digital human artifact root directory. The value can only be empty or a directory under upload/. If not specified, upload/{YYYY-MM-DD}/ is used by default. |
upload/2026-05-25/ |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| requestId |
string |
The request ID. |
0A1B2C3D-4E5F-6789-ABCD-1234567890AB |
| artifactPath |
string |
The normalized logical upload directory on the server side, relative to the digital human artifact root directory. |
upload/2026-05-25/ |
| host |
string |
The OSS form upload URL. |
https://example-bucket.oss-cn-shanghai.aliyuncs.com |
| dir |
string |
The allowed OSS object prefix for uploads. |
agents/123/sample-agent/home/starops/upload/2026-05-25/ |
| accessId |
string |
The AccessKey ID used for OSS uploads. |
LTAI****** |
| policy |
string |
The Base64-encoded OSS Post Policy. |
eyJleHBpcmF0aW9uIjoiMjAyNi0wNS0yMVQwODowMDowMFoifQ== |
| signature |
string |
The OSS Post Policy signature. |
abc123signature |
| successActionStatus |
string |
The status code returned upon a successful OSS upload. |
200 |
| expire |
integer |
The expiration time of the upload credential. The value is a UNIX timestamp in seconds. |
1770000000 |
| maxSize |
integer |
The maximum size of a single file upload, in bytes. |
104857600 |
Examples
Success response
JSON format
{
"requestId": "0A1B2C3D-4E5F-6789-ABCD-1234567890AB",
"artifactPath": "upload/2026-05-25/",
"host": "https://example-bucket.oss-cn-shanghai.aliyuncs.com",
"dir": "agents/123/sample-agent/home/starops/upload/2026-05-25/",
"accessId": "LTAI******",
"policy": "eyJleHBpcmF0aW9uIjoiMjAyNi0wNS0yMVQwODowMDowMFoifQ==",
"signature": "abc123signature",
"successActionStatus": "200",
"expire": 1770000000,
"maxSize": 104857600
}Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.