360智脑开放平台-官方文档
  1. 帮助文档
  • 快速开始
  • 文本生成
    • 对话接口
      • chat/completions(OpenAI格式)
      • messages(Claude格式)
      • Responses API(OpenAI格式)
      • systemone
    • tools工具箱
      • 搜索增强
      • 模板调用
      • 技能分发
      • 网页分析
      • 知识库增强
      • 知识库增强-模板调用
  • 图片生成
    • 生成图片
    • 编辑图片
  • 视频理解
    • 视频理解
  • 视频生成
    • seedance官方协议
      • 创建视频生成任务
      • 查询视频生成任务
    • 生视频统一协议
      • seedance
        • seedance素材管理
          • 快速开始
          • 创建素材库
          • 在素材库中创建素材
          • 更新素材库
          • 更新素材
          • 删除素材库
          • 删除素材
          • 查询素材库列表
          • 查询素材库信息
          • 查询素材列表
          • 查询素材信息
          • 查询真人素材库信息
          • 拉起真人认证 H5
        • 创建视频生成(seedance)
      • 创建视频生成
      • 创建视频生成(vidu)
      • 创建视频生成(kling)
      • 查询视频生成状态
  • 音频处理
    • 语音识别(ASR)
    • 语音合成(TTS)
    • 语音合成(TTS)异步
    • 查询音频生成状态
  • 文档智能
    • 帮助文档
      • 服务介绍
      • 响应格式完整说明
      • 错误码说明
    • 文档上传
      POST
    • 创建文档处理任务
      POST
    • 查询处理任务结果
      GET
  • AI翻译
    • 产品介绍
      • 文本翻译介绍
      • 图片翻译介绍
      • 文档翻译介绍
      • 错误码说明
    • 文本翻译
    • 图片翻译
    • 文档翻译-创建任务(异步)
    • 文档翻译-获取结果
  • 记忆库
    • 产品介绍
    • 添加记忆
    • 获取记忆结果
    • 检索记忆
    • 获取记忆列表
    • 删除全部记忆
    • 删除单条记忆
  • web搜索(360智搜)
    • 360智搜-基础版(SR)
    • 360智搜-进阶版(PRO)
    • 360智搜-极致版(MAX)
    • 360智搜-新闻
    • 360智搜-精品内容库
    • 360智搜-文搜图
    • 360智搜-图搜图
    • 360智搜-AI搜索
    • 360智搜-新闻垂搜
    • 360智搜-热点资讯
  • AI安全
    • 文本风险检测
    • 图片风险检测
    • 音频风险检测
    • 视频风险检测
    • 查询视频风险检测任务结果
  • 文档解析
    • 文档上传
    • 获取内容
  • 向量化
    • 向量生成
    • 语义相似度计算
  • 更多说明
    • 更优雅地使用本文档
    • 错误码
    • 速率限制
    • 前缀缓存
    • 智能调度
    • 模型发现
      • 模型列表
      • 模型详情
    • 第三方工具配置
      • CC Switch + Claude Code 快速配置
      • CC Switch + Codex快速配置
  • 数据模型
    • Responses API
      • ResponseInputText
      • ResponseInputImage
      • ResponseInputFile
      • ResponseError
      • ResponseConversationParam
      • ResponseIncludable
      • ResponseInputMessageContentList
      • EasyInputMessage
      • ToolChoiceTypes
      • ToolChoiceOptions
      • ToolChoiceMcp
      • ToolChoiceFunction
      • ToolChoiceCustom
      • ToolChoiceApplyPatch
      • ToolChoiceAllowed
      • Message
      • FileCitation
      • ContainerFileCitation
      • URLCitation
      • ToolChoiceShell
      • FilePath
      • ResponseOutputText
      • ResponseOutputRefusal
      • ResponseOutputMessage
    • ErrorResponse
  1. 帮助文档

响应格式完整说明

Deepdoc v3 任务响应格式#

1. 适用接口#

接口作用
POST /deepdoc/v3/task创建任务,返回 task_id
GET /deepdoc/v3/task/{task_id}查询任务状态和终态结果
v3 使用异步任务模式:创建任务成功只表示任务已受理,实际结果需要通过 task_id 查询。
创建任务 -> data.task_id
查询任务 -> pending / running / completed / failed

