百度文心一言API4.0 Python调用ERNIE-4.0-8K详细教程_ernie-4.0-8k-0104

ERNIE 4.0是百度自研的旗舰级超大规模⼤语⾔模型，相较ERNIE 3.5实现了模型能力全面升级，广泛适用于各领域复杂任务场景；支持自动对接百度搜索插件，保障问答信息时效，支持5K tokens输入+2K tokens输出。ERNIE-4.0-8K是模型的一个版本，本文介绍了相关API及使用。

创建chat

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

注意事项

• 本文API，支持2种鉴权方式。不同鉴权方式，调用方式不同，使用Header、Query参数不同，详见本文请求说明。开发者可以选择以下任一种方式进行鉴权。

  • 访问凭证access_token鉴权
  • 基于安全认证AK/SK进行签名计算鉴权
• 本文API对应的token和字符数限制，请参考本文参数messages说明。

在线调试

百度智能云千帆提供了 API在线调试平台-示例代码 ，用于帮助开发者调试接口，平台集成快速检索、查看开发文档、查看在线调用的请求内容和返回结果、复制和下载示例代码等功能，简单易用，更多内容请查看API在线调试介绍。

请求说明

基本信息

请求地址： https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/completions_pro

请求方式： POST

Header参数

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

• 访问凭证access_token鉴权

• 基于安全认证AK/SK进行签名计算鉴权

Query参数

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

• 访问凭证access_token鉴权

Body参数

message说明

响应说明

响应头Header参数

响应体参数

search_info说明

search_result说明

usage说明

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

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

示例

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

请求示例（单轮）

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/completions_pro?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()

响应示例（单轮）

HTTP/1.1 200 OK
Date: Thu, 23 Mar 2023 03:12:03 GMT
Content-Type: application/json;charset=utf-8
Statement: AI-generated
X-Ratelimit-Limit-Requests: 120
X-Ratelimit-Limit-Tokens: 120000
X-Ratelimit-Remaining-Requests: 119
X-Ratelimit-Remaining-Tokens: 119998
 
{
  "id": "as-fg4g836x8n",
  "object": "chat.completion",
  "created": 1709716601,
  "result": "北京，简称“京”，古称燕京、北平，中华民族的发祥地之一，是中华人民共和国首都、直辖市、国家中心城市、超大城市，也是国务院批复确定的中国政治中心、文化中心、国际交往中心、科技创新中心，中国历史文化名城和古都之一，世界一线城市。\n\n北京被世界城市研究机构评为世界一线城市，联合国报告指出北京市人类发展指数居中国城市第二位。北京市成功举办夏奥会与冬奥会，成为全世界第一个“双奥之城”。北京有着3000余年的建城史和850余年的建都史，是全球拥有世界遗产（7处）最多的城市。\n\n北京是一个充满活力和创新精神的城市，也是中国传统文化与现代文明的交汇点。在这里，你可以看到古老的四合院、传统的胡同、雄伟的长城和现代化的高楼大厦交相辉映。此外，北京还拥有丰富的美食文化，如烤鸭、炸酱面等，以及各种传统艺术表演，如京剧、相声等。\n\n总的来说，北京是一个充满魅力和活力的城市，无论你是历史爱好者、美食家还是现代都市人，都能在这里找到属于自己的乐趣和归属感。",
  "is_truncated": false,
  "need_clear_history": false,
  "finish_reason": "normal",
  "usage": {
    "prompt_tokens": 2,
    "completion_tokens": 221,
    "total_tokens": 223
  }
}

请求示例（多轮）

