/** * ChatCompletions请求参数结构体 */ export interface ChatCompletionsRequest { /** * 模型名称 */ Model: string; /** * 聊天上下文信息。 说明: 1. 长度最多为 40,按对话时间从旧到新在数组中排列。 2. Message.Role 可选值:system、user、assistant。 其中,system 角色可选,如存在则必须位于列表的最开始。user 和 assistant 需交替出现,以 user 提问开始,user 提问结束,Content 不能为空。Role 的顺序示例:[system(可选) user assistant user assistant user ...]。 */ Messages: Array; /** * 是否流式输出 */ Stream?: boolean; /** * 控制生成的随机性,较高的值会产生更多样化的输出。 */ Temperature?: number; /** * 模型最大输出长度(单位 token),不包含思维链内容。 默认为4096,取值范围:各个模型不同,参考各个模型最大输出长度(示例:4k,即4096)。 输出 token 的总长度受模型的上下文长度限制。 */ MaxTokens?: number; /** * 是否启用联网搜索 */ EnableSearch?: boolean; /** * 思维链开关,本参数仅在deepseek v3.1时生效 */ Thinking?: Thinking; } /** * CreateSplitDocumentFlow请求参数结构体 */ export interface CreateSplitDocumentFlowRequest { /** * 文件类型。**支持的文件类型:**- `WPS`、`PDF`、`DOC`、`DOCX`、`XLS`、`XLSX`、`PPT`、`PPTX`、`MD`、`TXT`、`PNG`、`JPG`、`JPEG`、`CSV`、`HTML`、`EPUB`**支持的文件大小:** - `PDF` 最大300M - `WPS`、`DOCX`、`DOC`、`PPT`、`PPTX` 最大 200M - `TXT`、`MD` 最大10M - 其他 最大20M */ FileType: string; /** * 文件的 URL 地址。 文件存储于腾讯云的 URL 可保障更高的下载速度和稳定性,建议文件存储于腾讯云。 非腾讯云存储的 URL 速度和稳定性可能受一定影响。 参考:[腾讯云COS文档](https://cloud.tencent.com/document/product/436/7749) */ FileUrl: string; /** * 文件名,可选。 **需带文件类型后缀**,当文件名无法从传入的`FileUrl`获取时需要通过该字段来明确。 */ FileName?: string; /** * 文件的 Base64 值。 支持的文件大小:所下载文件经Base64编码后不超过 8M。文件下载时间不超过 3 秒。 支持的图片像素:单边介于20-10000px之间。 文件的 FileUrl、FileBase64 必须提供一个,如果都提供,只使用 FileUrl。 * @deprecated */ FileBase64?: string; /** * 文档的起始页码。 当传入文件是PDF、PDF、PPT、PPTX、DOC类型时,用来指定识别的起始页码,识别的页码包含当前值。 */ FileStartPageNumber?: number; /** * 文档的结束页码。 当传入文件是PDF、PDF、PPT、PPTX、DOC类型时,用来指定识别的结束页码,识别的页码包含当前值。 */ FileEndPageNumber?: number; /** * 文档拆分任务的配置信息。 */ Config?: CreateSplitDocumentFlowConfig; } /** * 检索结果的元数据 */ export interface RetrievalRecordMetadata { /** * 结果的类型。 - `DOC`:文档 - `QA`:问答对 */ Type?: string; /** * 检索结果的来源。 - `SEMANTIC`:从语义检索中得到的结果 - `FULL_TEXT`:从全文检索中得到的结果 */ ResultSource?: string; /** * 切片在文档中的页码,仅部分文档支持 */ ChunkPageNumbers?: Array; } /** * ListQAs请求参数结构体 */ export interface ListQAsRequest { /** * 知识库ID */ KnowledgeBaseId: string; /** * 页码,默认1 */ PageNumber?: number; /** * 每页数目,最大50,默认20 */ PageSize?: number; } /** * ReconstructDocumentSSE返回参数结构体 */ export interface ReconstructDocumentSSEResponse { /** * 任务ID。本次请求的唯一标识 */ TaskId?: string; /** * 响应类型。1:返回进度信息, 2:返回解析结果 */ ResponseType?: string; /** * 进度。0~100 */ Progress?: string; /** * 进度信息。 */ ProgressMessage?: string; /** * 文档解析结果的临时下载地址。文件类型为zip压缩包,下载链接有效期30分钟。压缩包内包含*.md、*.json以及images文件夹。 */ DocumentRecognizeResultUrl?: string; /** * 文档解析失败的页码。 */ FailedPages?: Array; /** * 文档解析失败页数 */ FailPageNum?: number; /** * 文档解析成功页数 */ SuccessPageNum?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。本接口为流式响应接口,当请求成功时,RequestId 会被放在 HTTP 响应的 Header "X-TC-RequestId" 中。 */ RequestId?: string; } /** * 离线文档列表回包 */ export interface DocItem { /** * 文档id 注意:此字段可能返回 null,表示取不到有效值。 */ DocId?: string; /** * 状态, - Uploading 上传中 - Auditing 审核中 - Parsing 解析中 - ParseFailed 解析失败 - Indexing 创建索引中 - IndexFailed 创建索引失败 - Success 发布成功 - Failed 失败 注意:此字段可能返回 null,表示取不到有效值。 */ Status?: string; /** * 文件名 注意:此字段可能返回 null,表示取不到有效值。 */ FileName?: string; /** * 更新时间 注意:此字段可能返回 null,表示取不到有效值。 */ UpdateTime?: string; /** * 属性标签 注意:此字段可能返回 null,表示取不到有效值。 */ AttributeLabels?: Array; } /** * GetEmbedding请求参数结构体 */ export interface GetEmbeddingRequest { /** * 说明:选择生成向量的模型备注:可选[lke-text-embedding-v1,lke-text-embedding-v2,youtu-embedding-llm-v1] */ Model: string; /** * 说明:需要 embedding 的文本 备注:单条query最多2000个字符,总条数最多7条 */ Inputs: Array; /** * 说明:文本向量化的类型,为使得检索任务有更好的检索效果,建议区分查询文本(query)和文档文本(document)类型, 聚类、分类等对称任务可以不用特殊指定,采用系统默认值document即可。 */ TextType?: string; /** * 说明:自定义任务指令词,当且仅当TextType=query且Model为youtu-embedding-llm-v1时,生效 */ Instruction?: string; } /** * ImportQAs返回参数结构体 */ export interface ImportQAsResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * UploadDoc返回参数结构体 */ export interface UploadDocResponse { /** * 文档ID */ DocId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeDoc返回参数结构体 */ export interface DescribeDocResponse { /** * 文档ID */ DocId?: string; /** * 状态, - Uploading 上传中 - Auditing 审核中 - Parsing 解析中 - ParseFailed 解析失败 - Indexing 创建索引中 - IndexFailed 创建索引失败 - Success 发布成功 - Failed 失败 */ Status?: string; /** * 文件名 */ FileName?: string; /** * 更新时间 */ UpdateTime?: string; /** * 属性标签 */ AttributeLabels?: Array; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 属性标签引用 */ export interface AttributeLabelReferItem { /** * 属性id 注意:此字段可能返回 null,表示取不到有效值。 */ AttributeId?: string; /** * 标签id 注意:此字段可能返回 null,表示取不到有效值。 */ LabelIds?: Array; } /** * DeleteQAs请求参数结构体 */ export interface DeleteQAsRequest { /** * 知识库ID */ KnowledgeBaseId: string; /** * 问答对ID列表。支持批量删除,数量不超过100 */ QaIds: Array; } /** * ModifyQA请求参数结构体 */ export interface ModifyQARequest { /** * 知识库ID */ KnowledgeBaseId: string; /** * 问答对ID */ QaId: string; /** * 问题,最大1000个英文字符 */ Question: string; /** * 答案,最大4000个英文字符 */ Answer: string; /** * 属性标签 */ AttributeLabels?: Array; } /** * 消耗量 */ export interface Usage { /** * 文档页数 */ TotalPages?: number; /** * 输入token数 */ InputTokens?: number; /** * 输出token数 */ OutputTokens?: number; /** * 总token数 */ TotalTokens?: number; } /** * GetReconstructDocumentResult请求参数结构体 */ export interface GetReconstructDocumentResultRequest { /** * 说明:解析任务ID 备注:仅支持单个任务ID */ TaskId: string; } /** * ListQAs返回参数结构体 */ export interface ListQAsResponse { /** * 问答对总数量 */ TotalCount?: number; /** * 问答对信息 */ List?: Array; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DeleteAttributeLabels返回参数结构体 */ export interface DeleteAttributeLabelsResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 检索参数设置 */ export interface RetrievalSetting { /** * 检索的类型,不填该参数则检索全部。 - `DOC`:文档 - `QA`:QA 仅RetrieveKnowledge接口支持该参数 */ Type?: string; /** * 返回个数 */ TopK?: number; /** * 分数过滤 */ ScoreThreshold?: number; } /** * CancelTask请求参数结构体 */ export interface CancelTaskRequest { /** * 取消任务的任务ID */ TaskId: string; } /** * CreateAttributeLabel返回参数结构体 */ export interface CreateAttributeLabelResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * RetrieveKnowledge返回参数结构体 */ export interface RetrieveKnowledgeResponse { /** * 检索结果 */ Records?: Array; /** * 检索结果数量 */ TotalCount?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateSplitDocumentFlow返回参数结构体 */ export interface CreateSplitDocumentFlowResponse { /** * 拆分任务唯一ID。 30天内可以通过`GetSplitDocumentResult`接口查询TaskId对应的拆分结果。 */ TaskId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 分段配置 */ export interface SegmentationConfig { /** * 最大分片长度 */ MaxChunkSize?: number; } /** * CreateQA返回参数结构体 */ export interface CreateQAResponse { /** * 问答对ID */ QaId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyAttributeLabel请求参数结构体 */ export interface ModifyAttributeLabelRequest { /** * 说明:知识库ID 备注:通过创建知识库接口(DeleteKnowledgeBase)得到知识库ID(KnowledgeBaseId) */ KnowledgeBaseId: string; /** * 说明:属性ID 备注:通过CreateAttributeLabel接口创建属性时会生成AttributeId,通过ListAttributeLabels接口可查询得到AttributeId、AttributeKey、AttributeName以及LabelId、LabelName的对应关系 */ AttributeId: string; /** * 说明:属性标识, 备注:仅支持英文字符,不支持数字,支持下划线。最大支持40个英文字符,如style */ AttributeKey: string; /** * 说明:属性名称 备注:支持中英文字符。最大支持80个中英文字符,如风格 */ AttributeName: string; /** * 说明:标签ID(LabelId)以及标签名(LabelName) 备注: - 不填写LabelId,默认在当前AttributeId下新增标签值(LabelName); - 若填写该AttributeId下的LabelId以及LabelName,则为修改该LabelId对应的标签值 */ Labels?: Array; /** * 说明:删除的标签id */ DeleteLabelIds?: Array; } /** * GetReconstructDocumentResult返回参数结构体 */ export interface GetReconstructDocumentResultResponse { /** * 任务状态。 - `Success`:执行完成 - `Processing`:执行中 - `Pause`: 暂停 - `Failed`:执行失败 - `WaitExecute`:等待执行 */ Status?: string; /** * 解析结果的临时下载地址。文件类型为zip压缩包,下载链接有效期30分钟 */ DocumentRecognizeResultUrl?: string; /** * 文档解析失败的页码 */ FailedPages?: Array; /** * 文档拆分任务的用量 */ Usage?: DocumentUsage; /** * 文档解析任务失败错误信息,当文档解析任务失败会返回具体的错误信息 */ Error?: ErrorInfo; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ListDocs请求参数结构体 */ export interface ListDocsRequest { /** * 知识库ID */ KnowledgeBaseId: string; /** * 页码,默认1 */ PageNumber?: number; /** * 每页数目,最大50,默认20 */ PageSize?: number; } /** * ListDocs返回参数结构体 */ export interface ListDocsResponse { /** * 文档总数 */ TotalCount?: number; /** * 文档信息 */ List?: Array; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 文档拆分任务的用量 */ export interface DocumentUsage { /** * 文档拆分任务的页数 */ PageNumber?: number; /** * 文档拆分任务消耗的总token数 * @deprecated */ TotalToken?: number; /** * 文档拆分任务消耗的总token数 */ TotalTokens?: number; /** * 拆分消耗的token数 */ SplitTokens?: number; /** * mllm消耗的token数 */ MllmTokens?: number; /** * 解析成功页数 */ SuccessPageNum?: number; /** * 解析失败页数 */ FailPageNum?: number; /** * 文件大小,单位:字节 */ FileSize?: number; } /** * ListAttributeLabels请求参数结构体 */ export interface ListAttributeLabelsRequest { /** * 知识库ID */ KnowledgeBaseId: string; /** * 页码,默认1 */ PageNumber?: number; /** * 每页数目,最大50,默认20 */ PageSize?: number; } /** * 搜索结果 */ export interface SearchResult { /** * 索引 */ Index?: number; /** * 链接地址 */ Url?: string; /** * 标题 */ Name?: string; /** * 摘要 */ Snippet?: string; /** * 图标 */ Icon?: string; /** * 站点 */ Site?: string; /** * 1740412800 */ PublishedTime?: number; } /** * DeleteAttributeLabels请求参数结构体 */ export interface DeleteAttributeLabelsRequest { /** * 知识库ID */ KnowledgeBaseId: string; /** * 属性ID */ AttributeIds: Array; } /** * RetrieveKnowledge请求参数结构体 */ export interface RetrieveKnowledgeRequest { /** * 知识库ID。 */ KnowledgeBaseId: string; /** * 用于检索的文本。 */ Query: string; /** * 检索方法,默认使用`HYBRID`混合检索。 - `SEMANTIC`:语义检索 - `FULL_TEXT`:全文检索 - `HYBRID`:混合检索 */ RetrievalMethod?: string; /** * 检索设置。 */ RetrievalSetting?: RetrievalSetting; /** * 标签过滤。 */ AttributeLabels?: Array; } /** * 返回的回复, 支持多个 */ export interface Choice { /** * 结束标志位,可能为 stop、 content_filter。 stop 表示输出正常结束。 content_filter 只在开启流式输出审核时会出现,表示安全审核未通过。 */ FinishReason?: string; /** * 增量返回值,流式调用时使用该字段。 */ Delta?: Delta; /** * 返回值,非流式调用时使用该字段。 */ Message?: Message; /** * 索引值,流式调用时使用该字段。 */ Index?: number; } /** * 创建智能文档解析任务的配置信息 */ export interface CreateReconstructDocumentFlowConfig { /** * Markdown文件中表格返回的形式 0,表格以MD形式返回 1,表格以HTML形式返回 默认为0 */ TableResultType?: string; /** * 智能文档解析返回结果的格式 0:只返回全文MD; 1:只返回每一页的OCR原始Json; 2:只返回每一页的MD, 3:返回全文MD + 每一页的OCR原始Json; 4:返回全文MD + 每一页的MD 5: 返回全文md,每一页ocr原始json,每一页md 默认值为0 */ ResultType?: string; /** * 是否忽略失败页,返回已成功的页数据。默认为true。 */ IgnoreFailedPage?: boolean; } /** * RunRerank请求参数结构体 */ export interface RunRerankRequest { /** * 说明:查询内容 备注:用于匹配的query */ Query: string; /** * 说明:文档列表 备注:最多60个,Query字段和Docs字段的总长度上限为2000字符 */ Docs: Array; /** * 说明:模型名称 备注:仅一个模型可选 默认值:lke-reranker-base */ Model?: string; } /** * 消耗量 */ export interface ChatUsage { /** * 输入token数 */ PromptTokens?: number; /** * 输出token数 */ CompletionTokens?: number; /** * 总token数 */ TotalTokens?: number; } /** * DeleteQAs返回参数结构体 */ export interface DeleteQAsResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 返回的内容 */ export interface Delta { /** * 角色名称。 */ Role?: string; /** * 内容详情。 */ Content?: string; /** * 思维链内容。 ReasoningConent参数仅支持出参,且只有deepseek-r1模型会返回。 */ ReasoningContent?: string; } /** * ReconstructDocumentSSE请求参数结构体 */ export interface ReconstructDocumentSSERequest { /** * 支持解析的文件类型。**支持的文件类型**:WPS、PDF、DOC、DOCX、PPT、PPTX、MD、TXT、XLS、XLSX、CSV、PNG、JPG、JPEG、BMP、GIF、WEBP、HEIC、EPS、ICNS、IM、PCX、PPM、TIFF、XBM、HEIF、JP2**支持的文件大小**:- WPS、PDF、DOC、DOCX、PPT、PPTX 支持100M- MD、TXT、XLS、XLSX、CSV 支持10M- 其他支持20M */ FileType: string; /** * 文件的 URL 地址。文件存储于腾讯云的 URL 可保障更高的下载速度和稳定性,建议文件存储于腾讯云。 非腾讯云存储的 URL 速度和稳定性可能受一定影响。文件的 FileUrl、FileBase64 必须提供一个,如果都提供,只使用 FileUrl。 参考:[腾讯云COS文档](https://cloud.tencent.com/document/product/436/7749) 默认值:无 */ FileUrl?: string; /** * 说明:文件的 Base64 值。 备注:支持的文件大小:所下载文件经Base64编码后不超过 8M。文件下载时间不超过 3 秒。 支持的图片像素:单边介于20-10000px之间。文件的 FileUrl、FileBase64 必须提供一个,如果都提供,只使用 FileUrl。 默认值:无 */ FileBase64?: string; /** * 说明:文档的起始页码。 备注:当传入文件是PDF、PDF、PPT、PPTX、DOC类型时,用来指定识别的起始页码,识别的页码包含当前值。 默认值:无 */ FileStartPageNumber?: number; /** * 说明:文档的结束页码。备注:当传入文件是PDF、PDF、PPT、PPTX、DOC类型时,用来指定识别的结束页码,识别的页码包含当前值,文档页码大于100页建议使用异步解析接入。默认值:无 */ FileEndPageNumber?: number; /** * 说明:文档解析配置信息 备注:可设置返回markdown结果的格式 默认值:无 */ Config?: ReconstructDocumentSSEConfig; } /** * ListAttributeLabels返回参数结构体 */ export interface ListAttributeLabelsResponse { /** * 属性总数 */ TotalCount?: number; /** * 属性标签列表 */ List?: Array; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 检索的结果 */ export interface RetrievalRecord { /** * 检索结果的元数据 */ Metadata?: RetrievalRecordMetadata; /** * 检索到的标题 */ Title?: string; /** * 检索到的内容 */ Content?: string; } /** * 属性标签信息 */ export interface AttributeLabelItem { /** * 标签id 注意:此字段可能返回 null,表示取不到有效值。 */ LabelId?: string; /** * 标签名称,最大80个英文字符 注意:此字段可能返回 null,表示取不到有效值。 */ LabelName?: string; } /** * CreateAttributeLabel请求参数结构体 */ export interface CreateAttributeLabelRequest { /** * 知识库ID */ KnowledgeBaseId: string; /** * 属性标识,最大40个英文字符,如style */ AttributeKey: string; /** * 属性名称,最大80个英文字符,如风格 */ AttributeName: string; /** * 属性标签信息 */ Labels?: Array; } /** * ImportQAs请求参数结构体 */ export interface ImportQAsRequest { /** * 知识库ID */ KnowledgeBaseId: string; /** * 文件名 */ FileName: string; /** * 文件的 Url 地址。文件存储于腾讯云的 Url 可保障更高的下载速度和稳定性,建议文件存储于腾讯云。 非腾讯云存储的 Url 速度和稳定性可能受一定影响。 导入模板:https://cdn.xiaowei.qq.com/lke/assets//static/批量导入问答模板v6.xlsx */ FileUrl: string; /** * 文件类型,仅支持XLSX格式,请使用模板 */ FileType?: string; } /** * DescribeDoc请求参数结构体 */ export interface DescribeDocRequest { /** * 知识库ID */ KnowledgeBaseId: string; /** * 文档ID */ DocId: string; } /** * DeleteKnowledgeBase返回参数结构体 */ export interface DeleteKnowledgeBaseResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DeleteDocs返回参数结构体 */ export interface DeleteDocsResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 属性标签 */ export interface LabelItem { /** * 属性key */ Name?: string; /** * 标签值 */ Values?: Array; } /** * CreateReconstructDocumentFlow请求参数结构体 */ export interface CreateReconstructDocumentFlowRequest { /** * 文件类型。**支持的文件类型:**- `WPS、PDF`、`DOC`、`DOCX`、`XLS`、`XLSX`、`PPT`、`PPTX`、`MD`、`TXT`、`PNG`、`JPG`、`JPEG`、`CSV`、`HTML`、`EPUB`、`BMP`、`GIF`、`WEBP`、`HEIC`、`EPS`、`ICNS`、`IM`、`PCX`、`PPM`、`TIFF`、`XBM`、`HEIF`、`JP2`**支持的文件大小:** - `PDF` 最大300M - `WPS`、`DOCX`、`DOC`、`PPT`、`PPTX` 最大 200M - `TXT`、`MD` 最大10M - 其他 最大20M */ FileType: string; /** * 说明:文件的 URL 地址。 备注:文件存储于腾讯云的 URL 可保障更高的下载速度和稳定性,建议文件存储于腾讯云。 非腾讯云存储的 URL 速度和稳定性可能受一定影响。 参考:[腾讯云COS文档](https://cloud.tencent.com/document/product/436/7749) */ FileUrl?: string; /** * 文件的 Base64 值。 支持的文件类型: PNG、JPG、JPEG、PDF、GIF、BMP、TIFF 支持的文件大小:所下载文件经Base64编码后不超过 8M。文件下载时间不超过 3 秒。 支持的图片像素:单边介于20-10000px之间。 文件的 FileUrl、FileBase64 必须提供一个,如果都提供,只使用 FileUrl。 */ FileBase64?: string; /** * 说明:文档的起始页码。 备注:当传入文件是PDF、PDF、PPT、PPTX、DOC类型时,用来指定识别的起始页码,识别的页码包含当前值。 默认值:无 */ FileStartPageNumber?: number; /** * 说明:文档的结束页码。 备注:当传入文件是PDF、PDF、PPT、PPTX、DOC类型时,用来指定识别的结束页码,识别的页码包含当前值。 默认值:无 */ FileEndPageNumber?: number; /** * 说明:创建文档解析任务配置信息。 备注:可设置结果的返回格式 默认值:无 */ Config?: CreateReconstructDocumentFlowConfig; } /** * GetSplitDocumentResult请求参数结构体 */ export interface GetSplitDocumentResultRequest { /** * 拆分任务ID */ TaskId: string; } /** * ReconstructDocumentSSE 功能配置参数 */ export interface ReconstructDocumentSSEConfig { /** * Markdown文件中表格返回的形式 0,表格以MD形式返回 1,表格以HTML形式返回 默认为0 */ TableResultType?: string; /** * Markdown文件中图片返回的形式 0:markdown中图片以链接形式返回 1:markdown中图片只返回图片中提取的文本内容 默认是0 */ MarkdownImageResponseType?: string; /** * Markdown文件中是否包含页码信息 */ ReturnPageFormat?: boolean; /** * 自定义输出页码样式,{{p}}为页码占位符,开启ReturnPageFormat生效。未填默认样式:page {{p}} */ PageFormat?: string; /** * 是否忽略失败页,返回已成功的页数据 */ IgnoreFailedPage?: boolean; } /** * GetSplitDocumentResult返回参数结构体 */ export interface GetSplitDocumentResultResponse { /** * 任务状态。 - `Success`:执行完成 - `Processing`:执行中 - `Pause`: 暂停 - `Failed`:执行失败 - `WaitExecute`:等待执行 */ Status?: string; /** * 拆分结果的临时下载地址。 文件类型为zip压缩包,下载链接有效期30分钟。 压缩包内包含\*.md、\*.jsonl、\*mllm.json以及images文件夹。 > **jsonl** 结构说明: - `page_content`: 用于生成嵌入(embedding)库,以便于检索使用。该字段中的图片将使用占位符替换。 - `org_data`: 表示与 page_content 对应的最小语义完整性块,用于问答模型的处理。 - `big_data`: 表示与 page_content 对应的最大语义完整性块,也用于问答模型的处理。 */ DocumentRecognizeResultUrl?: string; /** * 文档拆分失败的页码 * @deprecated */ FailedPages?: Array; /** * 文档拆分任务的用量 */ Usage?: DocumentUsage; /** * 文档拆分失败的错误信息,当拆分任务失败时返回该错误信息 */ Error?: ErrorInfo; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyQA返回参数结构体 */ export interface ModifyQAResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 文档解析失败记录 */ export interface ReconstructDocumentFailedPage { /** * 失败页码 注意:此字段可能返回 null,表示取不到有效值。 */ PageNumber?: number; } /** * 文档解析失败记录 */ export interface SplitDocumentFailedPage { /** * 失败页码 注意:此字段可能返回 null,表示取不到有效值。 */ PageNumber?: number; } /** * ModifyAttributeLabel返回参数结构体 */ export interface ModifyAttributeLabelResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 思维链开关类型 */ export interface Thinking { /** * 控制开启思维链,默认disabled enabled:开启思维链 disabled:关闭思维链 */ Type?: string; } /** * QueryRewrite返回参数结构体 */ export interface QueryRewriteResponse { /** * 改写结果 */ Content?: string; /** * 消耗量,返回输入token数,输出token数以及总token数 */ Usage?: Usage; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * UploadDoc请求参数结构体 */ export interface UploadDocRequest { /** * 知识库ID */ KnowledgeBaseId: string; /** * 文件名。 **需带文件类型后缀** */ FileName: string; /** * 文件类型。 **支持的文件类型:** - `PDF`、`DOC`、`DOCX`、`XLS`、`XLSX`、`PPT`、`PPTX`、`MD`、`TXT`、`PNG`、`JPG`、`JPEG`、`CSV` **支持的文件大小:** - `PDF`、`DOCX`、`DOC`、`PPT`、`PPTX` 最大 200M - `TXT`、`MD` 最大10M - 其他 最大20M */ FileType: string; /** * 文件的 URL 地址。 文件存储于腾讯云的 URL 可保障更高的下载速度和稳定性,建议文件存储于腾讯云。 非腾讯云存储的 URL 速度和稳定性可能受一定影响。 参考:[腾讯云COS文档](https://cloud.tencent.com/document/product/436/7749) */ FileUrl: string; /** * 属性标签引用 * @deprecated */ AttributeLabel?: Array; /** * 属性标签引用 */ AttributeLabels?: Array; /** * 分段信息 */ Config?: SegmentationConfig; } /** * CancelTask返回参数结构体 */ export interface CancelTaskResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateKnowledgeBase返回参数结构体 */ export interface CreateKnowledgeBaseResponse { /** * 知识库ID */ KnowledgeBaseId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * GetEmbedding返回参数结构体 */ export interface GetEmbeddingResponse { /** * 特征 */ Data?: Array; /** * 消耗量,返回TotalToken */ Usage?: Usage; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * QueryRewrite请求参数结构体 */ export interface QueryRewriteRequest { /** * 说明:需要改写的多轮历史会话,每轮历史对话需要包含user(问)和assistant(答)成对输入 备注:由于模型字符限制,最多提供4轮对话。针对最后一轮对话进行改写。四轮对话最多包含3600个字符。 */ Messages: Array; /** * 说明:模型名称 备注:仅一个模型可选 默认值:lke-query-rewrite-base */ Model?: string; } /** * 问答对信息 */ export interface QaItem { /** * 问答id 注意:此字段可能返回 null,表示取不到有效值。 */ QaId?: string; /** * 问题 注意:此字段可能返回 null,表示取不到有效值。 */ Question?: string; /** * 答案 注意:此字段可能返回 null,表示取不到有效值。 */ Answer?: string; /** * 属性标签 注意:此字段可能返回 null,表示取不到有效值。 */ AttributeLabels?: Array; /** * 创建时间 注意:此字段可能返回 null,表示取不到有效值。 */ CreateTime?: string; /** * 更新时间 注意:此字段可能返回 null,表示取不到有效值。 */ UpdateTime?: string; } /** * 创建智能文档拆分任务的配置信息 */ export interface CreateSplitDocumentFlowConfig { /** * Markdown文件中表格返回的形式 0,表格以MD形式返回 1,表格以HTML形式返回 默认为 * @deprecated */ TableResultType?: string; /** * 智能文档解析返回结果的格式 0:只返回全文MD; 1:只返回每一页的OCR原始Json; 2:只返回每一页的MD; 3:返回全文MD + 每一页的OCR原始Json; 4:返回全文MD + 每一页的MD; 5:返回全文md,每一页ocr原始json,每一页md。 * @deprecated */ ResultType?: string; /** * 是否开启mllm */ EnableMllm?: boolean; /** * 最大分片长度 */ MaxChunkSize?: number; /** * 是否忽略返回失败页码 */ IgnoreFailedPage?: boolean; /** * 智能文档解析返回结果的格式 0:只返回全文MD; 1:只返回每一页的OCR原始Json; 2:只返回每一页的MD; 3:返回全文MD + 每一页的OCR原始Json; 4:返回全文MD + 每一页的MD; 5:返回全文md,每一页ocr原始json,每一页md。 */ SplitResultType?: string; /** * Markdown文件中表格返回的形式 0,表格以MD形式返回 1,表格以HTML形式返回 默认为 */ SplitTableResultType?: string; } /** * RunRerank返回参数结构体 */ export interface RunRerankResponse { /** * 相关性, 数值越大越相关 */ ScoreList?: Array; /** * 消耗量,仅返回TotalToken */ Usage?: Usage; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateReconstructDocumentFlow返回参数结构体 */ export interface CreateReconstructDocumentFlowResponse { /** * 任务唯一id。30天内可以通过GetReconstructDocumentResult接口查询TaskId对应的处理结果。 */ TaskId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DeleteKnowledgeBase请求参数结构体 */ export interface DeleteKnowledgeBaseRequest { /** * 知识库ID */ KnowledgeBaseId: string; } /** * CreateQA请求参数结构体 */ export interface CreateQARequest { /** * 知识库ID */ KnowledgeBaseId: string; /** * 问题,最大1000个英文字符 */ Question: string; /** * 答案,最大4000个英文字符 */ Answer: string; /** * 属性标签 */ AttributeLabels?: Array; } /** * GetCharacterUsage请求参数结构体 */ export type GetCharacterUsageRequest = null; /** * GetCharacterUsage返回参数结构体 */ export interface GetCharacterUsageResponse { /** * 已用字符数 */ Used?: number; /** * 可用字符数 */ Total?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 属性信息 */ export interface AttributeItem { /** * 属性id 注意:此字段可能返回 null,表示取不到有效值。 */ AttributeId?: string; /** * 属性标识 注意:此字段可能返回 null,表示取不到有效值。 */ AttributeKey?: string; /** * 属性名称 注意:此字段可能返回 null,表示取不到有效值。 */ AttributeName?: string; /** * 标签名称 注意:此字段可能返回 null,表示取不到有效值。 */ Labels?: Array; } /** * 向量 */ export interface EmbeddingObject { /** * 向量 */ Embedding?: Array; } /** * 会话内容 */ export interface Message { /** * 角色 */ Role?: string; /** * 内容 */ Content?: string; /** * 思维链内容。 ReasoningConent参数仅支持出参,且只有deepseek-r1模型会返回。 */ ReasoningContent?: string; /** * 搜索结果 */ SearchResults?: Array; } /** * 错误信息 */ export interface ErrorInfo { /** * 错误码 */ Code?: string; /** * 错误信息 */ Message?: string; } /** * CreateKnowledgeBase请求参数结构体 */ export type CreateKnowledgeBaseRequest = null; /** * ChatCompletions返回参数结构体 */ export interface ChatCompletionsResponse { /** * Unix 时间戳,单位为秒。 */ Created?: number; /** * Token 统计信息。 按照总 Token 数量计费。 */ Usage?: ChatUsage; /** * 本次请求的 RequestId。 */ Id?: string; /** * 回复内容。 */ Choices?: Array; /** * 模型名称。 */ Model?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。本接口为流式响应接口,当请求成功时,RequestId 会被放在 HTTP 响应的 Header "X-TC-RequestId" 中。 */ RequestId?: string; } /** * DeleteDocs请求参数结构体 */ export interface DeleteDocsRequest { /** * 知识库ID */ KnowledgeBaseId: string; /** * 文档ID列表。支持批量删除,数量不超过100 */ DocIds: Array; }