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

本文说明 V3 对外接口的错误码位置、编码规则、常见错误和处理方式。

错误码在哪里返回#

V3 使用两层错误逻辑:
{
  "errno": 0,
  "errmsg": "success",
  "id": "request-id",
  "data": {}
}
层级适用场景判断方式
外层 errno上传、建任务、查任务请求本身请求是否被接受、参数是否合法、任务是否存在
data.result.errno异步任务执行完成或失败任务业务处理是否成功
HTTP 200 只表示接口响应成功返回,不代表异步任务执行成功。客户端必须同时检查外层 errno 和终态任务的 data.result.errno。

V3 专用错误码规则#

任务终态错误使用 5 位错误码:
首位:错误类型
第二位:端点或 op
后三位:具体错误序号
错误类型:
首位含义
1客户端请求错误
2服务端任务/资源错误
3格式转换错误
4文档解析错误
5存储错误
6队列错误
端点或 op:
第二位含义
0通用
1upload
2task
3parse
4extract
5translate
6convert
7info

常见 V3 错误码#

请求与任务创建#

错误码场景返回位置客户端处理
10001参数缺失、格式错误、跨 op 字段、历史字段或未知字段外层 errno按当前 op 的 schema 修正请求
10002缺少 params.doc_id外层 errno先调用 upload,使用返回的 data.doc_id
10003doc_id 为空、伪造或无法解码外层 errno重新上传获取合法令牌,不重试原令牌
10004文件格式不支持或当前 op 没有对应解析能力外层或任务结果更换支持的格式或改用合适的 op
10005文件大小超过系统限制外层 errno压缩文件或调整上传限制参数
10006pipelines 非空或使用了当前未支持的多操作参数外层 errno删除 pipelines 或拆成独立任务
10007op 不在 parse/extract/translate/convert/info 中外层 errno使用已登记的 op

任务查询#

错误码场景返回位置客户端处理
22002task_id 不存在查询接口外层 errno,data=null检查 task_id 是否来自当前环境和上传链路

任务执行#

错误码场景返回位置客户端处理
43001parse 任务入队失败data.result.errno记录任务和 request id;按业务策略重新创建任务
36001convert 任务执行失败data.result.errno检查目标格式、源文件和转换服务状态
43xxxparse 或 extract 解析队列及下游解析失败data.result.errno结合 errmsg 判断格式、队列或下游服务原因
errmsg 会保留可读的下游错误说明;客户端不应依赖 errmsg 的固定文案做程序分支,应优先依据 errno。

上传错误处理#

上传接口常见问题:
场景处理建议
未传 srcg 或传空值补充已登记的 srcg 后重试
多页 HTML 扩展名不符合 source_type=html_pages调整文件扩展名或移除该 source_type
超过 max_pages 或 max_file_size调整限制或拆分文件
上传成功后只保存 data.doc_id。不要把内部 md5 当作 V3 的资源标识,也不要自行构造 doc_id。

SDK 错误处理建议#

三种 SDK 都保留服务端错误信封,并提供终态结果辅助函数。推荐流程:
1.
检查 upload 返回的外层 errno;
2.
检查 task create 返回的外层 errno;
3.
轮询 task query,遇到外层 errno != 0 立即处理查询错误;
4.
进入 completed 或 failed 后检查 data.result.errno;
5.
仅当任务结果 errno 为 0 时读取 output 或 external_output。
不要把“HTTP 200”或“查询接口外层 errno=0”直接当作任务成功。

错误处理示例#

任务失败:
{
  "errno": 0,
  "data": {
    "status": "failed",
    "result": {
      "errno": 10004,
      "errmsg": "不支持的文档格式",
      "data": null
    }
  }
}
此时查询请求本身成功,但任务执行失败,客户端应读取 data.result.errno=10004。
查询不存在的任务:
{
  "errno": 22002,
  "errmsg": "task not found",
  "data": null
}
此时不应继续轮询,应检查 task_id、环境地址和账号绑定关系。
修改于 2026-11-12 07:22:01
上一页
响应格式完整说明
下一页
文档上传
Built with