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 文档智能#

DeepDoc 是面向企业文档的解析、理解、抽取、转换和翻译平台。它把 Office、PDF、网页、纯文本、电子书和邮件等文档转换为可以被搜索、问答、翻译、归档和业务系统继续处理的结构化结果。

能力概览#

文档解析与理解#

将文档内容解析为页面、段落、语义分段、Markdown 和引用关系,适合知识库建设、RAG、问答和内容审阅。

全文与页面文本抽取#

提供全文、分段全文、分页文本和分页分段等结果,适合搜索索引、内容预览、关键词提取和文本统计。

文档转换#

支持常见 Office、PDF、HTML 和图片之间的格式转换,适合在线预览、归档、格式标准化和批量交付。

文档翻译#

支持长文档异步翻译,保留原文结构和版式信息,适合跨语言阅读、资料分发和多语言内容生产。

文档信息与辅助处理#

可获取文档元信息,并提供页面渲染、OCR、版面分析、封面生成、图片裁剪和字幕分段等辅助能力。

AIGC 标识与治理#

支持对 DOC/DOCX、PPT/PPTX、XLS/XLSX、PDF、TXT、HTML 和 Markdown 添加、读取、校验和移除 AIGC 标识,满足内容治理和来源追踪需求。

V3 统一任务模型#

V3 使用“上传 → 建任务 → 查任务”的异步模型:
POST /deepdoc/v3/upload
        ↓ doc_id
POST /deepdoc/v3/task
        ↓ task_id
GET /deepdoc/v3/task/{task_id}
        ↓ pending / running / completed / failed

上传源文件#

POST /deepdoc/v3/upload 支持:
multipart 文件上传;
多文件 HTML 集合上传(source_type=html_pages)。
上传成功返回 data.doc_id,上传时必须提供 srcg。

创建任务#

POST /deepdoc/v3/task 使用统一请求格式:
{
  "op": "parse",
  "params": {
    "doc_id": "{{doc_id}}"
  }
}
当前支持以下任务:
任务用途主要参数或结果
parse结构化解析semantic_seged、markdown、reference
extract文本抽取full_text、seged_full_text、pages、page_segments
translate文档翻译source_lang、target_lang、mode、models
convert格式转换target_ext、in_options、out_options
info文档信息文档元数据和格式信息
parse 面向结构化理解,extract 面向纯文本和页面文本。两者共用任务接口,但输出类型和适用场景不同。

查询任务#

GET /deepdoc/v3/task/{task_id} 返回任务状态。completed 或 failed 时,最终结果位于 data.result:
{
  "errno": 0,
  "data": {
    "status": "completed",
    "result": {
      "errno": 0,
      "errmsg": "success",
      "data": {
        "content_type": "markdown",
        "output": {},
        "external_output": []
      }
    }
  }
}
大结果可以通过 external_output 返回。解析结果通常是结构化 JSON,转换和翻译结果通常提供可下载文件地址。

统一响应和错误#

除特殊接口外,DeepDoc 使用统一响应信封:
{
  "errno": 0,
  "errmsg": "success",
  "id": "request-id",
  "data": {}
}
errno=0 表示当前请求或任务成功;
HTTP 200 不代表异步任务最终成功;
任务失败查看 data.result.errno 和 data.result.errmsg;
查询不存在的任务时,外层返回 errno=22002;
错误码以 api/errno.yaml 为准。

来源标识#

为了更好的实现接口的日志排查定位、服务的数据统计,在第一步操作的文档上传接口中,需要提供 srcg 参数,用来标识调用来自哪里,srcg 采用预注册模式,可以通知服务相关接口人员来进行添加。

追踪ID#

每次接口调用都可以传递 X-Request-ID 请求头,解析服务会将相关标识写入到日志中,可以用来做日志定位和联查,也可以通过请求中返回的请求 id 参数来进行联合排查。

SDK 接入#

V3 提供 Node.js、Python 和 Go SDK,统一封装上传、建任务、轮询、结果下载和结果解析。
SDK结果特点
Node.js二进制结果为 Uint8Array,支持 waitTask() / waitTaskAsync()
Python二进制结果为 bytes,支持同步和 asyncio 等待
Go二进制结果为 []byte,提供强类型 TaskContents 和异步等待
SDK 会自动校验 op 与 content_type 的组合,并处理 external_output 的下载和解析。调用方只需关注业务结果。

典型应用#

企业知识库和 RAG:upload → parse(semantic_seged) → 建立向量/关键词索引;
全文搜索:upload → extract(full_text) → 建立全文索引;
文档预览:upload → parse(markdown) 或页面渲染;
多语言资料处理:upload → translate → 下载翻译文件;
格式标准化:upload → convert → 下载目标格式;
内容治理:调用 AIGC 标识接口进行读取、写入和校验。
修改于 2026-11-12 07:21:59
上一页
查询音频生成状态
下一页
响应格式完整说明
Built with