2026年文心一言api开发者文档,python版ERNIE-3.5-8K-Preview模型调用方法

文心一言api开发者文档,python版ERNIE-3.5-8K-Preview模型调用方法p ERNIE 3 5 是百度自研的旗舰级大规模 语 模型 覆盖海量中英文语料 具有强大的通用能力 可满足绝大部分对话问答 创作生成 插件应用场景要求 支持自动对接百度搜索插件 保障问答信息时效 本文介绍了 ERNIE 3 5 8K Preview 相关 API p 调用本接口 发起一次对话请求 本文 API 支持 2 种鉴权方式 不同鉴权方式

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



 

ERNIE 3.5是百度自研的旗舰级大规模⼤语⾔模型,覆盖海量中英文语料,具有强大的通用能力,可满足绝大部分对话问答、创作生成、插件应用场景要求;支持自动对接百度搜索插件,保障问答信息时效。本文介绍了ERNIE-3.5-8K-Preview相关API。

调用本接口,发起一次对话请求。

  • 本文API,支持2种鉴权方式。不同鉴权方式,调用方式不同,使用Header、Query参数不同,详见本文请求说明。开发者可以选择以下任一种方式进行鉴权。
    • 访问凭证access_token鉴权
    • 基于安全认证AK/SK进行签名计算鉴权

基本信息

请求地址: https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/ernie-3.5-8k-preview

请求方式: POST

Header参数

根据不同鉴权方式,查看对应Header参数。

  • 访问凭证access_token鉴权
名称 类型 必填 描述 Content-Type string 是 固定值application/json
  • 基于安全认证AK/SK进行签名计算鉴权
名称 类型 必填 描述 Content-Type string 是 固定值application/json x-bce-date string 否 当前时间,遵循ISO8601规范,格式如2016-04-06T08:23:49Z Authorization string 是 用于验证请求合法性的认证信息,更多内容请参考鉴权认证机制,签名工具可参考IAM签名工具

Query参数

只有访问凭证access_token鉴权方式,需使用Query参数。

  • 访问凭证access_token鉴权
名称 类型 必填 描述 access_token string 是 通过API Key和Secret Key获取的access_token,参考Access Token获取

Body参数

名称 类型 必填 描述 messages List(message) 是 聊天上下文信息。说明:
(1)messages成员不能为空,1个成员表示单轮对话,多个成员表示多轮对话;例如:
· 1个成员示例, “messages”: [ {“role”: “user”,“content”: “你好”}]
· 3个成员示例, “messages”: [ {“role”: “user”,“content”: “你好”},{“role”:“assistant”,“content”:“需要什么帮助”},{“role”:“user”,“content”:“自我介绍下”}]
(2)最后一个message为当前请求的信息,前面的message为历史对话信息
(3)成员数目必须为奇数,成员中message的role值说明如下:奇数位message的role值必须为user或function,偶数位message的role值为assistant,第一个message的role不能是function。例如:
示例中message中的role值分别为user、assistant、user、assistant、user;奇数位(红框)message中的role值为user,即第1、3、5个message中的role值为user;偶数位(蓝框)值为assistant,即第2、4个message中的role值为assistant









































(4)message中的content总长度、functions和system字段总内容不能超过20000 个字符,且不能超过5120 tokens

functions List(function) 否 一个可触发函数的描述列表,说明:
(1)支持的function数量无限制
(2)长度限制,message中的content总长度、functions和system字段总内容不能超过20000 个字符,且不能超过5120 tokens

temperature float 否 说明:
(1)较高的数值会使输出更加随机,而较低的数值会使其更加集中和确定
(2)默认0.8,范围 (0, 1.0],不能为0

top_p float 否 说明:
(1)影响输出文本的多样性,取值越大,生成文本的多样性越强
(2)默认0.8,取值范围 [0, 1.0]

penalty_score float 否 通过对已生成的token增加惩罚,减少重复生成的现象。说明:
(1)值越大表示惩罚越大
(2)默认1.0,取值范围:[1.0, 2.0]

