调用方将文件直接上传到响应指定的 Bucket/ObjectKey，再将对象 URL 作为 OssFileUrl 创建解析任务。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
是 |
地域 ID，如 cn-beijing |
cn-beijing |
| AgentName |
string |
否 |
发起调用的 Agent/客户端来源，如 codex / cursor / openapi；最长 32 字符，仅用于统计，不参与鉴权、限流、配额或计费 |
codex |
| FileFormat |
string |
否 |
待上传文件格式 |
|
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID |
A30D0930-xxxx-xxxx-xxxx-C2C661CC8B58 |
| Success |
boolean |
是否成功 |
true |
| HttpStatusCode |
integer |
业务语义状态码 |
200 |
| ErrorCode |
string |
错误码 |
InvalidParameter |
| ErrorMessage |
string |
错误描述 |
The parameter [Query] is not valid. |
| AccessKeyId |
string |
OSS PostObject 使用的临时 AccessKey ID |
STS.NV5xxx |
| SecurityToken |
string |
STS 临时安全令牌 |
CAISxxx |
| Bucket |
string |
目标 OSS Bucket |
dts-ai-upload-cn-beijing7500163e0eae09 |
| EncodedPolicy |
string |
Base64 编码的 PostObject Policy，包含 ObjectKey 和文件大小限制 |
eyJleHBpcmF0aW9uIjo... |
| Endpoint |
string |
OSS Endpoint |
oss-cn-beijing.aliyuncs.com |
| ObjectKey |
string |
必须原样用于上传的对象 Key |
0a1b_123456_0123456789abcdef0123456789abcdef |
| Signature |
string |
Policy 签名 |
masked-signature |
示例
正常返回示例
JSON格式
{
"RequestId": "A30D0930-xxxx-xxxx-xxxx-C2C661CC8B58",
"Success": true,
"HttpStatusCode": 200,
"ErrorCode": "InvalidParameter",
"ErrorMessage": "The parameter [Query] is not valid.",
"AccessKeyId": "STS.NV5xxx",
"SecurityToken": "CAISxxx",
"Bucket": "dts-ai-upload-cn-beijing7500163e0eae09",
"EncodedPolicy": "eyJleHBpcmF0aW9uIjo...",
"Endpoint": "oss-cn-beijing.aliyuncs.com",
"ObjectKey": "0a1b_123456_0123456789abcdef0123456789abcdef",
"Signature": "masked-signature"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。