数据结构

最近更新时间:2025-10-14 01:37:06

我的收藏

Choice

返回的回复, 支持多个。

被如下接口引用:ChatCompletions。

名称 类型 必选 描述
Message OutputMessage 返回的回复。

Chunk

切片对象信息

被如下接口引用:ChunkDocument。

名称 类型 必选 描述
Index Integer chunk索引。切片顺序 id。
示例值:0
Content String chunk内容。
示例值:今天天气很好

ChunkConfig

文档分片配置

被如下接口引用:ChunkDocument。

名称 类型 必选 描述
MaxChunkSize Integer 最大分片长度
示例值:4800
Delimiters Array of String 分隔符列表
示例值:["\n\n", "\n", "。", "!", "?", ",", ""]
ChunkOverlap Integer 相邻切片重合字符数,需要小于分片长度
示例值:4000

ChunkConfigAsync

文档切片异步任务

被如下接口引用:ChunkDocumentAsync。

名称 类型 必选 描述
MaxChunkSize Integer 最大分片长度
示例值:4800

ChunkDocument

切片文档信息

被如下接口引用:ChunkDocument。

名称 类型 必选 描述
FileType String 文件类型,支持 MD,TXT 格式。
示例值:TXT
FileContent String 文本原文,使用字符串格式输入。
示例值:hello,world

Document

文档信息

被如下接口引用:ChunkDocumentAsync, ParseDocumentAsync。

名称 类型 必选 描述
FileType String 支持的文件类型: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

文档解析支持的文件大小:
-PDF、DOC、DOCX、PPT、PPTX支持100M
-MD、TXT、XLS、XLSX、CSV支特10M
-其他支持20M

文本切片支持的文件大小:
-PDF最大300M
-D0CX、D0C、PPT、PPTX最大200M
-TXT、MD最大10M
-其他最大20M
示例值:DOC
FileUrl String 文件存储于腾讯云的 URL 可保障更高的下载速度和稳定性,使用腾讯云COS 文件地址。
示例值:https://example.com/example.pdf
FileContent String 文件的 base64 值,携带 MineType前缀信息。编码后的后的文件不超过 10M。
支持的文件大小:所下载文件经Base64编码后不超过 8M。文件下载时间不超过3秒。
支持的图片像素:单边介于20-10000px之间。
示例值:data:text/plain;base64,SGVsbG8sIFdvcmxkIQ==
FileName String 文件名称,当使用 base64上传的时候使用。
示例值:example.txt
FileStartPageNumber Integer 文档的起始页码
示例值:1
FileEndPageNumber Integer 文档的结束页码
示例值:1

DocumentChunkUsage

文档切片用量

被如下接口引用:GetDocumentChunkResult。

名称 类型 必选 描述
PageNumber Integer 解析页面数量
示例值:1
TotalTokens Integer 消耗 token数量
示例值:1

DocumentParseConfig

文档解析配置

被如下接口引用:ParseDocument。

名称 类型 必选 描述
ImageResponseType Integer 0:图片以链接形式返回
1:返回图片中提取的文本内容
示例值:1

EmbeddingData

向量内容

被如下接口引用:GetMultiModalEmbedding, GetTextEmbedding。

名称 类型 描述
Embedding Array of Float embedding 内容
注意:此字段可能返回 null,表示取不到有效值。
示例值:[3.234,13.4556]
Index Integer 索引序号
注意:此字段可能返回 null,表示取不到有效值。
示例值:3

Message

会话内容,按对话时间从旧到新在数组中排列,长度受模型窗口大小限制。

被如下接口引用:ChatCompletions。

名称 类型 必选 描述
Role String 角色,可选值包括 system、user、assistant、 tool。
示例值:user
Content String 具体文本内容
示例值:请问如何访问腾讯云官网?
ToolCallId String 当role为tool时传入,标识具体的函数调用
示例值:call_cq16e7k2c3m1v
ToolCalls Array of ToolCall 模型生成的工具调用

MultiModalEmbeddingData

多模态特征向量

被如下接口引用:GetMultiModalEmbedding。

名称 类型 描述
TextEmbeddings Array of EmbeddingData 文本特征向量
注意:此字段可能返回 null,表示取不到有效值。
ImageEmbeddings Array of EmbeddingData 图片特征向量
注意:此字段可能返回 null,表示取不到有效值。

MultiModalUsage

多模态向量化消耗tokens和images数量

被如下接口引用:GetMultiModalEmbedding。

名称 类型 描述
TotalTokens Integer 消耗tokens
示例值:100
TotalImages Integer 输入图片数量
示例值:2

OnlineSearchOptions

联网搜索选项。

被如下接口引用:ChatCompletions。

名称 类型 必选 描述
Engine String 搜索引擎。支持 bing 和 sogou。
示例值:bing

OutputMessage