stream bool 否 是否以流式接口的形式返回数据,默认false system string 否 模型人设,主要用于人设设定,例如,你是xxx公司制作的AI助手,说明:
(1)长度限制,message中的content总长度、functions和system字段总内容不能超过20000 个字符,且不能超过5120 tokens
(2)如果同时使用system和functions,可能暂无法保证使用效果,持续进行优化

stop List(string) 否 生成停止标识,当模型生成结果以stop中某个元素结尾时,停止文本生成。说明:
(1)每个元素长度不超过20字符
(2)最多4个元素

disable_search bool 否 是否强制关闭实时搜索功能,默认false,表示不关闭 enable_citation bool 否 是否开启上角标返回,说明:
(1)开启后,有概率触发搜索溯源信息search_info,search_info内容见响应参数介绍
(2)默认false,不开启

enable_trace bool 否 是否返回搜索溯源信息,说明:
(1)如果开启,在触发了搜索增强的场景下,会返回搜索溯源信息search_info,search_info内容见响应参数介绍
(2)默认false,表示不返回

max_output_tokens int 否 指定模型最大输出token数,说明:
(1)如果设置此参数,范围[2, 2048]
(2)如果不设置此参数,最大输出token数为2048

response_format string 否 指定响应内容的格式,说明:
(1)可选值:
· json_object:以json格式返回,可能出现不满足效果情况
· text:以文本格式返回
(2)如果不填写参数response_format值,默认为text



user_id string 否 表示最终用户的唯一标识符 tool_choice tool_choice 否 在函数调用场景下,提示大模型选择指定的函数(非强制),说明:指定的函数名必须在functions中存在

message说明

名称 类型 必填 描述 role string 是 当前支持以下:
user: 表示用户
assistant: 表示对话助手
function: 表示函数


content string 是 对话内容,说明:
(1)当前message存在function_call,且role=”assistant”时可以为空,其他场景不能为空
(2)最后一个message对应的content不能为blank字符,包含空格、”n”、“r”、“f”等
(3)当role为function,content为JSON格式,效果可能更好


name string 否 message作者;当role=function时,必填,且是响应内容中function_call中的name function_call function_call 否 函数调用,function call场景下第一轮对话的返回,第二轮对话作为历史信息在message中传入



































function说明

functions中function说明如下

名称 类型 必填 描述 name string 是 函数名 description string 是 函数描述 parameters object 是 函数请求参数,说明:
(1)JSON Schema 格式,参考JSON Schema描述
(2)如果函数没有请求参数,parameters值格式如下:
{“type”: “object”,“properties”: {}}


responses object 否 函数响应参数,JSON Schema 格式,参考JSON Schema描述 examples List(List(example)) 否 function调用的一些历史示例,说明:
(1)可以提供正例(正常触发)和反例(无需触发)的example
·正例:从历史请求数据中获取
·反例:
       当role = user,不会触发请求的query
       当role = assistant,有固定的格式。function_call的name为空,arguments是空对象:”{}”,thought可以填固定的:”我不需要调用任何工具”
(2)兼容之前的 List(example) 格式



























































example说明

名称 类型 必填 描述 role string 是 当前支持以下:
user: 表示用户
assistant: 表示对话助手
function: 表示函数


content string 是 对话内容,说明:
(1)当前message存在function_call,且role=”assistant”时可以为空,其他场景不能为空
(2)最后一个message对应的content不能为blank字符,包含空格、”n”、“r”、“f”等

name string 否 message作者;当role=function时,必填,且是响应内容中function_call中的name function_call function_call 否 函数调用,function call场景下第一轮对话的返回,第二轮对话作为历史信息在message中传入





























function_call说明

名称 类型 必填 描述 name string 是 触发的function名 arguments string 是 请求参数 thoughts string 否 模型思考过程

tool_choice说明

名称 类型 必填 描述 type string 是 指定工具类型,function function function 是 指定要使用的函数

function说明

tool_choice中function说明如下

名称 类型 必填 描述 name string 是 指定要使用的函数名

响应头Header参数

部分参数如下。

