日韩高清免费不卡一区,蜜桃精品人妻一区二区三区,三级黄色老熟妇视频网,台湾无码av一区二区三区

幫助與文檔 > 產(chǎn)品文檔 > 智慧學(xué)習(xí)服務(wù) > API文檔 > 小P老師
小P老師

小P老師簡介

概念解釋

小P老師服務(wù)可以提供全科答疑能力，包含答案解析和思路指引，講解更加生動自然。

說明

Hi，您好，歡迎使用有道智云小P老師接口服務(wù)。

本文檔主要針對需要集成HTTP API的技術(shù)開發(fā)工程師，詳細描述小P老師能力相關(guān)的技術(shù)內(nèi)容。

如果您有與我們商務(wù)合作的需求，可以通過以下方式聯(lián)系我們：

商務(wù)郵箱： AIcloud_Business@corp.youdao.com

如果您對文檔內(nèi)容有任何疑問，可以通過以下幾種方式聯(lián)系我們：

客服QQ：1906538062

AIGC產(chǎn)品技術(shù)交流群 ：837394306

聯(lián)系郵箱： zhiyun@corp.youdao.com

溫馨提示：

  • 本文檔主要針對開發(fā)人員，接入測試前需要獲取應(yīng)用ID和應(yīng)用密鑰，并創(chuàng)建應(yīng)用；如果您還沒有，請按照 新手指南 獲取。
  • 平臺向每個賬戶贈送50元的體驗金，供用戶集成前測試所用。

接口調(diào)用參數(shù)

請求地址

baseUrl: https://openapi.youdao.com/llmserver

通用對話

baseUrl + /ai/teacher/dialogue/chat

請求方式: POST

Content-Type: multipart/form-data

Accept: text/event-stream

接口參數(shù)

字段名 含義 示例 必填
app_key 應(yīng)用標識（應(yīng)用 ID） true
curtime 時間戳(秒) true
salt 隨機字符串，建議使用UUID true
sign 簽名信息：sha256(應(yīng)用ID+curtime+salt+curtime+應(yīng)用密鑰) true
sign_type 簽名類型 v3 true
os_type 系統(tǒng)類型 api true
user_id 用戶id，用來標識用戶，最多100個字符 true
task_id 任務(wù)id，用來標識用戶一次會話session（關(guān)聯(lián)一組對話歷史），由服務(wù)生成，首輪對話為空，非首輪對話以服務(wù)端返回的上一次對話為準 false
task_name 任務(wù)名稱，最多20個字符，首輪對話創(chuàng)建任務(wù)使用，為空時由系統(tǒng)生成 false
parent_chat_id 當前輸入的父對話id，首輪對話為空，非首輪對話以服務(wù)端返回的上一次對話為準 false
chat_info 輸入內(nèi)容，格式為chat_item的列表（目前只支持一個chat_item），chat_item格式在后文中說明 [{"type":"text","content":"你好！"}] true
template_id prompt模版id，實現(xiàn)業(yè)務(wù)定制prompt false
subscribe 訂閱事件。sse流固定返回begin、message、end、error事件。對于其他想要的事件，需要調(diào)用方主動傳遞此參數(shù)訂閱，多個訂閱事件傳值以英文逗號分隔，默認是空-無事件訂閱 false
model_prompt_rate_schema 模型模板，若想使用DeepSeek深度思考能力，設(shè)置為 deepseek_model_prompt deepseek_model_prompt false

接口參數(shù)chat_info中chat_item的格式說明：

一、包含字段
type：輸入類型枚舉【text、image、image_url】
content：輸入內(nèi)容，text文本/image圖片ocr識別的結(jié)果有 token 4096 長度限制

二、type詳細說明
text：文本輸入UTF-8
當 type = text 時，chat_info = [{"type":"text","content":"文本輸入內(nèi)容"}]

image：圖片base64編碼：支持圖片格式：.bmp、.jpg、.png，圖片大小Base64后≤2M
當 type = image 時，chat_info = [{"type":"image","content":"圖片base64編碼"}]