2. JSON 类型约定#

标记说明
必有契约要求对象中存在该字段
可选字段可能不存在,客户端不能假定一定返回
可为 null字段存在时值可以是 JSON null
动态结构字段内部结构未完全固定,应使用通用 JSON 类型
“可选”和“可为 null”不同:{} 表示字段不存在;{"output": null} 表示字段存在且值为 null。

3. 外层响应信封#

{
  "id": "request-id",
  "errno": 0,
  "errmsg": "success",
  "data": {}
}
字段JSON 类型约束说明
idstring可选服务端为当前 HTTP 请求生成的 request ID;不是 task_id
errnointeger必有当前 HTTP 请求错误码,0 表示成功
errmsgstring可选当前请求的错误或状态说明
dataobject / null可选业务数据,结构随接口和结果变化
外层 errno 表示创建请求或查询请求本身的结果;data.result.errno 表示异步任务执行结果。

4. 创建任务响应#

4.1 成功#

{
  "id": "request-id",
  "errno": 0,
  "data": {
    "task_id": "task-uuid"
  }
}
字段类型约束说明
data.task_idstring成功时必有独立的 v3 任务标识,用于后续查询

4.2 失败#

{
  "id": "request-id",
  "errno": 10002,
  "errmsg": "缺少文档令牌",
  "data": null
}
失败时不能读取 data.task_id。

5. 查询任务响应#

{
  "id": "query-request-id",
  "errno": 0,
  "data": {
    "status": "running",
    "progress": 60
  }
}
字段JSON 类型约束说明
data.statusstring必有pending、running、completed、failed
data.progressnumber可选进度百分比,范围 0~100,允许小数
data.resultobject终态出现任务终态结果
查询响应的 data 不定义 task_id 字段;使用请求路径中的任务 ID 关联响应。

5.1 pending#

{
  "id": "request-id",
  "errno": 0,
  "data": {
    "status": "pending",
    "progress": 0
  }
}

5.2 running#

{
  "id": "request-id",
  "errno": 0,
  "data": {
    "status": "running",
    "progress": 60
  }
}
pending 和 running 阶段不应假定 result 存在。

5.3 completed#

{
  "id": "request-id",
  "errno": 0,
  "data": {
    "status": "completed",
    "progress": 100,
    "result": {
      "errno": 0,
      "errmsg": null,
      "data": {
        "content_type": "full_text",
        "output": {
          "contents": "示例全文",
          "meta": {
            "page_count": 1
          }
        },
        "external_output": []
      }
    }
  }
}

5.4 failed#

{
  "id": "request-id",
  "errno": 0,
  "data": {
    "status": "failed",
    "progress": 100,
    "result": {
      "errno": 36001,
      "errmsg": "任务执行失败",
      "data": null
    }
  }
}

5.5 任务不存在#

{
  "id": "request-id",
  "errno": 22002,
  "errmsg": "任务不存在",
  "data": null
}

6. 任务结果信封:data.result#

{
  "errno": 0,
  "errmsg": null,
  "data": {}
}
字段JSON 类型约束说明
errnointeger必有任务执行错误码,0 表示成功
errmsgstring / null必有任务错误说明,成功时为 null
dataobject / null必有成功时为结果数据,失败时为 null

7. 任务结果数据:data.result.data#

{
  "content_type": "full_text",
  "output": {
    "contents": "示例全文",
    "meta": {}
  },
  "external_output": []
}
字段JSON 类型约束说明
content_typestring必有结果语义类型,同时决定 contents 类型
outputobject / null必有内联结果;使用外部结果时为 null
external_outputarray必有外部文件列表;内联结果时为空数组

8. content_type 枚举#

能力content_typecontents 类型
parsesemantic_seged分段对象数组
parsemarkdownstring
parsereference引用对象数组
extractfull_textstring
extractseged_full_textstring
extractpagesstring[]
extractpage_segments分段对象数组
infodocument_infonull
convertconverted_document外部文件
translatetranslated_document外部文件

9. 小结果与大结果#