名称 描述 X-Ratelimit-Limit-Requests 一分钟内允许的最大请求次数 X-Ratelimit-Limit-Tokens 一分钟内允许的最大tokens消耗,包含输入tokens和输出tokens X-Ratelimit-Remaining-Requests 达到RPM速率限制前,剩余可发送的请求数配额,如果配额用完,将会在0-60s后刷新 X-Ratelimit-Remaining-Tokens 达到TPM速率限制前,剩余可消耗的tokens数配额,如果配额用完,将会在0-60s后刷新

响应体参数

名称 类型 描述 id string 本轮对话的id object string 回包类型
chat.completion:多轮对话返回
created int 时间戳 sentence_id int 表示当前子句的序号。只有在流式接口模式下会返回该字段 is_end bool 表示当前子句是否是最后一句。只有在流式接口模式下会返回该字段 is_truncated bool 当前生成的结果是否被截断 finish_reason string 输出内容标识,说明:
· normal:输出内容完全由大模型生成,未触发截断、替换
· stop:输出结果命中入参stop中指定的字段后被截断
· length:达到了最大的token数,根据EB返回结果is_truncated来截断
· content_filter:输出内容被截断、兜底、替换为等
· function_call:调用了funtion call功能




search_info search_info 搜索数据,当请求参数enable_citation或enable_trace为true,并且触发搜索时,会返回该字段 result string 对话返回结果 need_clear_history bool 表示用户输入是否存在安全风险,是否关闭当前会话,清理历史会话信息
· true:是,表示用户输入存在安全风险,建议关闭当前会话,清理历史会话信息
· false:否,表示用户输入无安全风险

flag int 说明:
· 0:正常返回
· 其他:非正常

ban_round int 当need_clear_history为true时,此字段会告知第几轮对话有敏感信息,如果是当前问题,ban_round=-1 usage usage token统计信息 function_call function_call 由模型生成的函数调用,包含函数名称,和调用参数



























































search_info说明

名称 类型 描述 search_results List(search_result) 搜索结果列表

search_result说明

名称 类型 描述 index int 序号 url string 搜索结果URL title string 搜索结果标题

usage说明

名称 类型 描述 prompt_tokens int 问题tokens数 completion_tokens int 回答tokens数 total_tokens int tokens总数 plugins List(plugin_usage) plugin消耗的tokens

plugin_usage说明

名称 类型 描述 name string plugin名称,chatFile:chatfile插件消耗的tokens parse_tokens int 解析文档tokens abstract_tokens int 摘要文档tokens search_tokens int 检索文档tokens total_tokens int 总tokens

function_call说明

名称 类型 描述 name string 触发的function名 thoughts string 模型思考过程 arguments string 请求参数

注意 :同步模式和流式模式,响应参数返回不同,详细内容参考示例描述。

  • 同步模式下,响应参数为以上字段的完整json包。
  • 流式模式下,各字段的响应参数为 data: {响应参数}。

以访问凭证access_token鉴权方式为例,说明如何调用API,示例如下。

请求示例(单轮)python

 import requests import json def get_access_token(): """ 使用 API Key,Secret Key 获取access_token,替换下列示例中的应用API Key、应用Secret Key """ url = "https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=[应用API Key]&client_secret=[应用Secret Key]" payload = json.dumps("") headers = { 'Content-Type': 'application/json', 'Accept': 'application/json' } response = requests.request("POST", url, headers=headers, data=payload) return response.json().get("access_token") def main(): url = "https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/ernie-3.5-8k-preview?access_token=" + get_access_token() payload = json.dumps({ "messages": [ { "role": "user", "content": "你好" } ] }) headers = { 'Content-Type': 'application/json' } response = requests.request("POST", url, headers=headers, data=payload) print(response.text) if __name__ == '__main__': main()

响应示例(单轮)json