image_url：整張圖片的URL（需要公網(wǎng)能訪問下載）
當 type = image_url 時，chat_info = [{"type":"image_url","content":"圖片的鏈接URL"}]

接口參數(shù)subscribe可訂閱事件說明：

query_suggestion :插件能力，訂閱才執(zhí)行——猜你想問

響應(yīng)結(jié)果

一個成功的返回示例：

"id": "fb981fde-0080-4933-b87b-4a29eaba8d17"
"event":"begin"
"data":{
"request_id": "fb981fde-0080-4933-b87b-4a29eaba8d17",
"task_id": "046dba1a-7f47-4f96-91f2-be4676aa1347",
"chat_id": 1705045207475
}

"id": "fb981fde-0080-4933-b87b-4a29eaba8d17"
"event":"message"
"data":{
"content": "你好，",
"type": "text"
}

"id": "fb981fde-0080-4933-b87b-4a29eaba8d17"
"event":"message"
"data":{
"content": "有什么可以",
"type": "text"
}

"id": "fb981fde-0080-4933-b87b-4a29eaba8d17"
"event":"message"
"data":{
"content": "幫助你的嗎？",
"type": "text"
}

"id": "fb981fde-0080-4933-b87b-4a29eaba8d17"
"event":"end"
"data":{
"request_id": "fb981fde-0080-4933-b87b-4a29eaba8d17",
"usage":[
     {"type":"input_ocr_token","value":110},
     {"type":"output_text_token","value":253},
     {"type":"query","value":1}
]}

響應(yīng)結(jié)果詳解

正常結(jié)果包含的事件 1個begin、1-N個 message、1個end

發(fā)生異常時包含的事件

  • 對話過程中的異常：1個begin、0-N個 message、1個error
  • 參數(shù)異常：1個error

事件說明

  • begin事件：[基礎(chǔ)事件類型——開始]
"id": "fb981fde-0080-4933-b87b-4a29eaba8d17" // 請求id
"event":"begin" // 事件類型
"data":{
"request_id": "fb981fde-0080-4933-b87b-4a29eaba8d17", // 請求id
"task_id": "046dba1a-7f47-4f96-91f2-be4676aa1347", // 任務(wù)id
"chat_id": 1705045207475 // 系統(tǒng)回復(fù)對話的id，下一輪對話的parent_chat_id
}
  • message事件：[基礎(chǔ)事件類型——消息]
"id": "fb981fde-0080-4933-b87b-4a29eaba8d17" // 請求id
"event":"message" // 事件類型
"data":{
"content": "你好，", // 模型回答
"type": "text"       // 回答類型
}
  • end事件：[基礎(chǔ)事件類型——結(jié)束 ]

end 事件中的 usage 可以認為是接口調(diào)用的賬單明細，明細列表從前到后依次包含三個部分：

  1. 輸入明細部分：和 chat_info 參數(shù)中的條目一一對應(yīng)

(1) type為"input_text_token"的明細：對應(yīng)chat_info中type為"text"的文本token數(shù)量

(2) type為"input_ocr_token"的明細：對應(yīng)chat_info中type為"image"或“imageUrl”的OCR識別文本token數(shù)量

  1. 輸出明細部分：

type為"output_text_token"的明細：目前都是文本輸出（返回事件流中message的type為"text"）

  1. 插件使用明細部分：非必填，在訂閱插件能力并有正確的返回時，返回對應(yīng)的明細

(1) type為"query_suggestion"的明細：訂閱猜你想問插件并有正確返回

"id":"e9141d83-e76a-4581-bfeb-0bd6569d8339"
"event":"end" // 事件類型
"data":{
"usage": // 賬單明細
[{
  "type": "input_text_token",   // chat_info中type為"text"的文本token數(shù)量
  "value": 80     // token數(shù)
  },{
  "type": "input_ocr_token",   // chat_info中type為"image"或“imageUrl”的OCR識別文本token數(shù)量
  "value": 110     // token數(shù)
  },{
  "type": "output_text_token", // 模型輸出token數(shù)量
  "value": 64      // token數(shù)
  },{
  "type": "query",     // 系統(tǒng)服務(wù)，按次計費
  "value": 1   // 次數(shù)
  },{
  "type": "query_suggestion",     // 訂閱猜你想問插件且成功，按次計費
  "value": 1   // 次數(shù)
}],
"request_id": "e9141d83-e76a-4581-bfeb-0bd6569d8339"
}
  • error事件：[基礎(chǔ)事件類型——結(jié)束]