output 与 external_output 二选一:
输出方式outputexternal_output处理方式
内联结果对象[]直接读取 output.contents 和 output.meta
外部结果null至少一个对象遍历数组并使用 file_url 下载
对于 parse 和 extract,小结果通常内联,大结果写入外部存储。默认内联转外置阈值为 8192 字节,部署环境可以调整;客户端应根据实际响应判断,不应自行推断。
translate 和 convert 只返回 external_output。info 使用 document_info,contents 为 null,信息全部位于 meta。

9.1 小结果:内联 JSON#

{
  "content_type": "full_text",
  "output": {
    "contents": "这是提取出的全文。",
    "meta": {
      "page_count": 1,
      "file_ext": "pdf"
    }
  },
  "external_output": []
}

9.2 大结果:外部 JSON#

{
  "content_type": "full_text",
  "output": null,
  "external_output": [
    {
      "storage": "s3",
      "key": "v3/results/example/result.json",
      "file_url": "https://example.com/result.json",
      "file_size": 16384,
      "file_ext": "json",
      "mime_type": "application/json"
    }
  ]
}
下载后的 JSON 文件内容仍为:
{
  "contents": "较长的全文内容……",
  "meta": {
    "page_count": 20,
    "file_ext": "pdf"
  }
}
外部 JSON 文件是 {contents, meta, usages?},不是完整 HTTP 响应信封。

9.3 转换或翻译外部文件#

{
  "content_type": "converted_document",
  "output": null,
  "external_output": [
    {
      "storage": "s3",
      "key": "v3/results/example/document.pdf",
      "file_url": "https://example.com/document.pdf",
      "file_size": 1048576,
      "file_ext": "pdf",
      "mime_type": "application/pdf"
    }
  ]
}
转换和翻译的 file_url 指向实际文件,不能一律按 JSON 解析。

10. 内联结果:output#

{
  "contents": "示例内容",
  "meta": {
    "page_count": 1
  }
}
字段JSON 类型约束说明
contentsstring / array / null必有类型由 content_type 决定
metaobject必有文档公共元信息,内部字段均可缺省
usagesobject[]可选单页段落翻译增强的模型用量,与 contents、meta 平级
usages 仅在 translation.include_usages=true 时生成,元素内部字段未固定定义。

11. contents 结构示例#

11.1 semantic_seged / page_segments#

{
  "contents": [
    {
      "type": "paragraph",
      "seg_num": 1,
      "page_num": 1,
      "content": "Hello, world.",
      "translation": "你好,世界。"
    }
  ],
  "meta": {
    "page_count": 1
  }
}
分段对象字段:
字段类型约束说明
typestring可选分段类型
seg_numinteger可选分段编号
page_numinteger可选页码
contentstring可选内容文本
para_datastring可选段落数据
con_typestring可选内容类型
sourcestring可选内容来源
versionstring可选版本信息
source_typestring可选来源类型
not_translationboolean可选是否不翻译
translationstring可选段落翻译结果

11.2 markdown#

{
  "contents": "# 标题\n\n正文内容。",
  "meta": {
    "page_count": 1
  }
}

11.3 full_text#

{
  "contents": "第一页文本。\n第二页文本。",
  "meta": {
    "page_count": 2
  }
}

11.4 seged_full_text#

{
  "contents": "第一段。\n\n第二段。",
  "meta": {
    "page_count": 1
  }
}
该类型仍然是字符串,不是对象数组。

11.5 pages#

{
  "contents": [
    "第一页文本。",
    "第二页文本。"
  ],
  "meta": {
    "page_count": 2
  }
}

11.6 reference#

{
  "contents": [
    {
      "content": "Example reference",
      "title": "Example paper",
      "authors": ["Author A", "Author B"],
      "year": 2025,
      "doi": "10.0000/example",
      "arxiv": "2501.00001",
      "url": "https://example.com/paper"
    }
  ],
  "meta": {}
}
year 兼容 integer 或 string;引用对象允许附加字段。

11.7 document_info#

{
  "contents": null,
  "meta": {
    "page_count": 10,
    "file_ext": "pdf",
    "file_size": 1048576
  }
}

12. 文档元信息:meta#

