帮助与文档 > 产品文档 > 自然语言翻译服务 > API文档 > DeepSeek模型
DeepSeek模型

DeepSeek模型 API 简介

概念解释

DeepSeek模型:支持DeepSeek模型对话,文本输入。

说明

本文档主要针对需要集成HTTP API的技术开发工程师,详细描述DeepSeek模型的技术内容。

如果您有与我们商务合作的需求,可以通过以下方式联系我们:

商务邮箱: AIcloud_Business@corp.youdao.com

如果您对文档内容有任何疑问,可以通过以下几种方式联系我们:

客服QQ:1906538062

智云翻译技术交流QQ 1群: 652880659

智云翻译技术交流QQ 2群: 669384425

智云翻译技术交流QQ 3群: 807539209

智云翻译技术交流QQ 4群: 936752411

联系邮箱: zhiyun@corp.youdao.com

温馨提示:

  • 本文档主要针对开发人员,接入测试前需要获取 应用ID应用密钥 ,请按照新手指南 获取。

接口说明

DeepSeek模型API HTTPS地址:

https://openapi.youdao.com/ai_dialog/deepSeek

协议须知

调用方在集成大模型翻译API时,请遵循以下规则。

规则 描述
传输方式 HTTPS
请求方式 POST
字符编码 统一使用UTF-8 编码
请求格式 application/json
响应格式 application/json 或 text/event-stream

接口调用参数

调用API需要向接口发送以下字段来访问服务。

字段名 类型 含义 必填 备注
appKey text 应用ID True 可在应用管理 查看
salt text 随机字符串,可使用UUID进行生产 True uuid (可使用uuid生成)
sign text 签名 True sha256(appKey+salt+curtime+appSecret)
signType text 签名类型 True v4
curtime text 当前UTC时间戳(秒) True TimeStamp
stream bool 是否期望流式返回 False 默认false
maxTokens int 返回最大token数 False 模型回复最大长度(单位 token),默认4096,取值范围各个模型不同
model text 模型名称 True 支持的模型列表
messages array 对话历史 True 对话历史,格式见下方

签名生成方法如下: signType=v4; sign=sha256(appKey+salt+curtime+appSecret);

不同语言获取时间戳,请参看此链接

如果对签名有疑问,可以参看各语言demo。

参数messages列表元素结构

参数名称 类型 描述
role text system: 系统消息; user: 用户消息; assistant: 对话助手消息
content text 消息内容

模型选项

模型名称 模型领域 可配置最大输出长度(token) 最大上下文长度(token)
Deepseek-v3 通用任务 8k 64k
Deepseek-r1 通用任务,复杂任务 8k 64k
Deepseek-r1-distill-qwen-7b 通用任务,复杂任务 8k 64k
Deepseek-r1-distill-qwen-32b 通用任务,复杂任务 8k 64k

输出结果

  • 如果stream=false,非流式返回,返回结果为json
  • 如果stream=true,流式返回,输出结果为响应式流。

非流式结果的示例

示例一:“正常返回”结果

{
  "code": "0",
  "msg": "SUCCESS",
  "requestId": "28b8d9e4-ea19-49a0-bb82-9846cde8b807",
  "data": {
    "model": "deepseek-v3-241226",
    "choices": [
      {
        "index": 0,
        "message": {
          "role": "assistant",
          "content": "你好!我是一个人工智能助手,我的设计目的是帮助回答各种问题、提供信息、协助解决问题,或者只是进行友好的对话。你可以问我任何问题,我会尽力提供有用的回答。有什么我可以帮你的吗?",
          "reasoning_content": null
        },
        "finish_reason": "stop"
      }
    ],
    "usage": {
      "prompt_tokens": 5,
      "completion_tokens": 52,
      "total_tokens": 57
    }
  }
}

示例二:“异常返回”结果

{
  "code": "101",
  "msg": "params validate error",
  "requestId": "63ba1ae9-633e-4291-b2c6-d280bb4b35a5",
  "data": null
}

流式正常结果的格式