# 步骤一，获取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/completions_pro?access_token=[步骤一调用接口获取的access_token]' -d '{
  "messages": [
    {"role":"user","content":"介绍一下北京"},
    {"role":"assistant","content":"北京，简称“京”，古称燕京、北平，中华民族的发祥地之一，是中华人民共和国首都、直辖市、国家中心城市、超大城市，也是国务院批复确定的中国政治中心、文化中心、国际交往中心、科技创新中心，中国历史文化名城和古都之一，世界一线城市。\n\n北京被世界城市研究机构评为世界一线城市，联合国报告指出北京市人类发展指数居中国城市第二位。北京市成功举办夏奥会与冬奥会，成为全世界第一个“双奥之城”。北京有着3000余年的建城史和850余年的建都史，是全球拥有世界遗产（7处）最多的城市。\n\n北京是一个充满活力和创新精神的城市，也是中国传统文化与现代文明的交汇点。在这里，你可以看到古老的四合院、传统的胡同、雄伟的长城和现代化的高楼大厦交相辉映。此外，北京还拥有丰富的美食文化，如烤鸭、炸酱面等，以及各种传统艺术表演，如京剧、相声等。\n\n总的来说，北京是一个充满魅力和活力的城市，无论你是历史爱好者、美食家还是现代都市人，都能在这里找到属于自己的乐趣和归属感。"},
    {"role":"user","content": "我在上海，周末可以去哪里玩？"},
    {"role":"assistant","content": "上海是一个充满活力和文化氛围的城市，有很多适合周末游玩的地方。以下是几个值得推荐的地方：\n\n1. 上海科技馆：上海科技馆是中国大陆最大的科技馆之一，有许多互动展览和科学实验室，可以让您了解科技的发展历史和最新成果。\n2. 上海博物馆：上海博物馆是一座集艺术、历史和文化于一体的博物馆，有许多精美的艺术品和文物，可以让您深入了解中国和世界的文化历史。\n3. 外滩：外滩是上海的标志性景点之一，有许多高楼大厦和繁华的商业街区，是欣赏黄浦江美景和城市风貌的好去处。\n4. 上海迪士尼乐园：上海迪士尼乐园是世界上最大的迪士尼主题公园之一，有许多精彩的游乐项目和演出，可以让您尽情享受娱乐和欢乐。\n5. 上海野生动物园：上海野生动物园是一个以自然保护为主题的野生动物园，有许多珍稀动物和植物，可以让您近距离接触大自然。\n\n这些地方都是上海周末游玩的好去处，可以根据自己的兴趣和需求选择合适的行程。"},
    {"role":"user","content": "上海有哪些美食"}
  ]
}'  | iconv -f utf-8 -t utf-8

响应示例（多轮）

HTTP/1.1 200 OK
Date: Wed, 06 Mar 2024 09:18:36 GMT
Content-Type: application/json;charset=utf-8
Statement: AI-generated
X-Ratelimit-Limit-Requests: 120
X-Ratelimit-Limit-Tokens: 120000
X-Ratelimit-Remaining-Requests: 119
X-Ratelimit-Remaining-Tokens: 119583
 
{
  "id": "as-qasge7vntb",
  "object": "chat.completion",
  "created": 1709716716,
  "result": "上海的美食种类繁多，其中包括一些著名的特色小吃。以下是一些具有代表性的上海美食：\n\n1. 生煎：生煎起源于元代，清朝时逐渐在上海开始流行，是用淀粉水制成的，当地人称为生煎馒头。\n2. 上海酱鸭：上海酱鸭突出了一个浓油赤酱的特点。其味悠远，脆中带嫩、辣中带麻、麻中带甜、甜而不腻。香味入骨，吃了就不会再忘记那股香味。\n3. 蟹壳黄：蟹壳黄又叫做小麻糕，作为上海的特色小吃之一，其馅包含了荠菜、白糖、葱油、豆沙四种小料。刚出炉时就像一个金黄的蟹壳，因此被称作蟹壳黄。吃上去香脆酥松、油多而不腻。\n4. 小笼包：上海人爱吃小笼包，热乎乎的，蒸的是上海的风味。上海人有时候把小笼包叫做小笼馒头。\n5. 白斩鸡：正宗的白斩鸡是使用三黄鸡制成的，因为在烹制过程中不加任何调味料只使用白水煮制，所以叫做白斩鸡。刚出锅的白斩鸡鸡皮金黄诱人，鸡肉白嫩紧致。稍稍变凉后蘸点酱油香醋吃，鸡皮爽脆、肥而不腻；鸡肉鲜嫩可口，咸甜适中，非常美味。\n6. 锅贴：锅贴绝对是上海人从小吃到大的经典早点。面皮裹着肉馅放油锅边煎上那么一会儿，底部焦硬，一口下去又脆又爽口。面皮绵软，还带点肉汁，直叫人欲罢不能。\n\n此外，排骨年糕、糟田螺、八宝饭等也是上海人非常喜欢的小吃，每个都有其独特的味道和制作工艺。这些美食不仅代表了上海的味道，也体现了上海的历史和文化。",
  "is_truncated": false,
  "need_clear_history": false,
  "finish_reason": "normal",
  "usage": {
    "prompt_tokens": 417,
    "completion_tokens": 365,
    "total_tokens": 782
  }
}