HTTP/1.1 200 OK Date: Fri, 19 Jan 2024 08:49:13 GMT Content-Type: application/json;charset=utf-8 Statement: AI-generated X-Ratelimit-Limit-Requests: 300 X-Ratelimit-Limit-Tokens:  X-Ratelimit-Remaining-Requests: 298 X-Ratelimit-Remaining-Tokens:  { "id": "as-61qu1k9xvf", "object": "chat.completion", "created": , "result": "你好,请问有什么我可以帮助你的吗?无论你有什么问题或需要帮助,我都会尽力回答和协助你。请随时告诉我你的需求。", "is_truncated": false, "need_clear_history": false, "finish_reason": "normal", "usage": { "prompt_tokens": 1, "completion_tokens": 29, "total_tokens": 30 } }

请求示例(多轮)python

 import requests import json def get_access_token(): """ 使用 API Key,Secret Key 获取access_token,替换下列示例中的应用API Key、应用Secret Key """ url = "https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=[应用API Key]&client_secret=[应用Secret Key]" payload = json.dumps("") headers = { 'Content-Type': 'application/json', 'Accept': 'application/json' } response = requests.request("POST", url, headers=headers, data=payload) return response.json().get("access_token") def main(): url = "https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/ernie-3.5-8k-preview?access_token=" + get_access_token() payload = json.dumps({ "messages": [ { "role": "user", "content": "你好" }, { "role": "assistant", "content": "你好,请问有什么我可以帮助你的吗?无论你有什么问题或需要帮助,我都会尽力回答和协助你。请随时告诉我你的需求。" }, { "role": "user", "content": "我在上海,周末可以去哪里玩?" }, { "role": "assistant", "content": "上海是一个充满活力和文化氛围的城市,有很多适合周末游玩的地方。以下是几个值得推荐的地方: 1. 上海科技馆:上海科技馆是中国大陆最大的科技馆之一,有许多互动展览和科学实验室,可以让您了解科技的发展历史和最新成果。 2. 上海博物馆:上海博物馆是一座集艺术、历史和文化于一体的博物馆,有许多精美的艺术品和文物,可以让您深入了解中国和世界的文化历史。 3. 外滩:外滩是上海的标志性景点之一,有许多高楼大厦和繁华的商业街区,是欣赏黄浦江美景和城市风貌的好去处。 4. 上海迪士尼乐园:上海迪士尼乐园是世界上最大的迪士尼主题公园之一,有许多精彩的游乐项目和演出,可以让您尽情享受娱乐和欢乐。 5. 上海野生动物园:上海野生动物园是一个以自然保护为主题的野生动物园,有许多珍稀动物和植物,可以让您近距离接触大自然。 这些地方都是上海周末游玩的好去处,可以根据自己的兴趣和需求选择合适的行程。" }, { "role": "user", "content": "上海有哪些美食" } ] }) headers = { 'Content-Type': 'application/json' } response = requests.request("POST", url, headers=headers, data=payload) print(response.text) if __name__ == '__main__': main()

响应示例(多轮)​​​​​​​json

HTTP/1.1 200 OK Date: Wed, 28 Feb 2024 02:04:30 GMT Content-Type: application/json;charset=utf-8 Statement: AI-generated X-Ratelimit-Limit-Requests: 300 X-Ratelimit-Limit-Tokens:  X-Ratelimit-Remaining-Requests: 299 X-Ratelimit-Remaining-Tokens:  { "id": "as-g1mtr4p03c", "object": "chat.completion", "created": , "result": "上海是一个美食之都,拥有许多独特的地方特色菜肴和小吃。以下是一些上海的美食推荐:nn1. 生煎包:生煎包是上海的特色小吃之一,底部酥脆,上部松软,馅料鲜美,深受当地人喜爱。nn2. 南翔小笼包:南翔小笼包是上海的著名特色小吃,皮薄馅嫩,汤汁丰富,味道鲜美,是品尝上海传统美食的必选之一。nn3. 白斩鸡:白斩鸡是上海菜中的一道经典菜肴,鸡肉鲜嫩多汁,口感滑爽,搭配上调料食用更佳。nn4. 油条:油条是上海的传统早餐食品之一,外酥里嫩,香气四溢,搭配豆浆或豆腐脑食用更佳。nn5. 蟹壳黄:蟹壳黄是一种上海传统小吃,因其形似蟹壳而得名,口感香脆,馅料丰富,有甜、咸两种口味可选。nn6. 咸豆花:咸豆花是上海的传统小吃之一,豆花口感细腻,搭配咸味的调料和配料,味道独特而美味。nn除了以上几种美食,上海还有许多其他特色小吃和菜肴,如糖醋排骨、红烧肉、松鼠桂鱼、罗宋汤等。无论您是美食家还是普通游客,都可以在上海找到满足自己味蕾的美食佳肴。", "is_truncated": false, "need_clear_history": false, "finish_reason": "normal", "usage": { "prompt_tokens": 259, "completion_tokens": 306, "total_tokens": 565 } }

