文档中心

数据智能体

文档管理

新增文档版本

调用本接口将已上传的单个文件作为目标文档的新版本提交；target_doc_id 必填。

接口说明

接口名称：create_document_entry_version_document_version_create_post
接口地址：/document/version/create
请求方式：POST

请求参数

参数名	类型	是否必传	描述
kb_ids	Array	是	知识库ID列表
file_ids	Array	否	文件标识符
file_parse_type_overrides	Array	否	文件解析类型覆盖；当未显式提供 file_ids/object_keys 时，可从 match.file_ids/source_keys 推断导入范围。详情请参见下文 file_parse_type_overrides 表
embd_id	String	否	嵌入模型标识符
source_type	String	否	解析模型来源类型
chunk_settings	Object	否	统一切片配置。详情请参见chunk_settings
quality_settings	Object	否	统一质量检测配置。详情请参见 quality_settings
parser_config	AnyOf	否	解析配置，支持 LarkParserConfig / ReportifyConfig / SophonParserConfig 三种结构。详情请参见config。
skip_duplicate	Boolean	否	是否过跳重复文件
feishu_config	Array	否	飞书配置。详情请参见feishu_config
dingtalk_config	Array	否	钉钉配置。详情请参见feishu_config
wecom_config	Array	否	企微文档配置。详情请参见下文 wecom_config 表
schedule_config	Object	否	调度配置。详情请参见schedule_config
object_keys	Array	否	对象存储键
template_id	String	否	解析模板标识符，将覆盖 parser_config
apply_type	Number	否	应用类型
access_key	String	否	访问密钥（即将废弃）
secret_key	String	否	秘密密钥（即将废弃）
oss_config	Object	否	OSS 配置。详情请参见下文 oss_config 表
media_platform_config	Object	否	媒体平台配置。详情请参见下文 media_platform_config 表
public_url_config	Object	是	公开链接导入配置。详情请参见下文 public_url_config 表
datasource_code	String	否	数据源代码
folder_id	Number	否	导入目标文件夹ID
target_doc_id	Number	否	版本导入的目标文档ID
version_policy	String	否	新建文档时持久化的版本模式，默认新增版本；target_doc_id 存在时不覆盖目标文档配置 ADD_VERSION OVERWRITE_VERSION
version_rule_type	String	否	新建文档时持久化的版本号规则；target_doc_id 或 source_unique_id 命中已有文档时不覆盖目标文档配置 CUSTOM DAY WEEK MONTH QUARTER YEAR
version_rule_config	Object	否	新建文档的版本号规则配置；支持 prefix 和 timezone，默认 V 与 Asia/Shanghai
version_date	Number	否	业务版本日期，Unix 毫秒时间戳；版本导入未传时使用当前时间
source_unique_id	String	否	Prep/API 来源文档唯一标识；知识库内命中已有文档时自动按其版本策略导入
source_identity_type	String	否	上游唯一标识所属来源类型；未传时使用 datasource_code
datasource_meta_id	Number	否	数据源元数据ID
data_connection_id	Number	否	数据连接ID
name	String	否	文档名称
rds_config	Object	否	RDS 配置
vecdp_config	Object	否	VecDP 配置
labels	Array<Array	否	文档标签列表，外层列表对应多个文档，内层列表对应单个文档的标签。详情请参见下文 labels 表
label_ids	Array	否	批量设置文档标签（供前端使用）。详情请参见下文 label_ids 表
extras	Array	否	额外数据
extra	Object	否	版本组额外参数，用于向Sophon传递其他参数
ocr_model	String	否	已废弃。请使用 switch_config: switch_doc_parser_vlm_ocr来控制ocr后端
prompt_locale	String	否	透传给 Sophon VLM 解析的提示词语言环境，例如 zh-CN 或 en-US
spell_check	Boolean	否	是否启用拼写检查
completeness_check	Boolean	否	已废弃：请使用 quality_settings.*.completeness_check
sensitive_word_check	Boolean	否	已废弃：请使用 quality_settings.*.sensitive_word_check
duplicate_doc_check	Boolean	否	已废弃：请使用 quality_settings.*.duplicate_doc_check
video_parser_config	Object	否	视频解析配置。详情请参见video_parser_config