请求示例（流式）

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/completions_pro?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()

响应示例（流式）

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
X-Ratelimit-Limit-Requests: 120 
X-Ratelimit-Limit-Tokens: 120000
X-Ratelimit-Remaining-Requests: 119 
X-Ratelimit-Remaining-Tokens: 119995
 
data: {"id":"as-vb0m37ti8y","object":"chat.completion","created":1709089502,"sentence_id":0,"is_end":false,"is_truncated":false,"result":"当然可以，","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":5,"completion_tokens":2,"total_tokens":7}}
 
data: {"id":"as-vb0m37ti8y","object":"chat.completion","created":1709089504,"sentence_id":1,"is_end":false,"is_truncated":false,"result":"以下是一些建议的自驾游路线，它们涵盖了各种不同的风景和文化体验：\n\n1. **西安-敦煌历史文化之旅**：\n\n\n\t* 路线：西安","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":5,"completion_tokens":2,"total_tokens":7}}
 
data: {"id":"as-vb0m37ti8y","object":"chat.completion","created":1709089506,"sentence_id":2,"is_end":false,"is_truncated":false,"result":" - 天水 - 兰州 - 嘉峪关 - 敦煌\n\t* 特点：此路线让您领略到中国西北的丰富历史文化。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":5,"completion_tokens":2,"total_tokens":7}}
 
data: {"id":"as-vb0m37ti8y","object":"chat.completion","created":1709089508,"sentence_id":3,"is_end":false,"is_truncated":false,"result":"您可以参观西安的兵马俑、大雁塔，体验兰州的黄河风情，以及在敦煌欣赏壮丽的莫高窟。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":5,"completion_tokens":2,"total_tokens":7}}
 
data: {"id":"as-vb0m37ti8y","object":"chat.completion","created":1709089511,"sentence_id":4,"is_end":false,"is_truncated":false,"result":"\n2. **海南环岛热带风情游**：\n\n\n\t* 路线：海口 - 三亚 - 陵水 - 万宁 - 文昌 - 海","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":5,"completion_tokens":2,"total_tokens":7}}
 
data: {"id":"as-vb0m37ti8y","object":"chat.completion","created":1709089512,"sentence_id":5,"is_end":false,"is_truncated":false,"result":"口\n\t* 特点：海南岛是中国唯一的黎族聚居区，这里有独特的热带风情、美丽的海滩和丰富的水果。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":5,"completion_tokens":153,"total_tokens":158}}
 
data: {"id":"as-vb0m37ti8y","object":"chat.completion","created":1709089513,"sentence_id":6,"is_end":false,"is_truncated":false,"result":"您可以在三亚享受阳光沙滩，品尝当地美食，感受海南的悠闲生活。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":5,"completion_tokens":153,"total_tokens":158}}
 
data: {"id":"as-vb0m37ti8y","object":"chat.completion","created":1709089516,"sentence_id":7,"is_end":false,"is_truncated":false,"result":"\n3. **穿越阿里大北线**：\n\n\n\t* 路线：成都 - 广元 - 汉中 - 西安 - 延安 - 银川 -","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":5,"completion_tokens":153,"total_tokens":158}}
 