请求示例(流式)​​​​​​​python​​​​​​​

 import requests import json def get_access_token(): """ 使用 API Key,Secret Key 获取access_token,替换下列示例中的应用API Key、应用Secret Key """ url = "https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=[应用API Key]&client_secret=[应用Secret Key]" payload = json.dumps("") headers = { 'Content-Type': 'application/json', 'Accept': 'application/json' } response = requests.request("POST", url, headers=headers, data=payload) return response.json().get("access_token") def main(): url = "https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/ernie-3.5-8k-preview?access_token=" + get_access_token() payload = json.dumps({ "messages": [ { "role": "user", "content": "给我推荐一些自驾游路线" } ], "stream": True }) headers = { 'Content-Type': 'application/json' } response = requests.request("POST", url, headers=headers, data=payload, stream=True) for line in response.iter_lines(): print(line.decode("UTF-8")) if __name__ == '__main__': main()

响应示例(流式)json

HTTP/1.1 200 OK Date: Wed, 28 Feb 2024 02:02:31 GMT Content-Type: text/event-stream;charset=utf-8 Cache-Control: no-cache Statement: AI-generated X-Ratelimit-Limit-Requests: 300 X-Ratelimit-Limit-Tokens:  X-Ratelimit-Remaining-Requests: 299 X-Ratelimit-Remaining-Tokens:  data: {"id":"as-0gcrii0a9k","object":"chat.completion","created":,"sentence_id":0,"is_end":false,"is_truncated":false,"result":"当然可以","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":6,"completion_tokens":0,"total_tokens":6}} data: {"id":"as-0gcrii0a9k","object":"chat.completion","created":,"sentence_id":1,"is_end":false,"is_truncated":false,"result":",以下是一些建议的自驾游路线:nn1. 丝绸之路自驾游:西安出发,经过天水、兰州、嘉峪关","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":6,"completion_tokens":0,"total_tokens":6}} data: {"id":"as-0gcrii0a9k","object":"chat.completion","created":,"sentence_id":2,"is_end":false,"is_truncated":false,"result":"、敦煌,最后到达哈密和乌鲁木齐。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":6,"completion_tokens":0,"total_tokens":6}} data: {"id":"as-0gcrii0a9k","object":"chat.completion","created":,"sentence_id":3,"is_end":false,"is_truncated":false,"result":"这条路线将带你领略古代丝绸之路的辉煌和壮丽。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":6,"completion_tokens":0,"total_tokens":6}} data: {"id":"as-0gcrii0a9k","object":"chat.completion","created":,"sentence_id":4,"is_end":false,"is_truncated":false,"result":"n2. 海南环岛自驾:这是一条热带天堂的自驾路线,你可以尽情享受海南的美丽海滩和热带风情。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":6,"completion_tokens":0,"total_tokens":6}} data: {"id":"as-0gcrii0a9k","object":"chat.completion","created":,"sentence_id":5,"is_end":false,"is_truncated":false,"result":"n3. 穿越阿里大北线:成都出发,经过广元、汉中、西安、延安、银川、阿拉善左","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":6,"completion_tokens":0,"total_tokens":6}} data: {"id":"as-0gcrii0a9k","object":"chat.completion","created":,"sentence_id":6,"is_end":false,"is_truncated":false,"result":"旗等地,最后回到成都。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":6,"completion_tokens":0,"total_tokens":6}} data: {"id":"as-0gcrii0a9k","object":"chat.completion","created":,"sentence_id":7,"is_end":false,"is_truncated":false,"result":"这条路线将带你穿越中国的大西北,感受高原的壮丽和神秘。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":6,"completion_tokens":0,"total_tokens":6}} data: {"id":"as-0gcrii0a9k","object":"chat.completion","created":,"sentence_id":8,"is_end":false,"is_truncated":false,"result":"n4. 寻找那北方的净土——自驾阿尔山:北京出发,经过张家口、张北、太仆寺旗等地","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":6,"completion_tokens":176,"total_tokens":182}} data: {"id":"as-0gcrii0a9k","object":"chat.completion","created":,"sentence_id":9,"is_end":false,"is_truncated":false,"result":",最后到达阿尔山。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":6,"completion_tokens":176,"total_tokens":182}} data: {"id":"as-0gcrii0a9k","object":"chat.completion","created":,"sentence_id":10,"is_end":false,"is_truncated":false,"result":"这条路线将带你领略北方的自然风光和纯净之美。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":6,"completion_tokens":176,"total_tokens":182}} data: {"id":"as-0gcrii0a9k","object":"chat.completion","created":,"sentence_id":11,"is_end":false,"is_truncated":false,"result":"nn这些路线各具特色,可以满足不同人群的需求。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":6,"completion_tokens":176,"total_tokens":182}} data: {"id":"as-0gcrii0a9k","object":"chat.completion","created":,"sentence_id":12,"is_end":false,"is_truncated":false,"result":"无论你喜欢历史人文、自然风光还是热带风情,都可以在这些路线中找到满意的旅程。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":6,"completion_tokens":176,"total_tokens":182}} data: {"id":"as-0gcrii0a9k","object":"chat.completion","created":,"sentence_id":13,"is_end":false,"is_truncated":false,"result":"在计划行程时,记得留出时间来享受路途中的风景,这样你的自驾游体验将更加丰富和难忘。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":6,"completion_tokens":176,"total_tokens":182}} data: {"id":"as-0gcrii0a9k","object":"chat.completion","created":,"sentence_id":14,"is_end":true,"is_truncated":false,"result":"","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":6,"completion_tokens":255,"total_tokens":261}}