file_parse_type_overrides

参数名	类型	是否必传	描述
match	Object	是	切片配置匹配条件。详情请参见下文 match 表
parse_type	String	是	文件解析类型 text doc other pdf ppt image table

参数名

类型

是否必传

描述

match

Object

是

切片配置匹配条件。详情请参见下文 match 表

parse_type

String

是

文件解析类型

text
doc
other
pdf
ppt
image
table

match

参数名	类型	是否必传	描述
file_id	Number	否	本地文件 ID
file_ids	Array	否	本地文件 ID 列表
source_key	String	否	对象存储源文件 key
source_keys	Array	否	对象存储源文件 key 列表

wecom_config

参数名	类型	是否必传	描述
doc_url	String	是	企微文档 URL
doc_token	String	否	文档 token（仅展示值）
name	String	否	文档名称（仅展示值）
doc_type	String	否	文档类型（仅展示值）
type	Number	否	企微文档类型
endpoint_fingerprint	String	否	MCP endpoint 指纹（仅展示值）

oss_config

参数名	类型	是否必传	描述
access_key	String	否	访问密钥
secret_key	String	否	密钥
region	String	否	地域
bucket	String	否	桶名称
directory	Array	否	目录列表
endpoint	String	否	访问地址
type	String	否	类型

media_platform_config

参数名	类型	是否必传	描述
access_key	String	否	访问密钥
secret_key	String	否	密钥

public_url_config

参数名	类型	是否必传	描述
urls	Array	是	公开链接列表（元素为 {url, file_id} 绑定结构，也兼容纯 URL 字符串），URL 必须以 http:// 或 https:// 开头。详情请参见下文 urls 表
recursive_links	Boolean	否	是否递归抓取一层内链（仅 HTML 生效）
auto_update	Boolean	否	是否开启自动更新
schedule_config	Object	否	调度配置
directory	String	否	目录标识（UUID），用于复用校验结果或定位同一批下

urls

参数名	类型	是否必传	描述
url	String	是	公开链接，必须以 http:// 或 https:// 开头
file_id	Number	否	绑定的已上传文件ID（/public_url/html mode=upload 返

labels

参数名	类型	是否必传	描述
label_name	String	是	标签名称
label_type	String	是	文档标签类型 multiple_value_text single_value_text
label_value	Array	是	标签值列表

参数名

类型

是否必传

描述

label_name

String

是

标签名称

label_type

String

是

文档标签类型

multiple_value_text
single_value_text

label_value

Array

是

标签值列表

label_ids

参数名	类型	是否必传	描述
label_id	Number	是	标签ID
label_value_ids	Array	否	标签值ID列表

响应参数

参数名	类型	是否必传	描述
code	Number	是	响应码：0=成功，非0=失败
msg	String	否	Code非0时，返回错误信息
message	String	否	错误信息
data	Array	否	数据，详情请参见下文 data 表

data

参数名	类型	是否必传	描述
id	Number	否	标识符
file_id	Number	否	文件ID
document_id	Number	否	文档ID
running_state	String	否	运行状态
version_id	Number	否	版本记录ID
run_required	Boolean	否	是否需要调用文档运行接口
document_name	String	否	文档名称
duplicate_docs_names	Array	否	重复文档名称
is_all_duplicate	Boolean	否	是否全部重复

最近更新时间：2026.09.17 19:26:40

这个页面对您有帮助吗？

有用

无用

数据智能体

file_parse_type_overrides #

match #

wecom_config #

oss_config #

media_platform_config #

public_url_config #

urls #

labels #

label_ids #

data #

file_parse_type_overrides

match

wecom_config

oss_config

media_platform_config

public_url_config

urls

labels

label_ids

data