error 事件中的 usage 格式同 end 事件，對于不收費異常返回空列表

"id":"e9141d83-e76a-4581-bfeb-0bd6569d8339" // 請求id
"event":"error" // 事件類型
"data":{
"code": 99,
"msg": "系統(tǒng)錯誤",
"request_id": "e9141d83-e76a-4581-bfeb-0bd6569d8339" // 請求id
"usage": []
}
  • 猜你想問事件：[插件能力事件類型——猜你想問]
"id":"e9141d83-e76a-4581-bfeb-0bd6569d8339"
"event":"query_suggestion" // 事件類型
"data":{
"suggestion":["微積分主要包括哪兩大部分？","微分學(xué)的主要研究對象是什么？","積分學(xué)的核心研究內(nèi)容是什么？"],
"code":0,
"msg":"SUCCESS"
}

異常結(jié)果

業(yè)務(wù)異常（通過sse的error事件返回）

  • 缺少公共參數(shù)user_id：[100101-USER_LACK_USER_ID]
  • 缺少業(yè)務(wù)參數(shù)task_id：[100101-USER_LACK_TASK_ID]
  • 缺少業(yè)務(wù)參數(shù)parent_chat_id：[100101-USER_LACK_PARENT_CHAT_ID]
  • 對話內(nèi)容為空或缺少對話內(nèi)容：[100101-USER_LACK_CHAT_CONTENT]
  • 任務(wù)名稱為空串：[100102-USER_WRONG_TASK_NAME]
  • 對話內(nèi)容參數(shù)格式錯誤：[100102-USER_WRONG_CHAT_INFO]
  • 圖片base64無法解析：[100102-USER_WRONG_IMAGE_PARAM]
  • chat_info的type類型不在枚舉范圍：[100102-USER_WRONG_CHAT_TYPE]
  • 沒有查到歷史對話：[100102-USER_WRONG_CHAT_HISTORY]
  • 用戶id超過100字符：[100103-USER_USER_ID_LENGTH_OVER]
  • 任務(wù)名超過20字符：[100103-USER_TASK_NAME_LENGTH_OVER]
  • 圖片base64編碼超過2M：[100103-USER_IMAGE_BASE64_LENGTH_OVER]
  • 輸入token超過4096：[100103-USER_INPUT_TOKEN_OVER]
  • 模板id參數(shù)錯誤取值：[100102-USER_WRONG_TEMPLATE_ID]
  • 模板id參數(shù)沒有權(quán)限：[100102-USER_TEMPLATE_ID_FORBID]
  • 訂閱事件參數(shù)錯誤取值：[100102-USER_WRONG_SUBSCRIBE]
  • 訂閱事件參數(shù)沒有權(quán)限：[100102-USER_SUBSCRIBE_FORBID]
  • 用戶輸入高度敏感：[100111-USER_INPUT_SENSITIVE_HIGH]
  • 用戶輸入中度敏感：[100112-USER_INPUT_SENSITIVE_NORMAL]
  • 用戶使用太頻繁：[100117-USER_RATE_LIMIT ]

其他異常（通過sse的error事件返回）

  • 模型回答內(nèi)容高度敏感：[100201-CUR_ANSWER_SENSITIVE_HIGH]
  • 模型回答內(nèi)容中度敏感：[100202-CUR_ANSWER_SENSITIVE_NORMAL]
  • 請求需要使用token超限：[100243-CUR_OVER_TOTAL_TOKEN]
  • 其他錯誤碼：[100299-CUR_SERVER_ERROR]，用于排查系統(tǒng)問題，可認為是系統(tǒng)錯誤碼

猜你想問

通過對話歷史，或者提供的問題和回答，推薦3個問題。

baseUrl + /plugin/suggest

請求方式: POST

Content-Type: multipart/form-data