function call示例(单轮)

第一次请求
  • Bash
# 步骤一,获取access_token,替换下列示例中的API Key与Secret Key curl 'https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=[API Key]&client_secret=[Secret Key]' # 步骤二,调用本文API,使用步骤一获取的access_token,替换下列示例中的”调用接口获取的access_token“ curl -X POST 'https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/ernie-3.5-8k-preview?access_token=[步骤一调用接口获取的access_token]' -d '{ "messages": [ {"role":"user","content":"上海市今天的天气"} ], "functions": [ , "unit": { "type": "string", "enum": ["摄氏度", "华氏度"] } }, "required": ["location"] } }, , "exchange": { "type": "string", "enum": ["纳斯达克", "上海证券交易所","香港证券交易所"] } }, "required": ["company", "exchange"] }, "responses": { "type": "object", "properties": { "price": { "type": "int", "description": "当日股票价格" }, "unit": { "type": "string", "enum": ["人民币", "美元","港币"], "description": "股票价格货币类型" }, "change": { "type": "string", "description": "当日股票价格变化,如下跌3%,上涨0.5%" } } }, "examples": [ [ {"role":"user","content":"What is the weather like in Boston?"}, "}} ], [ {"role":"user","content":"你的名字是什么?"}, {"role": "assistant", "content": null, "function_call": {"name": "", "arguments": "{}", "thoughts":"我无需调用任何工具"}} ] ] } ], "stream":true, "tool_choice": } }' | iconv -f utf-8 -t utf-8
第一次响应​​​​​​​json
data: "},"usage":{"prompt_tokens":8,"completion_tokens":46,"total_tokens":54}}
函数调用
  • Bash