data: {"id":"as-vb0m37ti8y","object":"chat.completion","created":1709089518,"sentence_id":8,"is_end":false,"is_truncated":false,"result":" 阿拉善左旗 - 额济纳旗 - 嘉峪关 - 敦煌\n\t* 特点：这是一条充满挑战的自驾路线，穿越了中国","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":5,"completion_tokens":153,"total_tokens":158}}
 
data: {"id":"as-vb0m37ti8y","object":"chat.completion","created":1709089519,"sentence_id":9,"is_end":false,"is_truncated":false,"result":"的西部。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":5,"completion_tokens":239,"total_tokens":244}}
 
data: {"id":"as-vb0m37ti8y","object":"chat.completion","created":1709089519,"sentence_id":10,"is_end":false,"is_truncated":false,"result":"您将经过壮观的沙漠、神秘的戈壁和古老的丝绸之路遗址。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":5,"completion_tokens":239,"total_tokens":244}}
 
data: {"id":"as-vb0m37ti8y","object":"chat.completion","created":1709089520,"sentence_id":11,"is_end":false,"is_truncated":false,"result":"此路线适合喜欢探险和寻求不同体验的旅行者。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":5,"completion_tokens":239,"total_tokens":244}}
 
data: {"id":"as-vb0m37ti8y","object":"chat.completion","created":1709089523,"sentence_id":12,"is_end":false,"is_truncated":false,"result":"\n4. **寻找北方净土 - 阿尔山自驾之旅**：\n\n\n\t* 路线：北京 - 张家口 - 张北 - 太仆寺旗","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":5,"completion_tokens":239,"total_tokens":244}}
 
data: {"id":"as-vb0m37ti8y","object":"chat.completion","created":1709089525,"sentence_id":13,"is_end":false,"is_truncated":false,"result":" - 锡林浩特 - 东乌珠穆沁旗 - 满都湖宝拉格 - 宝格达林场 - 五岔沟 - 阿尔山 -","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":5,"completion_tokens":239,"total_tokens":244}}
 
data: {"id":"as-vb0m37ti8y","object":"chat.completion","created":1709089527,"sentence_id":14,"is_end":false,"is_truncated":false,"result":" 伊尔施 - 新巴尔虎右旗 - 满洲里 - 北京\n\t* 特点：此路线带您穿越中国北方的草原和森林，抵达","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":5,"completion_tokens":239,"total_tokens":244}}
 
data: {"id":"as-vb0m37ti8y","object":"chat.completion","created":1709089527,"sentence_id":15,"is_end":false,"is_truncated":false,"result":"风景如画的阿尔山。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":5,"completion_tokens":239,"total_tokens":244}}
 
data: {"id":"as-vb0m37ti8y","object":"chat.completion","created":1709089528,"sentence_id":16,"is_end":false,"is_truncated":false,"result":"您可以在这里欣赏壮丽的自然风光，体验当地的民俗文化，享受宁静的乡村生活。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":5,"completion_tokens":239,"total_tokens":244}}
 
data: {"id":"as-vb0m37ti8y","object":"chat.completion","created":1709089529,"sentence_id":17,"is_end":false,"is_truncated":false,"result":"\n\n以上路线仅供参考，您可以根据自己的兴趣和时间安排进行调整。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":5,"completion_tokens":239,"total_tokens":244}}
 
data: {"id":"as-vb0m37ti8y","object":"chat.completion","created":1709089531,"sentence_id":18,"is_end":false,"is_truncated":false,"result":"在规划自驾游时，请务必注意道路安全、车辆保养以及当地的天气和交通状况。","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":5,"completion_tokens":239,"total_tokens":244}}
 
data: {"id":"as-vb0m37ti8y","object":"chat.completion","created":1709089531,"sentence_id":19,"is_end":false,"is_truncated":false,"result":"祝您旅途愉快！","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":5,"completion_tokens":239,"total_tokens":244}}
 
data: {"id":"as-vb0m37ti8y","object":"chat.completion","created":1709089531,"sentence_id":20,"is_end":true,"is_truncated":false,"result":"","need_clear_history":false,"finish_reason":"normal","usage":{"prompt_tokens":5,"completion_tokens":420,"total_tokens":425}}

错误码

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

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

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