接口參數(shù)

字段名 含義 示例 必填
app_key 應(yīng)用標識（應(yīng)用 ID） true
curtime 時間戳(秒) TimeStamp true
salt 隨機字符串，建議使用UUID true
sign 簽名信息：sha256(應(yīng)用ID+curtime+salt+curtime+應(yīng)用密鑰) true
sign_type 簽名類型 v3 true
os_type 系統(tǒng)類型 api true
user_id 用戶id，用來標識用戶，當query/answer為空時必填 false
task_id 任務(wù)id，用來標識用戶一次會話session（關(guān)聯(lián)一組對話歷史），當query/answer為空時必填 false
chat_id chat接口返回的begin事件中的chat_id，最近一次模型回答的id，當query/answer為空時必填 false
query 需要推薦問題的原始問題 false
answer 原始問題的回答 false

響應(yīng)結(jié)果

{
    "code": "0", //錯誤碼
    "msg": "ok", //詳細信息
    "requestId": "", //請求唯一id
    "data": { //結(jié)果對象
        "suggestion": [ //返回結(jié)果
            "推薦問題1","推薦問題2","推薦問題3"
        ],
        "requestId": "" //請求id，onetime接口時用于定位請求
    }
}

異常結(jié)果

業(yè)務(wù)異常

  • 缺少公共參數(shù)user_id：[100101-USER_LACK_USER_ID]
  • 缺少業(yè)務(wù)參數(shù)task_id：[100101-USER_LACK_TASK_ID]
  • 缺少業(yè)務(wù)參數(shù)chat_id：[100101-USER_LACK_CHAT_ID]
  • 錯誤業(yè)務(wù)參數(shù)task_id：[100102-USER_WRONG_TASK_ID]
  • 錯誤業(yè)務(wù)參數(shù)chat_id：[100102-USER_WRONG_CHAT_ID]
  • 查詢不到歷史對話：[100102-USER_WRONG_CHAT_HISTORY]
  • 沒有猜你想問的使用權(quán)限：[102601-SUGGESTION_FORBID]

其他異常

  • 系統(tǒng)內(nèi)部異常：[100299-CUR_SERVER_ERROR]

常用語言 Demo

Java 示例

Xiaop Java demo

Python3 示例

Xiaop python3 demo

go示例

Xiaop go demo

錯誤碼列表

錯誤碼 msg
101 缺少必填的參數(shù)，首先確保必填參數(shù)齊全，然后，確認參數(shù)書寫是否正確。
104 不支持的API類型
105 不支持的簽名類型
106 不支持的響應(yīng)類型
110 無相關(guān)服務(wù)的有效應(yīng)用，應(yīng)用沒有綁定服務(wù)，可以新建服務(wù)。注：某些服務(wù)的結(jié)果發(fā)音需要tts服務(wù)，需要在控制臺創(chuàng)建語音合成實例綁定應(yīng)用后方能使用。
111 開發(fā)者賬號無效
202 簽名檢驗失敗，如果確認應(yīng)用ID和應(yīng)用密鑰的正確性，仍返回202，一般是編碼問題。請確保翻譯文本 q 為UTF-8編碼.
203 訪問IP地址不在可訪問IP列表
205 請求的接口與應(yīng)用的平臺類型不一致，確保接入方式（Android SDK、IOS SDK、API）與創(chuàng)建的應(yīng)用平臺類型一致。如有疑問請參考入門指南
206 因為時間戳無效導(dǎo)致簽名校驗失敗
207 重放請求
303 服務(wù)端的其它異常
401 賬戶已經(jīng)欠費停
405 鑒權(quán)失敗
100101 缺少必要參數(shù)
100102 參數(shù)錯誤
100103 參數(shù)長度超過限制
100111 輸入內(nèi)容高度敏感
100112 輸入內(nèi)容中度敏感
100117 用戶使用太頻繁
100201 模型回答內(nèi)容高度敏感
100202 模型回答內(nèi)容中度敏感
100243 請求需要使用的token超出限制
100299 系統(tǒng)內(nèi)部異常
102601 沒有猜你想問插件的使用權(quán)限
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |