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

见贤思齐

ERNIE3.5是百度自研的旗舰级大规模⼤语⾔模型，覆盖海量中英文语料，具有强大的通用能力，可满足绝大部分对话问答、创作生成、插件应用场景要求；支持自动对接百度搜索插件，保障问答信息时效。本文介绍了ERNIE-3.5-8K-Preview相关API。创建chat调用本接口，发起一次对话请求。注意事项本文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请求方式： OSTHeader参数根据不同鉴权方式，查看对应Header参数。访问凭证access_token鉴权名称类型必填描述Content-Typestring是固定值application/json基于安全认证AK/SK进行签名计算鉴权名称类型必填描述Content-Typestring是固定值application/jsonx-bce-datestring否当前时间，遵循ISO8601规范，格式如2016-04-06T08:23:49ZAuthorizationstring是用于验证请求合法性的认证信息，更多内容请参考鉴权认证机制，签名工具可参考IAM签名工具Query参数只有访问凭证access_token鉴权方式，需使用Query参数。访问凭证access_token鉴权名称类型必填描述access_tokenstring是通过APIKey和SecretKey获取的access_token，参考AccessToken获取Body参数名称类型必填描述messagesList(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个字符，且不能超过5120tokensfunctionsList(function)否一个可触发函数的描述列表，说明：（1）支持的function数量无限制（2）长度限制，message中的content总长度、functions和system字段总内容不能超过20000个字符，且不能超过5120tokenstemperaturefloat否说明：（1）较高的数值会使输出更加随机，而较低的数值会使其更加集中和确定（2）默认0.8，范围(0,1.0]，不能为0top_pfloat否说明：（1）影响输出文本的多样性，取值越大，生成文本的多样性越强（2）默认0.8，取值范围[0,1.0]penalty_scorefloat否通过对已生成的token增加惩罚，减少重复生成的现象。说明：（1）值越大表示惩罚越大（2）默认1.0，取值范围：[1.0,2.0]streambool否是否以流式接口的形式返回数据，默认falsesystemstring否模型人设，主要用于人设设定，例如，你是xxx公司制作的AI助手，说明：（1）长度限制，message中的content总长度、functions和system字段总内容不能超过20000个字符，且不能超过5120tokens（2）如果同时使用system和functions，可能暂无法保证使用效果，持续进行优化stopList(string)否生成停止标识，当模型生成结果以stop中某个元素结尾时，停止文本生成。说明：（1）每个元素长度不超过20字符（2）最多4个元素disable_searchbool否是否强制关闭实时搜索功能，默认false，表示不关闭enable_citationbool否是否开启上角标返回，说明：（1）开启后，有概率触发搜索溯源信息search_info，search_info内容见响应参数介绍（2）默认false，不开启enable_tracebool否是否返回搜索溯源信息，说明：（1）如果开启，在触发了搜索增强的场景下，会返回搜索溯源信息search_info，search_info内容见响应参数介绍（2）默认false，表示不返回max_output_tokensint否指定模型最大输出token数，说明：（1）如果设置此参数，范围[2,2048]（2）如果不设置此参数，最大输出token数为2048response_formatstring否指定响应内容的格式，说明：（1）可选值：·json_object：以json格式返回，可能出现不满足效果情况·text：以文本格式返回（2）如果不填写参数response_format值，默认为textuser_idstring否表示最终用户的唯一标识符tool_choicetool_choice否在函数调用场景下，提示大模型选择指定的函数（非强制），说明：指定的函数名必须在functions中存在message说明名称类型必填描述rolestring是当前支持以下：user:表示用户assistant:表示对话助手function:表示函数contentstring是对话内容，说明：（1）当前message存在function_call，且role="assistant"时可以为空，其他场景不能为空（2）最后一个message对应的content不能为blank字符，包含空格、"\n"、“\r”、“\f”等（3）当role为function，content为JSON格式，效果可能更好namestring否message作者；当role=function时，必填，且是响应内容中function_call中的namefunction_callfunction_call否函数调用，functioncall场景下第一轮对话的返回，第二轮对话作为历史信息在message中传入function说明functions中function说明如下名称类型必填描述namestring是函数名descriptionstring是函数描述parametersobject是函数请求参数，说明：（1）JSONSchema格式，参考JSONSchema描述（2）如果函数没有请求参数，parameters值格式如下：{"type":"object","properties":{}}responsesobject否函数响应参数，JSONSchema格式，参考JSONSchema描述examplesList(List(example))否function调用的一些历史示例，说明：（1）可以提供正例（正常触发）和反例（无需触发）的example·正例：从历史请求数据中获取·反例：      当role=user，不会触发请求的query      当role=assistant，有固定的格式。function_call的name为空，arguments是空对象:"{}"，thought可以填固定的:"我不需要调用任何工具"（2）兼容之前的List(example)格式example说明名称类型必填描述rolestring是当前支持以下：user:表示用户assistant:表示对话助手function:表示函数contentstring是对话内容，说明：（1）当前message存在function_call，且role="assistant"时可以为空，其他场景不能为空（2）最后一个message对应的content不能为blank字符，包含空格、"\n"、“\r”、“\f”等namestring否message作者；当role=function时，必填，且是响应内容中function_call中的namefunction_callfunction_call否函数调用，functioncall场景下第一轮对话的返回，第二轮对话作为历史信息在message中传入function_call说明名称类型必填描述namestring是触发的function名argumentsstring是请求参数thoughtsstring否模型思考过程tool_choice说明名称类型必填描述typestring是指定工具类型，functionfunctionfunction是指定要使用的函数function说明tool_choice中function说明如下名称类型必填描述namestring是指定要使用的函数名响应说明响应头Header参数部分参数如下。名称描述X-Ratelimit-Limit-Requests一分钟内允许的最大请求次数X-Ratelimit-Limit-Tokens一分钟内允许的最大tokens消耗，包含输入tokens和输出tokensX-Ratelimit-Remaining-Requests达到RPM速率限制前，剩余可发送的请求数配额，如果配额用完，将会在0-60s后刷新X-Ratelimit-Remaining-Tokens达到TPM速率限制前，剩余可消耗的tokens数配额，如果配额用完，将会在0-60s后刷新响应体参数名称类型描述idstring本轮对话的idobjectstring回包类型chat.completion：多轮对话返回createdint时间戳sentence_idint表示当前子句的序号。只有在流式接口模式下会返回该字段is_endbool表示当前子句是否是最后一句。只有在流式接口模式下会返回该字段is_truncatedbool当前生成的结果是否被截断finish_reasonstring输出内容标识，说明：·normal：输出内容完全由大模型生成，未触发截断、替换·stop：输出结果命中入参stop中指定的字段后被截断·length：达到了最大的token数，根据EB返回结果is_truncated来截断·content_filter：输出内容被截断、兜底、替换为**等·function_call：调用了funtioncall功能search_infosearch_info搜索数据，当请求参数enable_citation或enable_trace为true，并且触发搜索时，会返回该字段resultstring对话返回结果need_clear_historybool表示用户输入是否存在安全风险，是否关闭当前会话，清理历史会话信息·true：是，表示用户输入存在安全风险，建议关闭当前会话，清理历史会话信息·false：否，表示用户输入无安全风险flagint说明：·0：正常返回·其他：非正常ban_roundint当need_clear_history为true时，此字段会告知第几轮对话有敏感信息，如果是当前问题，ban_round=-1usageusagetoken统计信息function_callfunction_call由模型生成的函数调用，包含函数名称，和调用参数search_info说明名称类型描述search_resultsList(search_result)搜索结果列表search_result说明名称类型描述indexint序号urlstring搜索结果URLtitlestring搜索结果usage说明名称类型描述prompt_tokensint问题tokens数completion_tokensint回答tokens数total_tokensinttokens总数pluginsList(plugin_usage)plugin消耗的tokensplugin_usage说明名称类型描述namestringplugin名称，chatFile：chatfile插件消耗的tokensparse_tokensint解析文档tokensabstract_tokensint摘要文档tokenssearch_tokensint检索文档tokenstotal_tokensint总tokensfunction_call说明名称类型描述namestring触发的function名thoughtsstring模型思考过程argumentsstring请求参数注意 ：同步模式和流式模式，响应参数返回不同，详细内容参考示例描述。同步模式下，响应参数为以上字段的完整json包。流式模式下，各字段的响应参数为data:{响应参数}。示例以访问凭证access_token鉴权方式为例，说明如何调用API，示例如下。请求示例（单轮）pythonimportrequestsimportjsondefget_access_token():"""使用APIKey，SecretKey获取access_token，替换下列示例中的应用APIKey、应用SecretKey"""url="https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=[应用APIKey]&client_secret=[应用SecretKey]"payload=json.dumps("")headers={'Content-Type':'application/json','Accept':'application/json'}response=requests.request("POST",url,headers=headers,data=payload)returnresponse.json().get("access_token")defmain():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()响应示例（单轮）jsonHTTP/1.1200OKDate:Fri,19Jan202408:49:13GMTContent-Type:application/json;charset=utf-8Statement:AI-generatedX-Ratelimit-Limit-Requests:300X-Ratelimit-Limit-Tokens:300000X-Ratelimit-Remaining-Requests:298X-Ratelimit-Remaining-Tokens:299971{"id":"as-61qu1k9xvf","object":"chat.completion","created":1709711333,"result":"你好，请问有什么我可以帮助你的吗？无论你有什么问题或需要帮助，我都会尽力回答和协助你。请随时告诉我你的需求。","is_truncated":false,"need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":1,"completion_tokens":29,"total_tokens":30}}请求示例（多轮）pythonimportrequestsimportjsondefget_access_token():"""使用APIKey，SecretKey获取access_token，替换下列示例中的应用APIKey、应用SecretKey"""url="https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=[应用APIKey]&client_secret=[应用SecretKey]"payload=json.dumps("")headers={'Content-Type':'application/json','Accept':'application/json'}response=requests.request("POST",url,headers=headers,data=payload)returnresponse.json().get("access_token")defmain():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()响应示例（多轮）​​​​​​​jsonHTTP/1.1200OKDate:Wed,28Feb202402:04:30GMTContent-Type:application/json;charset=utf-8Statement:AI-generatedX-Ratelimit-Limit-Requests:300X-Ratelimit-Limit-Tokens:300000X-Ratelimit-Remaining-Requests:299X-Ratelimit-Remaining-Tokens:299741{"id":"as-g1mtr4p03c","object":"chat.completion","created":1709711455,"result":"上海是一个美食之都，拥有许多独特的地方特色菜肴和小吃。以下是一些上海的美食推荐：\n\n1.生煎包：生煎包是上海的特色小吃之一，底部酥脆，上部松软，馅料鲜美，深受当地人喜爱。\n\n2.南翔小笼包：南翔小笼包是上海的著名特色小吃，皮薄馅嫩，汤汁丰富，味道鲜美，是品尝上海传统美食的必选之一。\n\n3.白斩鸡：白斩鸡是上海菜中的一道经典菜肴，鸡肉鲜嫩多汁，口感滑爽，搭配上调料食用更佳。\n\n4.油条：油条是上海的传统早餐食品之一，外酥里嫩，香气四溢，搭配豆浆或豆腐脑食用更佳。\n\n5.蟹壳黄：蟹壳黄是一种上海传统小吃，因其形似蟹壳而得名，口感香脆，馅料丰富，有甜、咸两种口味可选。\n\n6.咸豆花：咸豆花是上海的传统小吃之一，豆花口感细腻，搭配咸味的调料和配料，味道独特而美味。\n\n除了以上几种美食，上海还有许多其他特色小吃和菜肴，如糖醋排骨、红烧肉、松鼠桂鱼、罗宋汤等。无论您是美食家还是普通游客，都可以在上海找到满足自己味蕾的美食佳肴。","is_truncated":false,"need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":259,"completion_tokens":306,"total_tokens":565}}请求示例（流式）​​​​​​​python​​​​​​​importrequestsimportjsondefget_access_token():"""使用APIKey，SecretKey获取access_token，替换下列示例中的应用APIKey、应用SecretKey"""url="https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=[应用APIKey]&client_secret=[应用SecretKey]"payload=json.dumps("")headers={'Content-Type':'application/json','Accept':'application/json'}response=requests.request("POST",url,headers=headers,data=payload)returnresponse.json().get("access_token")defmain():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)forlineinresponse.iter_lines():print(line.decode("UTF-8"))if__name__=='__main__':main()响应示例（流式）jsonHTTP/1.1200OKDate:Wed,28Feb202402:02:31GMTContent-Type:text/event-stream;charset=utf-8Cache-Control:no-cacheStatement:AI-generatedX-Ratelimit-Limit-Requests:300X-Ratelimit-Limit-Tokens:300000X-Ratelimit-Remaining-Requests:299X-Ratelimit-Remaining-Tokens:299994data:{"id":"as-0gcrii0a9k","object":"chat.completion","created":1709085751,"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":1709085752,"sentence_id":1,"is_end":false,"is_truncated":false,"result":"，以下是一些建议的自驾游路线：\n\n1.**丝绸之路自驾游**：西安出发，经过天水、兰州、嘉峪关","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":1709085752,"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":1709085752,"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":1709085753,"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":1709085754,"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":1709085754,"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":1709085755,"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":1709085756,"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":1709085756,"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":1709085757,"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":1709085757,"sentence_id":11,"is_end":false,"is_truncated":false,"result":"\n\n这些路线各具特色，可以满足不同人群的需求。","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":1709085758,"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":1709085759,"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":1709085759,"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}}functioncall示例（单轮）第一次请求Bash#步骤一，获取access_token，替换下列示例中的APIKey与SecretKeycurl'https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=[APIKey]&client_secret=[SecretKey]'#步骤二，调用本文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":"上海市今天的天气"}],"functions":[{"name":"get_current_weather","description":"获得指定地点的天气","parameters":{"type":"object","properties":{"location":{"type":"string","description":"省，市名，例如：河北省，石家庄"},"unit":{"type":"string","enum":["摄氏度","华氏度"]}},"required":["location"]} },{"name":"get_current_price","description":"获得指定公司的股价","parameters":{"type":"object","properties":{"company":{"type":"string","description":"公司名，例如：腾讯，阿里巴巴"},"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":"WhatistheweatherlikeinBoston?"}, {"role":"assistant","content":null,"function_call":{"name":"get_current_weather","arguments":"{\"location\":\"Boston\"}"}} ], [ {"role":"user","content":"你的名字是什么?"}, {"role":"assistant","content":null,"function_call":{"name":"","arguments":"{}","thoughts":"我无需调用任何工具"}} ]]}],"stream":true,"tool_choice":{"type":"function","function":{"name":"get_current_weather"}}}'|iconv-futf-8-tutf-8第一次响应​​​​​​​jsondata:{"id":"as-rtpw9dcmef","object":"chat.completion","created":1693449832,"sentence_id":0,"is_end":true,"is_truncated":false,"result":"","need_clear_history":false,"function_call":{"name":"get_current_weather","thoughts":"用户提到了天气，需要调用API来获取天气信息。","arguments":"{\"unit\":\"摄氏度\",\"location\":\"上海市\"}"},"usage":{"prompt_tokens":8,"completion_tokens":46,"total_tokens":54}}函数调用Bashcurl-XPOST'http://0.0.0.0:80/get_current_weather'-d'{"unit":"摄氏度","location":"上海市"}'|iconv-futf-8-tutf-8函数响应jsonHTTP/1.1200OK{"temperature":"25","unit":"摄氏度","description":"晴朗"}第二次请求Bash#步骤一，获取access_token，替换下列示例中的APIKey与SecretKeycurl'https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=[APIKey]&client_secret=[SecretKey]'#步骤二，调用本文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":null,"function_call":{"name":"get_current_weather","arguments":"{\"location\":\"上海市\"}"}},{"role":"function","name":"get_current_weather","content":"{\"temperature\":\"25\",\"unit\":\"摄氏度\",\"description\":\"晴朗\"}"}],"functions":[{"name":"get_current_weather","description":"获得指定地点的天气","parameters":{"type":"object","properties":{"location":{"type":"string","description":"省，市名，例如：河北省，石家庄"},"unit":{"type":"string","enum":["摄氏度","华氏度"]}},"required":["location"]} },{"name":"get_current_price","description":"获得指定公司的股价","parameters":{"type":"object","properties":{"company":{"type":"string","description":"公司名，例如：腾讯，阿里巴巴"},"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-futf-8-tutf-8第二次响应 jsonHTTP/1.1200OKDate:Mon,12Apr202106:27:55GMTContent-Type:text/event-stream;charset=utf-8Cache-Control:no-cacheStatement:AI-generateddata:{"id":"as-kf6e9thk0f","object":"chat.completion","created":1693450180,"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":1693450180,"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":1693450180,"sentence_id":2,"is_end":true,"is_truncated":false,"result":"","need_clear_history":false,"usage":{"prompt_tokens":26,"completion_tokens":0,"total_tokens":42}}functioncall示例（多轮）第一次请求Bash#步骤一，获取access_token，替换下列示例中的APIKey与SecretKeycurl'https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=[APIKey]&client_secret=[SecretKey]'#步骤二，调用本文API，使用步骤一获取的access_token，替换下列示例中的”调用接口获取的access_token“curl-XPOSThttps://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":null,"function_call":{"name":"get_current_weather","arguments":"{\"location\":\"上海市\"}"}},{"role":"function","name":"get_current_weather","content":"{\"temperature\":\"25\",\"unit\":\"摄氏度\",\"description\":\"晴朗\"}"},{"role":"assistant","content":"上海市今天天气是：气温25摄氏度，晴朗。"},{"role":"user","content":"北京市今天天气如何？"}],"functions":[{"name":"get_current_weather","description":"获得指定地点的天气","parameters":{"type":"object","properties":{"location":{"type":"string","description":"省，市名，例如：河北省，石家庄"},"unit":{"type":"string","enum":["摄氏度","华氏度"]}},"required":["location"]}},{"name":"get_current_price","description":"获得指定公司的股价","parameters":{"type":"object","properties":{"company":{"type":"string","description":"公司名，例如：腾讯，阿里巴巴"},"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":"WhatistheweatherlikeinBoston?"},{"role":"assistant","content":null,"function_call":{"name":"get_current_weather","arguments":"{\"location\":\"Boston\"}"}},{"role":"function","name":"get_current_weather","content":"{\"temperature\":\"25\",\"unit\":\"centigrade\",\"description\":\"cloud\"}"}]}],"stream":true,"tool_choice":{"type":"function","function":{"name":"get_current_weather"}}}'|iconv-futf-8-tutf-8第一次响应jsondata:{"id":"as-cp6rrapzdp","object":"chat.completion","created":1701421831,"sentence_id":0,"is_end":true,"is_truncated":false,"result":"","need_clear_history":false,"function_call":{"name":"get_current_weather","thoughts":"用户询问了北京市今天的天气，我需要使用get_current_weather工具来获取相关信息。","arguments":"{\"location\":\"北京市\"}"},"finish_reason":"function_call","usage":{"prompt_tokens":43,"completion_tokens":0,"total_tokens":43}}函数调用Bashcurl-XPOSThttp://0.0.0.0:80/get_current_weather-d'{"unit":"摄氏度","location":"北京市"}'|iconv-futf-8-tutf-8函数响应json{"temperature":"-1","unit":"摄氏度","description":"大雪"}第二次请求​​​​​Bash #步骤一，获取access_token，替换下列示例中的APIKey与SecretKeycurl'https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=[APIKey]&client_secret=[SecretKey]'#步骤二，调用本文API，使用步骤一获取的access_token，替换下列示例中的”调用接口获取的access_token“curl-XPOSThttps://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":null,"function_call":{"name":"get_current_weather","arguments":"{\"location\":\"上海市\"}"}},{"role":"function","name":"get_current_weather","content":"{\"temperature\":\"25\",\"unit\":\"摄氏度\",\"description\":\"晴朗\"}"},{"role":"assistant","content":"上海市今天天气是：气温25摄氏度，晴朗。"},{"role":"user","content":"北京市今天天气如何？"},{"role":"assistant","content":null,"function_call":{"name":"get_current_weather","arguments":"{\"location\":\"北京市\"}"}},{"role":"function","name":"get_current_weather","content":"{\"temperature\":\"-1\",\"unit\":\"摄氏度\",\"description\":\"大雪\"}"}],"functions":[{"name":"get_current_weather","description":"获得指定地点的天气","parameters":{"type":"object","properties":{"location":{"type":"string","description":"省，市名，例如：河北省，石家庄"},"unit":{"type":"string","enum":["摄氏度","华氏度"]}},"required":["location"]}},{"name":"get_current_price","description":"获得指定公司的股价","parameters":{"type":"object","properties":{"company":{"type":"string","description":"公司名，例如：腾讯，阿里巴巴"},"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":"WhatistheweatherlikeinBoston?"},{"role":"assistant","content":null,"function_call":{"name":"get_current_weather","arguments":"{\"location\":\"Boston\"}"}}],[{"role":"user","content":"你的名字是什么?"},{"role":"assistant","content":null,"function_call":{"name":"","arguments":"{}","thoughts":"我无需调用任何工具"}}]]}],"stream":true,"tool_choice":{"type":"function","function":{"name":"get_current_weather"}}}'|iconv-futf-8-tutf-8第二次响应jsondata:{"id":"as-jp2fqncxhk","object":"chat.completion","created":1701422332,"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":1701422333,"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":1701422333,"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":1701422333,"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错误描述信息，帮助理解和解决发生的错误例如AccessToken失效返回以下内容，需要重新获取新的AccessToken再次请求。{"error_code":110,"error_msg":"Accesstokeninvalidornolongervalid"}千帆大模型平台相关错误码，请查看错误码说明。