Skip to main content
POST
创建文件类别

授权

x-ti-app-id
string
header
必填
x-ti-secret-code
string
header
必填

请求体

multipart/form-data
workspace_id
string
必填

空间ID

示例:

"1234567890"

name
string
必填

文件类别名称

Maximum string length: 50
示例:

"发票"

extract_model
enum<string>
必填

抽取模型

  • Auto: 智能匹配抽取模型
  • Acgpt: 速度快,抽取结果稳定
  • Acgpt-VL: 多模态,适用简单抽取(≤10 页)
  • DF-M1: 适用复杂文档理解
可用选项:
Auto,
Acgpt,
Acgpt-VL,
DF-M1
示例:

"Acgpt"

sample_files
file[]
必填

样本文件列表,至少上传一个样本文件,一个类别最多有20个样本文件

Required array length: 1 - 10 elements
fields
object[]
必填

字段配置列表,至少配置一个字段

Minimum array length: 1
category_prompt
string

用于分类的提示词

Maximum string length: 150
示例:

"增值税发票,包含发票代码、发票号码等字段"

description
string

文件类别描述

tables
object[]

选填,表格配置列表(一站式创建),支持内嵌 fields

with_detail
boolean

是否返回完整详情。传 true 时响应包含完整的分类信息(含字段、表格、样本)。 不传或为 false 时仅返回 category_id。

响应

200 - application/json

成功创建文件类别

code
integer
必填

状态码

示例:

200

msg
string
必填

状态描述

result
object