curl -X POST 'http://0.0.0.0:80/get_current_weather' -d '{ "unit": "摄氏度", "location": "上海市" }' | iconv -f utf-8 -t utf-8
函数响应json
HTTP/1.1 200 OK { "temperature": "25", "unit": "摄氏度", "description": "晴朗" }
第二次请求
  • Bash
# 步骤一,获取access_token,替换下列示例中的API Key与Secret Key curl 'https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=[API Key]&client_secret=[Secret Key]' # 步骤二,调用本文API,使用步骤一获取的access_token,替换下列示例中的”调用接口获取的access_token“ curl -X POST 'https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/ernie-3.5-8k-preview?access_token=[步骤一调用接口获取的access_token]' -d '{ "messages": [ {"role":"user","content":"上海市今天天气如何?"}, "}}, "}], "functions": [ , "unit": { "type": "string", "enum": ["摄氏度", "华氏度"] } }, "required": ["location"] } }, , "exchange": { "type": "string", "enum": ["纳斯达克", "上海证券交易所","香港证券交易所"] } }, "required": ["company", "exchange"] }, "responses": { "type": "object", "properties": { "price": { "type": "int", "description": "当日股票价格" }, "unit": { "type": "string", "enum": ["人民币", "美元","港币"], "description": "股票价格货币类型" }, "change": { "type": "string", "description": "当日股票价格变化,如下跌3%,上涨0.5%" } } } } ], "stream":true }' | iconv -f utf-8 -t utf-8
第二次响应 json
HTTP/1.1 200 OK Date: Mon, 12 Apr 2021 06:27:55 GMT Content-Type: text/event-stream;charset=utf-8 Cache-Control: no-cache Statement: AI-generated data: {"id":"as-kf6e9thk0f","object":"chat.completion","created":,"sentence_id":0,"is_end":false,"is_truncated":false,"result":"上海市今天天气是:","need_clear_history":false,"usage":{"prompt_tokens":26,"completion_tokens":8,"total_tokens":34}} data: {"id":"as-kf6e9thk0f","object":"chat.completion","created":,"sentence_id":1,"is_end":false,"is_truncated":false,"result":"气温25摄氏度,晴朗。","need_clear_history":false,"usage":{"prompt_tokens":26,"completion_tokens":8,"total_tokens":42}} data: {"id":"as-kf6e9thk0f","object":"chat.completion","created":,"sentence_id":2,"is_end":true,"is_truncated":false,"result":"","need_clear_history":false,"usage":{"prompt_tokens":26,"completion_tokens":0,"total_tokens":42}}

function call示例(多轮)

第一次请求
  • Bash
# 步骤一,获取access_token,替换下列示例中的API Key与Secret Key curl 'https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=[API Key]&client_secret=[Secret Key]' # 步骤二,调用本文API,使用步骤一获取的access_token,替换下列示例中的”调用接口获取的access_token“ curl -XPOST https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/ernie-3.5-8k-preview?access_token=[步骤一调用接口获取的access_token] -d '{ "messages": [ { "role": "user", "content": "上海市今天天气如何?" }, " } }, " }, { "role": "assistant", "content": "上海市今天天气是:气温25摄氏度,晴朗。" }, { "role": "user", "content": "北京市今天天气如何?" } ], "functions": [ , "unit": { "type": "string", "enum": ["摄氏度", "华氏度"] } }, "required": ["location"] } }, , "exchange": { "type": "string", "enum": ["纳斯达克", "上海证券交易所","香港证券交易所"] } }, "required": ["company", "exchange"] }, "responses": { "type": "object", "properties": { "price": { "type": "int", "description": "当日股票价格" }, "unit": { "type": "string", "enum": ["人民币", "美元","港币"], "description": "股票价格货币类型" }, "change": { "type": "string", "description": "当日股票价格变化,如下跌3%,上涨0.5%" } } }, "examples": [ {"role":"user","content":"What is the weather like in Boston?"}, "}}, "} ] } ], "stream":true, "tool_choice": } }' | iconv -f utf-8 -t utf-8
第一次响应
  • json
