Skip to main content
POST
/
v1
/
knowledge
/
{knowledge_id}
/
files
Upload Knowledge Files
curl --request POST \
  --url https://api-spectra.duplik.cn/v1/knowledge/{knowledge_id}/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source_type": "file_storage",
  "files": [
    {
      "url": "<string>",
      "original_metadata": {
        "file_name": "<string>",
        "type": "<string>",
        "byte_size": 123,
        "source_type": "<string>",
        "location": "<string>",
        "source_location": "<string>",
        "path": "<string>"
      },
      "document_metadata": {}
    }
  ],
  "created_at": 123,
  "updated_at": 123,
  "folder_id": "<string>",
  "process_document": true,
  "document_setting": {
    "overall_summarize_enabled": true,
    "smart_indexing_mode": 0,
    "smart_indexing_enabled": true,
    "split_media_enabled": true,
    "pdf_parsing_mode": 2,
    "pdf_parsing_element_types": [
      1,
      2
    ],
    "read_pdf_pages": "<string>",
    "audio_parsing_mode": 123,
    "audio_chunk_mode": 1
  }
}
'
[
  {
    "org_id": "<string>",
    "user_id": "<string>",
    "dataset_id": "<string>",
    "file_id": "<string>",
    "document_id": "<string>",
    "created_at": 123,
    "updated_at": 123,
    "overall_summarize_enabled": true,
    "smart_indexing_mode": 0,
    "smart_indexing_enabled": true,
    "split_media_enabled": true,
    "pdf_parsing_mode": 2,
    "pdf_parsing_element_types": [
      1,
      2
    ],
    "read_pdf_pages": "<string>",
    "audio_parsing_mode": 123,
    "audio_chunk_mode": 1,
    "name": "<string>",
    "document_type": 1,
    "next_step": true,
    "llm": {},
    "metadata_info": {},
    "task_priority": 123,
    "description": "",
    "summary": "",
    "step_status": 100,
    "status": 1,
    "process_status": 100,
    "version": 2,
    "splitter_type": 1,
    "splitter": {},
    "sections": [],
    "content_text": "<string>",
    "trim_text": true
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
knowledge_id
string
required

Query Parameters

​
user_id
string

用户ID

Body

application/json
​
source_type
enum<string>
required

file source, such as FILE_STORAGE, WEB

Available options:
file_storage,
web
​
files
FileUploadBase · object[]
required

file list

Maximum array length: 100
​
created_at
integer
​
updated_at
integer
​
folder_id
string | null

folder id

​
process_document
boolean | null
default:true

whether process document

​
document_setting
DocumentConfig · object

process document with setting

Response

Successful Response

​
org_id
string
required
Maximum string length: 20
​
user_id
string
required
Maximum string length: 20
​
dataset_id
string
required
​
file_id
string
required
​
document_id
string
required
​
created_at
integer
​
updated_at
integer
​
overall_summarize_enabled
boolean | null
default:true

generate overall summary, 1: enabled, 2: disabled

​
smart_indexing_mode
integer | null
default:0

smart indexing mode, 0: disabled, 1: standard, 2: advanced

​
smart_indexing_enabled
boolean | null
default:true

generate intelligent indexing, 1: enabled, 2: disabled

​
split_media_enabled
boolean | null
default:true

generate media segments, 1: enabled, 2: disabled

​
pdf_parsing_mode
integer | null
default:2

pdf parsing mode, 1: page, 2: section

​
pdf_parsing_element_types
integer[] | null

pdf parsing element list, eg: [1, 2]. 1: table, 2: image, 3: formula

​
read_pdf_pages
string | null

read pdf pages, Example: '1,3,4' or '1,4-end' or 'all'

​
audio_parsing_mode
integer | null

audio parsing mode, 1: transcript, 2: speaker diarization

​
audio_chunk_mode
integer | null
default:1
​
name
string | null
Maximum string length: 256
​
document_type
integer | null
default:1
​
next_step
boolean | null
default:true

next step

​
llm
Llm · object
​
metadata_info
Metadata Info · object
​
task_priority
integer | null

task priority

​
description
string | null
default:""
Maximum string length: 512
​
summary
string | null
default:""
​
step_status
integer | null
default:100
​
status
integer | null
default:1
​
process_status
integer | null
default:100
​
version
integer | null
default:2
​
splitter_type
integer | null
default:1
​
splitter
Splitter · object
​
sections
Sections · object[]
​
content_text
string | null
​
trim_text
boolean | null
default:true