会话内容,按对话时间从旧到新在数组中排列,长度受模型窗口大小限制。

被如下接口引用:ChatCompletions。

名称 类型 必选 描述
Role String 角色
示例值:user
Content String 文本内容
示例值:深圳今天的天气是晴转多云。
ReasoningContent String 推理内容
示例值:用户询问天气,需要联网搜索结果。
ToolCalls Array of ToolCall 模型生成的工具调用

PageUsage

消耗页数

被如下接口引用:GetDocumentParseResult, ParseDocument。

名称 类型 必选 描述
TotalPages Integer 消耗总页数
示例值:1

ParseDocument

文档信息

被如下接口引用:ParseDocument。

名称 类型 必选 描述
FileType String 支持的文件类型: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

文档解析支持的文件大小:
-PDF、DOC、DOCX、PPT、PPTX支持100M
-MD、TXT、XLS、XLSX、CSV支特10M
-其他支持20M

文本切片支持的文件大小:
-PDF最大300M
-D0CX、D0C、PPT、PPTX最大200M
-TXT、MD最大10M
-其他最大20M
示例值:PDF
FileUrl String 文件存储于腾讯云的 URL 可保障更高的下载速度和稳定性,使用腾讯云COS 文件地址。
示例值:https://example.com/example.pdf
FileContent String 文件的 base64 值,携带 MineType前缀信息。编码后的后的文件不超过 10M。
支持的文件大小:所下载文件经Base64编码后不超过 8M。文件下载时间不超过3秒。
支持的图片像素:单边介于20-10000px之间。
文件的 FileUrl、FileContent必须提供一个,如果都提供只使用 FileUrl。
示例值:data:text/plain;base64,SGVsbG8sIFdvcmxkIQ==
DocumentParseConfig DocumentParseConfig 文档解析配置
FileStartPageNumber Integer 文档的起始页码
示例值:1
FileEndPageNumber Integer 文档的结束页码
示例值:1

RerankResult

输出结果

被如下接口引用:RunRerank。

名称 类型 描述
Index Integer 对应的doc在输入候选doc数组中的位置索引值
注意:此字段可能返回 null,表示取不到有效值。
示例值:4
RelevanceScore Float 相似度分数
注意:此字段可能返回 null,表示取不到有效值。
示例值:43.2
Document String doc原文内容
注意:此字段可能返回 null,表示取不到有效值。
示例值:今天天气怎样

TokenUsage

token使用量

被如下接口引用:ChatCompletions。

名称 类型 必选 描述
PromptTokens Integer 表示prompt的tokens数,多次返回中保持不变
示例值:324
CompletionTokens Integer 回答的token总数,在流式返回中,表示到目前为止所有completion的tokens总数,多次返回中持续累加
示例值:309
TotalTokens Integer 表示prompt_tokens和completion_tokens之和
示例值:633

Tool

用户指定模型使用的工具

被如下接口引用:ChatCompletions。

名称 类型 必选 描述
Type String 工具类型,当前只支持function
示例值:function
Function ToolFunction 具体要调用的function

ToolCall

模型生成的工具调用

被如下接口引用:ChatCompletions。

名称 类型 必选 描述
Id String 工具调用id
示例值:call_cpv320k2c3m8fgcs8ja0
Type String 工具调用类型,当前只支持function
示例值:function
Function ToolCallFunction 具体的function调用
Index Integer 索引值
示例值:0

ToolCallFunction

具体的function调用

被如下接口引用:ChatCompletions。

名称 类型 必选 描述
Name String function名称
示例值:get_current_weather
Arguments String function参数,一般为json字符串
示例值:{"location":["北京","深圳"],"unit":"celsius"}

ToolFunction

function定义

被如下接口引用:ChatCompletions。

名称 类型 必选 描述
Name String function名称,只能包含a-z,A-Z,0-9,_或-
示例值:get_current_weather
Parameters String function参数,一般为json字符串
示例值:{"type":"object","properties":{"location":{"type":"string","description":"The city and state, e.g. San Francisco, CA"}},"required":["location","unit"]}
Description String function的简单描述
示例值:获取当前地点的天气

Usage

token消耗总数

被如下接口引用:ChunkDocument, GetTextEmbedding, RunRerank。

名称 类型 描述
TotalTokens Integer tokens总数
注意:此字段可能返回 null,表示取不到有效值。
示例值:32

WebContent

搜索结果网页信息。

被如下接口引用:ChatCompletions。

名称 类型 描述
Query String 搜素问题
示例值:今天 深圳 天气 2025
Title String 标题
示例值:标题
Url String 链接
示例值:https://example.com
Time String 时间
示例值:16小时前
Content String 网页内容
示例值:深圳龙岗,今日小雨。
ChunkIndex String 切片索引
示例值:0
Score String 分数
示例值:0