DeepSeek模型 API 簡介
概念解釋
DeepSeek模型:支持DeepSeek模型對(duì)話,文本輸入。
說明
本文檔主要針對(duì)需要集成HTTP API的技術(shù)開發(fā)工程師,詳細(xì)描述DeepSeek模型的技術(shù)內(nèi)容。
如果您有與我們商務(wù)合作的需求,可以通過以下方式聯(lián)系我們:
商務(wù)郵箱: AIcloud_Business@corp.youdao.com
如果您對(duì)文檔內(nèi)容有任何疑問,可以通過以下幾種方式聯(lián)系我們:
客服QQ:1906538062
智云翻譯技術(shù)交流QQ 1群: 652880659
智云翻譯技術(shù)交流QQ 2群: 669384425
智云翻譯技術(shù)交流QQ 3群: 807539209
智云翻譯技術(shù)交流QQ 4群: 936752411
聯(lián)系郵箱: zhiyun@corp.youdao.com
溫馨提示:
- 本文檔主要針對(duì)開發(fā)人員,接入測試前需要獲取
應(yīng)用ID
和 應(yīng)用密鑰
,請(qǐng)按照新手指南 獲取。
接口說明
DeepSeek模型API HTTPS地址:
https://openapi.youdao.com/ai_dialog/deepSeek
協(xié)議須知
調(diào)用方在集成大模型翻譯API時(shí),請(qǐng)遵循以下規(guī)則。
規(guī)則 |
描述 |
傳輸方式 |
HTTPS |
請(qǐng)求方式 |
POST |
字符編碼 |
統(tǒng)一使用UTF-8 編碼 |
請(qǐng)求格式 |
application/json |
響應(yīng)格式 |
application/json 或 text/event-stream |
接口調(diào)用參數(shù)
調(diào)用API需要向接口發(fā)送以下字段來訪問服務(wù)。
字段名 |
類型 |
含義 |
必填 |
備注 |
appKey |
text |
應(yīng)用ID |
True |
可在應(yīng)用管理 查看 |
salt |
text |
隨機(jī)字符串,可使用UUID進(jìn)行生產(chǎn) |
True |
uuid (可使用uuid生成) |
sign |
text |
簽名 |
True |
sha256(appKey+salt+curtime+appSecret) |
signType |
text |
簽名類型 |
True |
v4 |
curtime |
text |
當(dāng)前UTC時(shí)間戳(秒) |
True |
TimeStamp |
stream |
bool |
是否期望流式返回 |
False |
默認(rèn)false |
maxTokens |
int |
返回最大token數(shù) |
False |
模型回復(fù)最大長度(單位 token),默認(rèn)4096,取值范圍各個(gè)模型不同 |
model |
text |
模型名稱 |
True |
支持的模型列表 |
messages |
array |
對(duì)話歷史 |
True |
對(duì)話歷史,格式見下方 |
簽名生成方法如下:
signType=v4;
sign=sha256(appKey+salt+curtime+appSecret);
不同語言獲取時(shí)間戳,請(qǐng)參看此鏈接
如果對(duì)簽名有疑問,可以參看各語言demo。
參數(shù)messages列表元素結(jié)構(gòu)
參數(shù)名稱 |
類型 |
描述 |
role |
text |
system: 系統(tǒng)消息; user: 用戶消息; assistant: 對(duì)話助手消息 |
content |
text |
消息內(nèi)容 |
模型選項(xiàng)
模型名稱 |
模型領(lǐng)域 |
可配置最大輸出長度(token) |
最大上下文長度(token) |
Deepseek-v3 |
通用任務(wù) |
8k |
64k |
Deepseek-r1 |
通用任務(wù),復(fù)雜任務(wù) |
8k |
64k |
Deepseek-r1-distill-qwen-7b |
通用任務(wù),復(fù)雜任務(wù) |
8k |
64k |
Deepseek-r1-distill-qwen-32b |
通用任務(wù),復(fù)雜任務(wù) |
8k |
64k |
輸出結(jié)果
- 如果stream=false,非流式返回,返回結(jié)果為json
- 如果stream=true,流式返回,輸出結(jié)果為響應(yīng)式流。
非流式結(jié)果的示例
示例一:“正常返回”結(jié)果
{
"code": "0",
"msg": "SUCCESS",
"requestId": "28b8d9e4-ea19-49a0-bb82-9846cde8b807",
"data": {
"model": "deepseek-v3-241226",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "你好!我是一個(gè)人工智能助手,我的設(shè)計(jì)目的是幫助回答各種問題、提供信息、協(xié)助解決問題,或者只是進(jìn)行友好的對(duì)話。你可以問我任何問題,我會(huì)盡力提供有用的回答。有什么我可以幫你的嗎?",
"reasoning_content": null
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 5,
"completion_tokens": 52,
"total_tokens": 57
}
}
}
示例二:“異常返回”結(jié)果
{
"code": "101",
"msg": "params validate error",
"requestId": "63ba1ae9-633e-4291-b2c6-d280bb4b35a5",
"data": null
}
流式正常結(jié)果的格式
部分 |
event類型 |
data結(jié)構(gòu) |
說明 |
第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代表請(qǐng)求成功,msg代表請(qǐng)求成功或失敗信息,requestId標(biāo)識(shí)一次請(qǐng)求,data是主要結(jié)構(gòu)體 |
第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代表請(qǐng)求成功,msg代表請(qǐng)求成功或失敗信息,requestId標(biāo)識(shí)一次請(qǐng)求,data是主要結(jié)構(gòu)體 |
流式結(jié)果的示例
示例一:“正常返回”結(jié)果
{"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"}
示例二:“異常返回”結(jié)果
{"code":"110","msg":"auth failed","requestId":"c31818bd-1be6-4d47-bc67-b72c4f866120","data":null}
錯(cuò)誤代碼列表
錯(cuò)誤碼 |
含義 |
101 |
缺少必填的參數(shù),首先確保必填參數(shù)齊全,然后確認(rèn)參數(shù)書寫是否正確。 |
102 |
不支持的語言類型 |
103 |
翻譯文本過長 |
104 |
不支持的API類型 |
105 |
不支持的簽名類型 |
106 |
不支持的響應(yīng)類型 |
107 |
不支持的傳輸加密類型 |
108 |
應(yīng)用ID無效,注冊(cè)賬號(hào),登錄后臺(tái)創(chuàng)建應(yīng)用并完成綁定,可獲得應(yīng)用ID和應(yīng)用密鑰等信息 |
109 |
batchLog格式不正確 |
110 |
無相關(guān)服務(wù)的有效應(yīng)用,應(yīng)用沒有綁定服務(wù)應(yīng)用,可以新建服務(wù)應(yīng)用。注:某些服務(wù)的翻譯結(jié)果發(fā)音需要tts服務(wù),需要在控制臺(tái)創(chuàng)建語音合成服務(wù)綁定應(yīng)用后方能使用。 |
111 |
開發(fā)者賬號(hào)無效 |
112 |
請(qǐng)求服務(wù)無效 |
113 |
q不能為空 |
114 |
不支持的圖片傳輸方式 |
116 |
strict字段取值無效,請(qǐng)參考文檔填寫正確參數(shù)值 |
201 |
解密失敗,可能為DES,BASE64,URLDecode的錯(cuò)誤 |
202 |
簽名檢驗(yàn)失敗,如果確認(rèn)應(yīng)用ID和應(yīng)用密鑰的正確性,仍返回202,一般是編碼問題。請(qǐng)確保翻譯文本 q 為UTF-8編碼. |
203 |
訪問IP地址不在可訪問IP列表 |
205 |
請(qǐng)求的接口與應(yīng)用的平臺(tái)類型不一致,確保接入方式(Android SDK、IOS SDK、API)與創(chuàng)建的應(yīng)用平臺(tái)類型一致。如有疑問請(qǐng)參考入門指南 |
206 |
因?yàn)闀r(shí)間戳無效導(dǎo)致簽名校驗(yàn)失敗 |
207 |
重放請(qǐng)求 |
303 |
服務(wù)端異常 |
500 |
未知錯(cuò)誤,請(qǐng)?zhí)峁┰敿?xì)數(shù)據(jù)信息,聯(lián)系技術(shù)人員協(xié)助排查 |
DEEPSEEK001 |
不支持的模型名稱 |