从 OSS 批量导入 - 千问AI平台

从已授权的阿里云 OSS Bucket 批量导入文件到数据中心

POST

/api/v1/connector/dash/addFilesFromAuthorizedOss

cURL

curl -X POST "https://dashscope.aliyuncs.com/api/v1/connector/dash/addFilesFromAuthorizedOss" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "categoryId": "cate_abc123",
    "categoryType": "UNSTRUCTURED",
    "ossBucket": "my-docs-bucket",
    "ossRegionId": "cn-beijing",
    "fileDetails": [
      {"fileName": "product-guide.pdf", "ossKey": "docs/product-guide.pdf"},
      {"fileName": "faq.docx", "ossKey": "docs/faq.docx"}
    ]
  }'

{
  "code": "Success",
  "status_code": 200,
  "data": {},
  "requestId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

使用前需要通过**服务关联角色（SLR）**授权千问AI平台访问您的 OSS Bucket。请在阿里云 RAM 控制台确认已创建 AliyunServiceRoleForBailian 服务关联角色，否则调用将返回权限错误。

鉴权

string

header

必填

DashScope API Key，在控制台 API Key 页面获取。

请求体

application/json

string

必填

类目 ID，通过 listCategory 获取。

enum<string>

默认值"UNSTRUCTURED"

必填

类目类型。

可选值：UNSTRUCTURED,SESSION_FILE

string

必填

OSS Bucket 名称。

string

必填

OSS 所在地域，如 cn-beijing。

示例:cn-beijing

object[]

必填

要导入的文件详情列表。

取值范围：items: 1–10

显示子属性

string

必填

导入后的文件名称。

取值范围：length: 1–500

string

必填

OSS 对象 Key（文件在 Bucket 中的路径）。

取值范围：length: 1–256

enum<string>

默认值"AUTO_SELECT"

解析器类型，取值见注册文件 — 解析器选择。UNSTRUCTURED 按类目解析设置；SESSION_FILE 不支持更改

可选值：AUTO_SELECT,DOCMIND,DOCMIND_DIGITAL,DOCMIND_LLM_VERSION,DASH_QWEN_VL_PARSER,DOCMIND_LLM_VERSION_MEDIA

object

解析配置，仅 parser 为 DASH_QWEN_VL_PARSER 时必填，其他解析方式无需传入。

显示子属性

enum<string>

视觉解析模型。

可选值：qwen3-vl-plus

string

解析提示词，长度 1~1500 字符。

取值范围：length: 1–1500

string[]

文件关联的标签列表，最多 10 个。

取值范围：items <= 10

boolean

默认值false

当 ossKey 对应的文件已存在时是否覆盖，默认 false。

响应

200-application/json

string

响应码，成功时为 Success。

string

错误或提示信息，成功时为空字符串。

string

请求唯一标识，排查问题时请提供此 ID。

object

导入结果。

显示子属性

string[]

导入成功的文件 ID 列表。

integer

业务状态码。成功为 200，参数错误等失败场景为 400。注意失败时 HTTP 状态码仍为 200，需根据本字段与 code 判断结果。