data: "},"finish_reason":"function_call","usage":{"prompt_tokens":43,"completion_tokens":0,"total_tokens":43}}
函数调用
  • Bash
curl -XPOST http://0.0.0.0:80/get_current_weather -d '{ "unit": "摄氏度", "location": "北京市" }' | iconv -f utf-8 -t utf-8
函数响应
  • json
{ "temperature": "-1", "unit": "摄氏度", "description": "大雪" }
第二次请求

​​​​​Bash 

# 步骤一,获取access_token,替换下列示例中的API Key与Secret Key curl 'https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=[API Key]&client_secret=[Secret Key]' # 步骤二,调用本文API,使用步骤一获取的access_token,替换下列示例中的”调用接口获取的access_token“ curl -XPOST https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/ernie-3.5-8k-preview?access_token=[步骤一调用接口获取的access_token] -d '{ "messages": [ { "role": "user", "content": "上海市今天天气如何?" }, " } }, " }, { "role": "assistant", "content": "上海市今天天气是:气温25摄氏度,晴朗。" }, { "role": "user", "content": "北京市今天天气如何?" }, " } }, " } ], "functions": [ , "unit": { "type": "string", "enum": ["摄氏度", "华氏度"] } }, "required": ["location"] } }, , "exchange": { "type": "string", "enum": ["纳斯达克", "上海证券交易所","香港证券交易所"] } }, "required": ["company", "exchange"] }, "responses": { "type": "object", "properties": { "price": { "type": "int", "description": "当日股票价格" }, "unit": { "type": "string", "enum": ["人民币", "美元","港币"], "description": "股票价格货币类型" }, "change": { "type": "string", "description": "当日股票价格变化,如下跌3%,上涨0.5%" } } }, "examples": [ [ {"role":"user","content":"What is the weather like in Boston?"}, "}} ], [ {"role":"user","content":"你的名字是什么?"}, {"role": "assistant", "content": null, "function_call": {"name": "", "arguments": "{}", "thoughts":"我无需调用任何工具"}} ] ] } ], "stream":true, "tool_choice": } }' | iconv -f utf-8 -t utf-8
第二次响应
  • json
data: {"id":"as-jp2fqncxhk","object":"chat.completion","created":,"sentence_id":0,"is_end":false,"is_truncated":false,"result":"根据天气预报,北京市","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":62,"completion_tokens":0,"total_tokens":62}} data: {"id":"as-jp2fqncxhk","object":"chat.completion","created":,"sentence_id":1,"is_end":false,"is_truncated":false,"result":"今天天气是:气温-1摄氏度,大雪。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":62,"completion_tokens":0,"total_tokens":62}} data: {"id":"as-jp2fqncxhk","object":"chat.completion","created":,"sentence_id":2,"is_end":false,"is_truncated":false,"result":"如果您需要了解更多天气信息或有其他问题,请随时告诉我。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":62,"completion_tokens":0,"total_tokens":62}} data: {"id":"as-jp2fqncxhk","object":"chat.completion","created":,"sentence_id":3,"is_end":true,"is_truncated":false,"result":"","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":62,"completion_tokens":31,"total_tokens":93}}

如果请求错误,服务器返回的JSON文本包含以下参数。

名称 描述 error_code 错误码 error_msg 错误描述信息,帮助理解和解决发生的错误

例如Access Token失效返回以下内容,需要重新获取新的Access Token再次请求。

{ “error_code”: 110, “error_msg”: “Access token invalid or no longer valid” }

千帆大模型平台相关错误码,请查看错误码说明。

文章来源于互联网:文心一言api开发者文档,python版ERNIE-3.5-8K-Preview模型调用方法

相关推荐: 百度文心一言 java 支持流式输出,Springboot+ sse的demo

参考:GitHub – mmciel/wenxin-api-java: 百度文心一言Java库,支持问答和对话,支持流式输出和同步输出。提供SpringBoot调用样例。提供拓展能力。 1、依赖 com.baidu.aipjava-sdk4.16.18 2、配…





































































































































小讯
上一篇 2026-04-25 19:06
下一篇 2026-04-25 19:04

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/273355.html