字段JSON 类型说明
page_countinteger文档页数
languagestring识别出的语言
language_versionstring语言识别器版本
file_sizeinteger文件大小,单位字节
file_extstring文件扩展名
is_garbledboolean是否识别为乱码
source_typestring来源类型
page_widthnumber页面宽度
page_heightnumber页面高度
aigc_infostringAIGC 信息字符串
示例:
{
  "page_count": 10,
  "language": "en",
  "language_version": "example-version",
  "file_size": 1048576,
  "file_ext": "pdf",
  "is_garbled": false,
  "source_type": "pdf",
  "page_width": 595.0,
  "page_height": 842.0,
  "aigc_info": "{\"provider\":\"example\"}"
}

13. 外部结果:external_output[]#

external_output 始终是数组:内联结果为空数组;外部结果至少包含一个文件对象;多文件或渐进式结果可能包含多个对象。

13.1 文件对象#

字段JSON 类型约束说明
page_rangeobject可选文件对应的页码范围
page_range.startinteger存在时必有起始页码,从 1 开始,闭区间
page_range.endinteger存在时必有结束页码,从 1 开始,闭区间
storagestring必有当前枚举为 s3
keystring必有对象存储 key
file_urlstring必有文件访问 URL
file_sizeinteger必有文件大小,单位字节,最小为 0
file_extstring必有文件扩展名
mime_typestring必有MIME 类型

13.2 多文件示例#

{
  "content_type": "converted_document",
  "output": null,
  "external_output": [
    {
      "page_range": {"start": 1, "end": 1},
      "storage": "s3",
      "key": "v3/results/example/page-1.png",
      "file_url": "https://example.com/page-1.png",
      "file_size": 100000,
      "file_ext": "png",
      "mime_type": "image/png"
    },
    {
      "page_range": {"start": 2, "end": 2},
      "storage": "s3",
      "key": "v3/results/example/page-2.png",
      "file_url": "https://example.com/page-2.png",
      "file_size": 110000,
      "file_ext": "png",
      "mime_type": "image/png"
    }
  ]
}

14. 静态语言建模建议#

V3Response<T> {
    id: optional<string>
    errno: integer
    errmsg: optional<string>
    data: optional<T | null>
}

TaskCreateData {
    task_id: string
}

TaskQueryData {
    status: TaskStatus
    progress: optional<number>
    result: optional<TaskResult>
}

TaskStatus = "pending" | "running" | "completed" | "failed"

TaskResult {
    errno: integer
    errmsg: string | null
    data: TaskResultData | null
}

TaskResultData {
    content_type: ContentType
    output: TaskResultOutput | null
    external_output: ExternalOutput[]
}

TaskResultOutput {
    contents: JSON value
    meta: TaskResultMeta
    usages: optional<JSON object[]>
}

TaskResultMeta {
    page_count: optional<integer>
    language: optional<string>
    language_version: optional<string>
    file_size: optional<integer>
    file_ext: optional<string>
    is_garbled: optional<boolean>
    source_type: optional<string>
    page_width: optional<number>
    page_height: optional<number>
    aigc_info: optional<string>
}

ExternalOutput {
    page_range: optional<PageRange>
    storage: "s3"
    key: string
    file_url: string
    file_size: integer
    file_ext: string
    mime_type: string
}

PageRange {
    start: integer
    end: integer
}

14. 推荐解析流程#

1. 解析外层响应。
2. 外层 errno != 0:处理请求错误,不解析成功 data。
3. 创建任务时保存 data.task_id。
4. 查询任务时读取 data.status。
5. pending / running:继续轮询。
6. completed / failed:读取 data.result。
7. result.errno != 0:处理任务执行错误。
8. result.errno == 0:读取 result.data。
9. output != null:根据 content_type 解析 contents。
10. output == null:遍历 external_output 并下载文件。
11. parse / extract 的外部文件按 {contents, meta, usages?} JSON 解析;
    convert / translate 的外部文件按实际 MIME 类型处理。
建议静态语言客户端先把 contents 接收为原始 JSON,再根据 content_type 转换为 string、string[]、分段对象数组、引用对象数组或 null。
修改于 2026-11-12 07:22:03
上一页
服务介绍
下一页
错误码说明
Built with