更新文件类别
curl --request POST \
--url https://docflow.textin.com/api/app-api/sip/platform/v2/category/update \
--header 'Content-Type: application/json' \
--header 'x-ti-app-id: <api-key>' \
--header 'x-ti-secret-code: <api-key>' \
--data '
{
"workspace_id": "1234567890",
"category_id": "1234567890",
"name": "发票",
"category_prompt": "增值税发票,包含发票代码、发票号码等字段",
"extract_model": "Acgpt",
"with_detail": true
}
'import requests
url = "https://docflow.textin.com/api/app-api/sip/platform/v2/category/update"
payload = {
"workspace_id": "1234567890",
"category_id": "1234567890",
"name": "发票",
"category_prompt": "增值税发票,包含发票代码、发票号码等字段",
"extract_model": "Acgpt",
"with_detail": True
}
headers = {
"x-ti-app-id": "<api-key>",
"x-ti-secret-code": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-ti-app-id': '<api-key>',
'x-ti-secret-code': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
workspace_id: '1234567890',
category_id: '1234567890',
name: '发票',
category_prompt: '增值税发票,包含发票代码、发票号码等字段',
extract_model: 'Acgpt',
with_detail: true
})
};
fetch('https://docflow.textin.com/api/app-api/sip/platform/v2/category/update', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://docflow.textin.com/api/app-api/sip/platform/v2/category/update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'workspace_id' => '1234567890',
'category_id' => '1234567890',
'name' => '发票',
'category_prompt' => '增值税发票,包含发票代码、发票号码等字段',
'extract_model' => 'Acgpt',
'with_detail' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-ti-app-id: <api-key>",
"x-ti-secret-code: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://docflow.textin.com/api/app-api/sip/platform/v2/category/update"
payload := strings.NewReader("{\n \"workspace_id\": \"1234567890\",\n \"category_id\": \"1234567890\",\n \"name\": \"发票\",\n \"category_prompt\": \"增值税发票,包含发票代码、发票号码等字段\",\n \"extract_model\": \"Acgpt\",\n \"with_detail\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-ti-app-id", "<api-key>")
req.Header.Add("x-ti-secret-code", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://docflow.textin.com/api/app-api/sip/platform/v2/category/update")
.header("x-ti-app-id", "<api-key>")
.header("x-ti-secret-code", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"workspace_id\": \"1234567890\",\n \"category_id\": \"1234567890\",\n \"name\": \"发票\",\n \"category_prompt\": \"增值税发票,包含发票代码、发票号码等字段\",\n \"extract_model\": \"Acgpt\",\n \"with_detail\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://docflow.textin.com/api/app-api/sip/platform/v2/category/update")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-ti-app-id"] = '<api-key>'
request["x-ti-secret-code"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"workspace_id\": \"1234567890\",\n \"category_id\": \"1234567890\",\n \"name\": \"发票\",\n \"category_prompt\": \"增值税发票,包含发票代码、发票号码等字段\",\n \"extract_model\": \"Acgpt\",\n \"with_detail\": true\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"msg": "<string>",
"result": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"category_prompt": "<string>",
"extract_model": "<string>",
"enabled": 123
}
}文件类别
更新文件类别
更新指定文件类别的信息。
注意:设置 extract_model 时将级联覆盖该分类下所有字段和表格的抽取模型。
POST
/
api
/
app-api
/
sip
/
platform
/
v2
/
category
/
update
更新文件类别
curl --request POST \
--url https://docflow.textin.com/api/app-api/sip/platform/v2/category/update \
--header 'Content-Type: application/json' \
--header 'x-ti-app-id: <api-key>' \
--header 'x-ti-secret-code: <api-key>' \
--data '
{
"workspace_id": "1234567890",
"category_id": "1234567890",
"name": "发票",
"category_prompt": "增值税发票,包含发票代码、发票号码等字段",
"extract_model": "Acgpt",
"with_detail": true
}
'import requests
url = "https://docflow.textin.com/api/app-api/sip/platform/v2/category/update"
payload = {
"workspace_id": "1234567890",
"category_id": "1234567890",
"name": "发票",
"category_prompt": "增值税发票,包含发票代码、发票号码等字段",
"extract_model": "Acgpt",
"with_detail": True
}
headers = {
"x-ti-app-id": "<api-key>",
"x-ti-secret-code": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-ti-app-id': '<api-key>',
'x-ti-secret-code': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
workspace_id: '1234567890',
category_id: '1234567890',
name: '发票',
category_prompt: '增值税发票,包含发票代码、发票号码等字段',
extract_model: 'Acgpt',
with_detail: true
})
};
fetch('https://docflow.textin.com/api/app-api/sip/platform/v2/category/update', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://docflow.textin.com/api/app-api/sip/platform/v2/category/update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'workspace_id' => '1234567890',
'category_id' => '1234567890',
'name' => '发票',
'category_prompt' => '增值税发票,包含发票代码、发票号码等字段',
'extract_model' => 'Acgpt',
'with_detail' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-ti-app-id: <api-key>",
"x-ti-secret-code: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://docflow.textin.com/api/app-api/sip/platform/v2/category/update"
payload := strings.NewReader("{\n \"workspace_id\": \"1234567890\",\n \"category_id\": \"1234567890\",\n \"name\": \"发票\",\n \"category_prompt\": \"增值税发票,包含发票代码、发票号码等字段\",\n \"extract_model\": \"Acgpt\",\n \"with_detail\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-ti-app-id", "<api-key>")
req.Header.Add("x-ti-secret-code", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://docflow.textin.com/api/app-api/sip/platform/v2/category/update")
.header("x-ti-app-id", "<api-key>")
.header("x-ti-secret-code", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"workspace_id\": \"1234567890\",\n \"category_id\": \"1234567890\",\n \"name\": \"发票\",\n \"category_prompt\": \"增值税发票,包含发票代码、发票号码等字段\",\n \"extract_model\": \"Acgpt\",\n \"with_detail\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://docflow.textin.com/api/app-api/sip/platform/v2/category/update")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-ti-app-id"] = '<api-key>'
request["x-ti-secret-code"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"workspace_id\": \"1234567890\",\n \"category_id\": \"1234567890\",\n \"name\": \"发票\",\n \"category_prompt\": \"增值税发票,包含发票代码、发票号码等字段\",\n \"extract_model\": \"Acgpt\",\n \"with_detail\": true\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"msg": "<string>",
"result": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"category_prompt": "<string>",
"extract_model": "<string>",
"enabled": 123
}
}请求体
application/json
空间ID
示例:
"1234567890"
文件类别ID
示例:
"1234567890"
文件类别名称
Maximum string length:
50示例:
"发票"
用于分类的提示词
Maximum string length:
150示例:
"增值税发票,包含发票代码、发票号码等字段"
启用状态
- 0: 禁用
- 1: 启用
- 2: 草稿
可用选项:
0, 1, 2 抽取模型,设置后级联覆盖所有字段和表格
- Auto: 智能匹配抽取模型
- Acgpt: 速度快,抽取结果稳定
- Acgpt-VL: 多模态,适用简单抽取(≤10 页)
- DF-M1: 适用复杂文档理解
可用选项:
Auto, Acgpt, Acgpt-VL, DF-M1 示例:
"Acgpt"
是否返回完整详情。传 true 时响应返回分类自身信息(不含子层级字段/表格)。 不传或为 false 时仅返回 code/msg。
⌘I

