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