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。
参数名称 | 类型 | 描述 |
---|---|---|
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 |
{
"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 | 不支持的模型名称 |