部分 event类型 data结构 说明
第1部分 message {
"code":"0",
"data":{"choices":[{"index":0,"message":{"content":"我可以","role":"ASSISTANT"}}],"model":"deepseek-v3-241226"},
"msg":"SUCCESS",
"requestId":"5a2b724d-30d0-424f-a941-9e0dba73dcf0"
}
主要是四部分,code:0代表请求成功,msg代表请求成功或失败信息,requestId标识一次请求,data是主要结构体
第2部分 end {
"code":"0",
"data":{"choices":[{"finishReason":"stop","index":0,"message":{"content":"","role":"ASSISTANT"}}],"model":"deepseek-v3-241226"},
"msg":"SUCCESS",
"requestId":"db73cf86-ff23-4c50-8edb-32b87086c6cd"
}
主要是四部分,code:0代表请求成功,msg代表请求成功或失败信息,requestId标识一次请求,data是主要结构体

流式结果的示例

示例一:“正常返回”结果

{"code":"0","data":{"choices":[{"index":0,"message":{"content":"我可以","role":"ASSISTANT"}}],"model":"deepseek-v3-241226"},"msg":"SUCCESS","requestId":"5a2b724d-30d0-424f-a941-9e0dba73dcf0"}
{"code":"0","data":{"choices":[{"index":0,"message":{"content":"帮","role":"ASSISTANT"}}],"model":"deepseek-v3-241226"},"msg":"SUCCESS","requestId":"1cfe2cda-70bb-4479-b3d6-3e0bf5dc0f50"}
{"code":"0","data":{"choices":[{"index":0,"message":{"content":"你的","role":"ASSISTANT"}}],"model":"deepseek-v3-241226"},"msg":"SUCCESS","requestId":"2b1a9be0-aa23-4015-bf98-e7a101adef33"}
{"code":"0","data":{"choices":[{"index":0,"message":{"content":"吗","role":"ASSISTANT"}}],"model":"deepseek-v3-241226"},"msg":"SUCCESS","requestId":"c70d50be-c719-4bd6-bcb4-201ce855dbf7"}
{"code":"0","data":{"choices":[{"index":0,"message":{"content":"?","role":"ASSISTANT"}}],"model":"deepseek-v3-241226"},"msg":"SUCCESS","requestId":"4dfc4814-911f-474e-b47e-7862d9a36b74"}
{"code":"0","data":{"choices":[{"finishReason":"stop","index":0,"message":{"content":"","role":"ASSISTANT"}}],"model":"deepseek-v3-241226"},"msg":"SUCCESS","requestId":"db73cf86-ff23-4c50-8edb-32b87086c6cd"}

示例二:“异常返回”结果

{"code":"110","msg":"auth failed","requestId":"c31818bd-1be6-4d47-bc67-b72c4f866120","data":null}

错误代码列表

错误码 含义
101 缺少必填的参数,首先确保必填参数齐全,然后确认参数书写是否正确。
102 不支持的语言类型
103 翻译文本过长
104 不支持的API类型
105 不支持的签名类型
106 不支持的响应类型
107 不支持的传输加密类型
108 应用ID无效,注册账号,登录后台创建应用并完成绑定,可获得应用ID和应用密钥等信息
109 batchLog格式不正确
110 无相关服务的有效应用,应用没有绑定服务应用,可以新建服务应用。注:某些服务的翻译结果发音需要tts服务,需要在控制台创建语音合成服务绑定应用后方能使用。
111 开发者账号无效
112 请求服务无效
113 q不能为空
114 不支持的图片传输方式
116 strict字段取值无效,请参考文档填写正确参数值
201 解密失败,可能为DES,BASE64,URLDecode的错误
202 签名检验失败,如果确认应用ID和应用密钥的正确性,仍返回202,一般是编码问题。请确保翻译文本 q 为UTF-8编码.
203 访问IP地址不在可访问IP列表
205 请求的接口与应用的平台类型不一致,确保接入方式(Android SDK、IOS SDK、API)与创建的应用平台类型一致。如有疑问请参考入门指南
206 因为时间戳无效导致签名校验失败
207 重放请求
303 服务端异常
500 未知错误,请提供详细数据信息,联系技术人员协助排查
DEEPSEEK001 不支持的模型名称