BLOOMZ-7B
BLOOMZ-7B是业内知名的⼤语⾔模型,由BigScience研发并开源,能够以46种语⾔和13种编程语⾔输出⽂本。本文介绍了相关API。
功能介绍
调用本接口,发起一次对话请求。
在线调试
平台提供了 API在线调试平台-示例代码 ,用于帮助开发者调试接口,平台集成快速检索、查看开发文档、查看在线调用的请求内容和返回结果、复制和下载示例代码等功能,简单易用,更多内容请查看API在线调试介绍。
SDK调用
使用说明
- 本文内容适用Python、Go、Java和Node.js SDK,SDK调用流程请参考SDK安装及使用流程。
-
本文模型支持不同调用方式,请结合具体使用的模型服务,查看参数使用说明进行调用。
- 指定支持预置服务的模型,使用model参数指定支持预置服务的模型,详见请求参数说明。
- 用户快速部署自行发布的模型服务,需使用参数endpoint,详见请求参数说明。
调用示例(单轮)
- 指定支持预置服务的模型
使用model
字段,指定平台支持预置服务的模型,调用示例如下。
import os
import qianfan
#【推荐】使用安全认证AK/SK鉴权,通过环境变量初始化认证信息
# 替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
os.environ["QIANFAN_ACCESS_KEY"] = "your_iam_ak"
os.environ["QIANFAN_SECRET_KEY"] = "your_iam_sk"
chat_comp = qianfan.ChatCompletion()
# 指定特定模型
resp = chat_comp.do(model="BLOOMZ-7B", messages=[{
"role": "user",
"content": "你好"
}])
print(resp["body"])
package main
import (
"context"
"fmt"
"os"
"github.com/baidubce/bce-qianfan-sdk/go/qianfan"
)
func main() {
// 使用安全认证AK/SK鉴权,通过环境变量初始化;替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
os.Setenv("QIANFAN_ACCESS_KEY", "your_iam_ak")
os.Setenv("QIANFAN_SECRET_KEY", "your_iam_sk")
// 指定特定模型
chat := qianfan.NewChatCompletion(
qianfan.WithModel("BLOOMZ-7B"),
)
resp, _ := chat.Do(
context.TODO(),
&qianfan.ChatCompletionRequest{
Messages: []qianfan.ChatCompletionMessage{
qianfan.ChatCompletionUserMessage("你好"),
},
},
)
fmt.Println(resp.Result)
}
import com.baidubce.qianfan.Qianfan;
import com.baidubce.qianfan.model.chat.ChatResponse;
public class Demo {
public static void main(String[] args) {
// 使用安全认证AK/SK鉴权,替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
Qianfan qianfan = new Qianfan("your_iam_ak", "your_iam_sk");
// 指定模型
ChatResponse resp = qianfan.chatCompletion()
.model("BLOOMZ-7B")
.addMessage("user", "你好")
.execute();
System.out.println(resp.getResult());
}
}
import {ChatCompletion, setEnvVariable} from "@baiducloud/qianfan";
// 使用安全认证AK/SK鉴权,通过环境变量初始化;替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
setEnvVariable('QIANFAN_ACCESS_KEY','your_iam_ak');
setEnvVariable('QIANFAN_SECRET_KEY','your_iam_sk');
const client = new ChatCompletion();
async function main() {
const resp = await client.chat({
messages: [
{
role: 'user',
content: '你好',
},
],
}, 'BLOOMZ-7B');
console.log(resp);
}
main();
- 用户自行发布的模型服务
对于用户快速部署自行发布的模型服务,通过使用endpoint
字段进行调用,示例如下。
import os
import qianfan
#【推荐】使用安全认证AK/SK鉴权,通过环境变量初始化认证信息
# 替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
os.environ["QIANFAN_ACCESS_KEY"] = "your_iam_ak"
os.environ["QIANFAN_SECRET_KEY"] = "your_iam_sk"
chat_comp = qianfan.ChatCompletion()
# 使用自行发布的模型
resp = chat_comp.do(endpoint="your_custom_endpoint", messages=[{
"role": "user",
"content": "你好"
}])
# 可以通过resp["body"]获取接口返回的内容
print(resp["body"])
package main
import (
"context"
"fmt"
"os"
"github.com/baidubce/bce-qianfan-sdk/go/qianfan"
)
func main() {
// 使用安全认证AK/SK鉴权,通过环境变量初始化;替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
os.Setenv("QIANFAN_ACCESS_KEY", "your_iam_ak")
os.Setenv("QIANFAN_SECRET_KEY", "your_iam_sk")
// 使用自行发布的模型
chat := qianfan.NewChatCompletion(
qianfan.WithEndpoint("your_endpoint"),
)
resp, _ := chat.Do(
context.TODO(),
&qianfan.ChatCompletionRequest{
Messages: []qianfan.ChatCompletionMessage{
qianfan.ChatCompletionUserMessage("你好"),
},
},
)
fmt.Println(resp.Result)
}
import com.baidubce.qianfan.Qianfan;
import com.baidubce.qianfan.model.chat.ChatResponse;
public class Demo {
public static void main(String[] args) {
// 使用安全认证AK/SK鉴权,替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
Qianfan qianfan = new Qianfan("your_iam_ak", "your_iam_sk");
// 使用自行发布的模型,替换your_custom_endpoint
ChatResponse resp = qianfan.chatCompletion()
.endpoint("your_custom_endpoint")
.addMessage("user", "你好")
.execute();
System.out.println(resp.getResult());
}
}
import {ChatCompletion, setEnvVariable} from "@baiducloud/qianfan";
// 使用安全认证AK/SK鉴权,通过环境变量初始化;替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
setEnvVariable('QIANFAN_ACCESS_KEY','your_iam_ak');
setEnvVariable('QIANFAN_SECRET_KEY','your_iam_sk');
const client = new ChatCompletion({Endpoint: 'your_endpoint'});
async function main() {
const resp = await client.chat({
messages: [
{
role: 'user',
content: '你好',
},
],
});
console.log(resp);
}
main();
返回示例(单轮)
{
'id': 'as-2be7x1q3jj',
'object': 'chat.completion',
'created': 1719045276,
'result': '你好!有什么问题我可以帮助你吗?',
'is_truncated': False,
'need_clear_history': False,
'finish_reason': 'normal',
'usage': {'prompt_tokens': 1, 'completion_tokens': 8, 'total_tokens': 9}
}
你好!有什么问题我可以帮助你吗?
你好!有什么问题我可以帮助你吗?
{
headers: {...},
id: 'as-ddda3r2g3z',
object: 'chat.completion',
created: 1719046855,
result: ' 你好!有什么问题我可以帮助你解答吗?',
is_truncated: false,
need_clear_history: false,
usage: { prompt_tokens: 1, completion_tokens: 10, total_tokens: 11 }
}
调用示例(多轮)
import os
import qianfan
#通过环境变量初始化认证信息
# 【推荐】使用安全认证AK/SK鉴权
# 替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
os.environ["QIANFAN_ACCESS_KEY"] = "your_iam_ak"
os.environ["QIANFAN_SECRET_KEY"] = "your_iam_sk"
chat_comp = qianfan.ChatCompletion()
# 多轮对话
resp = chat_comp.do(model="BLOOMZ-7B", messages=[{
"role": "user",
"content": "你好"
},
{
"role": "assistant",
"content": "你好!很高兴见到你,欢迎问我任何问题。"
},
{
"role": "user",
"content": "介绍下故宫"
},
])
print(resp["body"])
package main
import (
"context"
"fmt"
"os"
"github.com/baidubce/bce-qianfan-sdk/go/qianfan"
)
func main() {
// 使用安全认证AK/SK鉴权,通过环境变量初始化;替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
os.Setenv("QIANFAN_ACCESS_KEY", "your_iam_ak")
os.Setenv("QIANFAN_SECRET_KEY", "your_iam_sk")
// 多轮对话
chat := qianfan.NewChatCompletion(
qianfan.WithModel("BLOOMZ-7B"),
)
resp, _ := chat.Do(
context.TODO(),
&qianfan.ChatCompletionRequest{
Messages: []qianfan.ChatCompletionMessage{
qianfan.ChatCompletionUserMessage("你好!"),
qianfan.ChatCompletionAssistantMessage("你好!有什么我可以帮助你的吗?"),
qianfan.ChatCompletionUserMessage("我在北京,周末可以去哪里玩?"),
},
},
)
fmt.Println(resp.Result)
}
import com.baidubce.qianfan.Qianfan;
import com.baidubce.qianfan.model.chat.ChatResponse;
public class Demo {
public static void main(String[] args) {
// 使用安全认证AK/SK鉴权,替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
Qianfan qianfan = new Qianfan("your_iam_ak", "your_iam_sk");
// 多轮对话
ChatResponse resp = qianfan.chatCompletion()
.model("BLOOMZ-7B")
.addMessage("user", "你好")
.addMessage("assistant", "你好!有什么我可以帮助你的吗?")
.addMessage("user", "介绍下故宫")
.execute();
System.out.println(resp.getResult());
}
}
import {ChatCompletion, setEnvVariable} from "@baiducloud/qianfan";
// 使用安全认证AK/SK鉴权,通过环境变量初始化;替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
setEnvVariable('QIANFAN_ACCESS_KEY','your_iam_ak');
setEnvVariable('QIANFAN_SECRET_KEY','your_iam_sk');
const client = new ChatCompletion();
async function main() {
const resp = await client.chat({
messages: [
{
role: 'user',
content: '你好!',
},
{
role: "assistant",
content: "你好,请问有什么我可以帮助你的吗?"
},
{
role: "user",
"content": "我在北京,周末可以去哪里玩?"
},
],
},'BLOOMZ-7B');
console.log(resp);
}
main();
返回示例(多轮)
{
'id': 'as-8efdkszayy',
'object': 'chat.completion',
'created': 1719045336,
'result': ' 故宫,又称紫禁城,位于中国北京市中心,是明、清两代的皇家宫殿,也是世界上现存规模最大、保存最为完整的木质结构古建筑群之一。故宫始建于明朝永乐四年(1406年),历时14年才基本建成,之后经过多次修缮和扩建,形成了今日的规模。\n\n故宫以它的建筑艺术和丰富的藏品闻名于世。它占地约72万平方米,有大约8707个房间,四周有高10米、长3.5公里的城墙围绕,城外有宽52米的护城河。故宫的建筑分为外朝和内廷两部分,外朝主要用于举行大型的朝会,内廷则是皇帝和皇后的居住地。\n\n故宫不仅是中国古代宫廷建筑的杰出代表,还是中国传统文化的宝库,收藏有大量的文物,包括绘画、书法、陶瓷、铜器等,这些文物不仅展示了中国古代艺术的精髓,也是研究中国历史和文化的重要资料。\n\n1925年,故宫被改为故宫博物院,对外开放,成为展示中国古代艺术和历史的重要场所。如今,它不仅是中国的国家象征之一,也是世界文化遗产之一,每年吸引着来自世界各地的游客前来参观学习。',
'is_truncated': False,
'need_clear_history': False,
'usage': {'prompt_tokens': 15, 'completion_tokens': 263, 'total_tokens': 278}
}
在北京,周末有很多好玩的地方可以选择。这里有一些推荐:
1. **故宫** - 又称紫禁城,是明清两代的皇家宫殿,也是世界上保存最完整、规模最大的木质结构古建筑群。
2. **长城** - 比如八达岭、慕田峪等段落,是中国的象征,也是世界文化遗产之一。
3. **颐和园** - 一座大型皇家园林,以昆明湖和万寿山为基础,以杭州西湖风光为蓝图,结合北方皇家园林的特点而建。
4. **天坛** - 明清两代皇帝祭祀天地之神和祈祷五谷丰收的地方,是中国现存最大的圜丘祈年建筑群。
5. **北京欢乐谷** - 一个大型现代主题公园,有各种游乐设施和表演,适合家庭游玩。
6. **国家大剧院** - 又称“鸟巢”,在这里可以观看到各种高水平的戏剧、歌剧、芭蕾舞等演出。
7. **南锣鼓巷** - 一条充满老北京风情的胡同,有很多特色小店、传统餐馆和文艺咖啡馆。
8. **798艺术区** - 原为国营798厂等电子工业的老厂区所在地,现为艺术家和文化机构的聚集地,有很多艺术展览和创意小店。
9. **什刹海** - 包括前海、后海和西海,是北京城内面积最大、风貌保存最完整的一片历史街区,可以体验老北京的风情。
10. **北京动物园** - 其中的熊猫馆非常受欢迎,可以看到可爱的大熊猫。
根据个人兴趣,可以选择适合自己的去处。北京的交通发达,地铁和公交网络覆盖广泛,出行十分方便。希望你在北京有一个愉快的周末!
故宫,又称紫禁城,位于中国北京市中心,是明、清两代的皇家宫殿,也是世界上现存规模最大、保存最为完整的木质结构古建筑群之一。故宫始建于明朝永乐四年(1406年),到永乐十八年(1420年)基本建成,之后经过多次修缮和扩建,形成了今天的规模。
故宫占地约72万平方米,有大殿、宫殿、馆舍等七百多座建筑物,共计约有9999间半房间。整个故宫按照南北中轴线布局,主要建筑包括太和殿、中和殿、保和殿、乾清宫、交泰殿、坤宁宫等,以及御花园。故宫的建筑风格融合了中国传统宫殿建筑的特点,体现了中国古代建筑艺术的高度成就。
1911年辛亥革命后,清朝灭亡,故宫不再作为皇家宫殿使用。1925年,故宫博物院成立,对外开放,将故宫及其收藏的文物向公众展示。今天,故宫不仅是中国最重要的文化遗产之一,也是世界文化遗产之一,每年吸引着成千上万的游客和学者前来参观和研究。
故宫不仅是中国古代宫廷建筑的杰出代表,还藏有大量的珍贵文物,包括绘画、书法、陶瓷、铜器等各种艺术品,这些文物见证了中国几千年的历史和文化,是研究中国古代历史和文化的重要资料。
{
headers: {...},
id: 'as-d26gvdp0h2',
object: 'chat.completion',
created: 1719046673,
result: ' 在北京,周末可以去很多有趣的地方游玩。这里有一些推荐:\n' +
'\n' +
'1. **故宫** - 又称紫禁城,是中国明、清两代的皇家宫殿,也是世界上最大的宫殿之一,非常值得一游。\n' +
'\n' +
'2. **长城** - 北京周边的长城段落很多,如八达岭、慕田峪、司马台等,可以体验登长城的壮丽景色。\n' +
'\n' +
'3. **颐和园** - 是一座大型皇家园林,以昆明湖和万寿山为基础,以杭州西湖风光为蓝图,结合北方皇家园林的特点而建。\n' +
'\n' +
'4. **天坛** - 明清两代皇帝祭祀“天”和祈求丰收的场所,是中国现存最大的圜丘祈年建筑群。\n' +
'\n' +
'5. **北京欢乐谷** - 一个大型现代主题公园,适合喜欢刺激游乐设施的游客。\n' +
'\n' +
'6. **798艺术区** - 一个充满现代艺术气息的地方,有很多画廊、艺术工作室和创意小店。\n' +
'\n' +
'7. **什刹海** - 包括前海、后海和西海,是北京城内面积最大、风貌保存最完整的一片历史街区,可以体验老北京的风情。\n' +
'\n' +
'8. **国家大剧院** - 位于天安门广场西侧,外形似水中央光卵的巨大建筑,晚上的灯光秀非常美丽,也是欣赏高水平艺术表演的好地方。\n' +
'\n' +
'9. **北京动物园** - 如果您对动物感兴趣,北京动物园是个不错的选择,尤其是想看大熊猫的话。\n' +
'\n' +
'10. **圆明园** - 虽然现在主要是遗址公园,但仍能窥见昔日皇家园林的辉煌。\n' +
'\n' +
'这些只是北京众多可玩之处的一部分。根据您的兴趣和偏好,您可以选择合适的地方游玩。希望您在北京有一个愉快的周末!',
is_truncated: false,
need_clear_history: false,
usage: { prompt_tokens: 19, completion_tokens: 393, total_tokens: 412 }
}
调用示例(流式)
import os
import qianfan
#【推荐】使用安全认证AK/SK鉴权,通过环境变量初始化认证信息
# 替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
os.environ["QIANFAN_ACCESS_KEY"] = "your_iam_ak"
os.environ["QIANFAN_SECRET_KEY"] = "your_iam_sk"
chat_comp = qianfan.ChatCompletion()
resp = chat_comp.do(model="BLOOMZ-7B", messages=[{
"role": "user",
"content": "介绍下故宫"
}], stream=True)
for r in resp:
print(r["body"])
package main
import (
"context"
"fmt"
"os"
"github.com/baidubce/bce-qianfan-sdk/go/qianfan"
)
func main() {
// 使用安全认证AK/SK鉴权,通过环境变量初始化;替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
os.Setenv("QIANFAN_ACCESS_KEY", "your_iam_ak")
os.Setenv("QIANFAN_SECRET_KEY", "your_iam_sk")
chat := qianfan.NewChatCompletion(
qianfan.WithModel("BLOOMZ-7B"),
)
resp, _ := chat.Stream( // Stream 启用流式返回,参数与 Do 相同
context.TODO(),
&qianfan.ChatCompletionRequest{
Messages: []qianfan.ChatCompletionMessage{
qianfan.ChatCompletionUserMessage("介绍下北京"),
},
},
)
for {
r, err := resp.Recv()
if err != nil {
panic(err)
}
if resp.IsEnd { // 判断是否结束
break
}
fmt.Println(r.Result)
}
}
import com.baidubce.qianfan.Qianfan;
import com.google.gson.Gson;
public class Demo {
public static void main(String[] args) {
Gson gson = new Gson();
// 使用安全认证AK/SK鉴权,替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
Qianfan qianfan = new Qianfan("your_iam_ak", "your_iam_sk");
qianfan.chatCompletion()
.model("BLOOMZ-7B")
.addMessage("user", "介绍下故宫")
// 启用流式返回
.executeStream()
.forEachRemaining(chunk -> System.out.print(gson.toJson(chunk)));
}
}
import {ChatCompletion, setEnvVariable} from "@baiducloud/qianfan";
// 使用安全认证AK/SK鉴权,通过环境变量初始化;替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
setEnvVariable('QIANFAN_ACCESS_KEY','your_iam_ak');
setEnvVariable('QIANFAN_SECRET_KEY','your_iam_sk');
const client = new ChatCompletion();
async function main() {
const resp = await client.chat({
messages: [
{
role: 'user',
content: '介绍下故宫',
},
],
stream: true, //启用流式返回
}, 'BLOOMZ-7B');
for await (const chunk of resp) {
console.log(chunk);
}
}
main();
返回示例(流式)
{'id': 'as-a1vhyaq21w', 'object': 'chat.completion', 'created': 1719045462, 'sentence_id': 0, 'is_end': False, 'is_truncated': False, 'result': ' 故宫,又称紫禁城,位于中国北京市中心,是明', 'need_clear_history': False, 'usage': {'prompt_tokens': 3, 'completion_tokens': 15, 'total_tokens': 18}}
{'id': 'as-a1vhyaq21w', 'object': 'chat.completion', 'created': 1719045463, 'sentence_id': 1, 'is_end': False, 'is_truncated': False, 'result': '、清两代的皇家宫殿,也是世界上现存规模最大、保存最为', 'need_clear_history': False, 'usage': {'prompt_tokens': 3, 'completion_tokens': 15, 'total_tokens': 18}}
{'id': 'as-a1vhyaq21w', 'object': 'chat.completion', 'created': 1719045463, 'sentence_id': 2, 'is_end': False, 'is_truncated': False, 'result': '完整的木质结构古建筑群之一。故宫始建于明朝永乐四年(1', 'need_clear_history': False, 'usage': {'prompt_tokens': 3, 'completion_tokens': 15, 'total_tokens': 18}}
{'id': 'as-a1vhyaq21w', 'object': 'chat.completion', 'created': 1719045464, 'sentence_id': 3, 'is_end': False, 'is_truncated': False, 'result': '406年),历时14年完成,已有600', 'need_clear_history': False, 'usage': {'prompt_tokens': 3, 'completion_tokens': 15, 'total_tokens': 18}}
{'id': 'as-a1vhyaq21w', 'object': 'chat.completion', 'created': 1719045464, 'sentence_id': 4, 'is_end': False, 'is_truncated': False, 'result': '多年的历史。它占地约72万平方米,有大约8707', 'need_clear_history': False, 'usage': {'prompt_tokens': 3, 'completion_tokens': 15, 'total_tokens': 18}}
{'id': 'as-a1vhyaq21w', 'object': 'chat.completion', 'created': 1719045465, 'sentence_id': 5, 'is_end': False, 'is_truncated': False, 'result': '个房间。故宫的建筑布局严谨,中轴线对称,体现了', 'need_clear_history': False, 'usage': {'prompt_tokens': 3, 'completion_tokens': 15, 'total_tokens': 18}}
{'id': 'as-a1vhyaq21w', 'object': 'chat.completion', 'created': 1719045465, 'sentence_id': 6, 'is_end': False, 'is_truncated': False, 'result': '中国古代的宇宙观和权力观念。\n\n故宫不仅是中国古代宫殿建筑', 'need_clear_history': False, 'usage': {'prompt_tokens': 3, 'completion_tokens': 15, 'total_tokens': 18}}
{'id': 'as-a1vhyaq21w', 'object': 'chat.completion', 'created': 1719045466, 'sentence_id': 7, 'is_end': False, 'is_truncated': False, 'result': '的代表,也是中华文化的宝库,收藏有大量的文物,包括', 'need_clear_history': False, 'usage': {'prompt_tokens': 3, 'completion_tokens': 15, 'total_tokens': 18}}
{'id': 'as-a1vhyaq21w', 'object': 'chat.completion', 'created': 1719045466, 'sentence_id': 8, 'is_end': False, 'is_truncated': False, 'result': '绘画、书法、陶瓷、铜器等,这些文物不仅反映了宫廷文化', 'need_clear_history': False, 'usage': {'prompt_tokens': 3, 'completion_tokens': 15, 'total_tokens': 18}}
{'id': 'as-a1vhyaq21w', 'object': 'chat.completion', 'created': 1719045467, 'sentence_id': 9, 'is_end': False, 'is_truncated': False, 'result': ',也是研究中国古代历史、艺术、科技等方面的重要资料。\n\n1', 'need_clear_history': False, 'usage': {'prompt_tokens': 3, 'completion_tokens': 15, 'total_tokens': 18}}
{'id': 'as-a1vhyaq21w', 'object': 'chat.completion', 'created': 1719045467, 'sentence_id': 10, 'is_end': False, 'is_truncated': False, 'result': '925年,故宫博物院成立,将故宫的', 'need_clear_history': False, 'usage': {'prompt_tokens': 3, 'completion_tokens': 15, 'total_tokens': 18}}
{'id': 'as-a1vhyaq21w', 'object': 'chat.completion', 'created': 1719045468, 'sentence_id': 11, 'is_end': False, 'is_truncated': False, 'result': '皇家宫殿和收藏的文物向公众开放,使其成为一座综合性博物', 'need_clear_history': False, 'usage': {'prompt_tokens': 3, 'completion_tokens': 15, 'total_tokens': 18}}
{'id': 'as-a1vhyaq21w', 'object': 'chat.completion', 'created': 1719045468, 'sentence_id': 12, 'is_end': False, 'is_truncated': False, 'result': '馆。故宫的开放不仅让公众有机会近距离接触和了解中国的', 'need_clear_history': False, 'usage': {'prompt_tokens': 3, 'completion_tokens': 15, 'total_tokens': 18}}
{'id': 'as-a1vhyaq21w', 'object': 'chat.completion', 'created': 1719045469, 'sentence_id': 13, 'is_end': False, 'is_truncated': False, 'result': '传统文化,也促进了文化遗产的保护和研究。如今,故宫', 'need_clear_history': False, 'usage': {'prompt_tokens': 3, 'completion_tokens': 15, 'total_tokens': 18}}
{'id': 'as-a1vhyaq21w', 'object': 'chat.completion', 'created': 1719045469, 'sentence_id': 14, 'is_end': False, 'is_truncated': False, 'result': '已成为中国最重要的文化象征之一,也是世界文化遗产之一,每年吸引着', 'need_clear_history': False, 'usage': {'prompt_tokens': 3, 'completion_tokens': 15, 'total_tokens': 18}}
{'id': 'as-a1vhyaq21w', 'object': 'chat.completion', 'created': 1719045470, 'sentence_id': 15, 'is_end': True, 'is_truncated': False, 'result': '成千上万的游客和学者前来参观和研究。', 'need_clear_history': False, 'usage': {'prompt_tokens': 3, 'completion_tokens': 234, 'total_tokens': 237}}
北京是中国的首都,位于中国北部,靠近华北平原的北端。
这座城市有着悠久的历史和丰富的文化遗产,是中国政治、文化、国际
交往和科技创新的中心。北京以其众多的历史遗迹、博物馆、
美食和现代化的发展而闻名于世。
### 历史
北京有着超过3000年的历史,曾经是多个朝代
的都城,包括元、明、清三个统一王朝,以及中华民国
和中华人民共和国。因此,北京拥有众多的历史遗迹,如
故宫、天坛、颐和园等,这些都是中国古代建筑和文化
的典范。
### 文化
北京的文化生活丰富
多彩,不仅有京剧、昆曲等传统艺术表演,还有众多
的现代艺术展览、音乐会和电影节。北京烤鸭、豆汁儿
、炸酱面等地方美食也深受国内外游客的喜爱。
### 教育与科技
北京是中国的教育和科研中心,
拥有众多著名的高等学府,如北京大学、清华大学等,以及中国科学院等
重要科研机构。这些机构不仅为中国,也为全球的科技进步做出了重要
贡献。
### 现代化发展
近年来,北京在经济
、科技、基础设施建设等方面取得了快速的发展。北京大兴国际机场的启用
、城市轨道交通的迅速扩张等,都展示了北京作为国际大都市的
现代化面貌。
### 环境保护
北京也面临着环境污染
等挑战,尤其是空气质量问题。为此,政府实施了一系列的环境保护
措施,努力改善环境质量。
### 国际交往
作为中国的首都,北京是许多国际组织和外国使馆的所在地,
是中国与世界交流的重要窗口。北京曾成功举办了2008
年夏季奥运会,以及2022年冬季奥运会和冬季残奥
会,进一步提升了其国际影响力。
北京是一个融合了古
老传统与现代气息的城市,无论是历史爱好者、美食追寻者还是
科技和艺术的探索者,都能在这里找到自己的兴趣点。
{"sentenceId":0,"isEnd":false,"isTruncated":false,"result":" 故宫,又称紫禁城,位于中国北京市中心,是明","needClearHistory":false,"usage":{"promptTokens":3,"completionTokens":0,"totalTokens":3},"id":"as-cztjs2nnfg","object":"chat.completion","created":1719046076,"headers":{...}}
{"sentenceId":1,"isEnd":false,"isTruncated":false,"result":"、清两代的皇家宫殿,也是现在的故宫博物院。","needClearHistory":false,"usage":{"promptTokens":3,"completionTokens":0,"totalTokens":3},"id":"as-cztjs2nnfg","object":"chat.completion","created":1719046077,"headers":{...}}
{"sentenceId":2,"isEnd":false,"isTruncated":false,"result":"故宫始建于明朝永乐四年(1406年),到永乐","needClearHistory":false,"usage":{"promptTokens":3,"completionTokens":0,"totalTokens":3},"id":"as-cztjs2nnfg","object":"chat.completion","created":1719046077,"headers":{...}}
{"sentenceId":3,"isEnd":false,"isTruncated":false,"result":"十八年(1420年)基本建成,之后经过多次修","needClearHistory":false,"usage":{"promptTokens":3,"completionTokens":0,"totalTokens":3},"id":"as-cztjs2nnfg","object":"chat.completion","created":1719046078,"headers":{...}}
{"sentenceId":4,"isEnd":false,"isTruncated":false,"result":"缮和扩建,形成了现今的规模。故宫是世界上现存规模最大","needClearHistory":false,"usage":{"promptTokens":3,"completionTokens":0,"totalTokens":3},"id":"as-cztjs2nnfg","object":"chat.completion","created":1719046078,"headers":{...}}
{"sentenceId":5,"isEnd":false,"isTruncated":false,"result":"、保存最为完整的木质结构古建筑群之一。\n\n故宫以","needClearHistory":false,"usage":{"promptTokens":3,"completionTokens":0,"totalTokens":3},"id":"as-cztjs2nnfg","object":"chat.completion","created":1719046079,"headers":{...}}
{"sentenceId":6,"isEnd":false,"isTruncated":false,"result":"它的建筑艺术和丰富的藏品闻名于世。它占地约72","needClearHistory":false,"usage":{"promptTokens":3,"completionTokens":0,"totalTokens":3},"id":"as-cztjs2nnfg","object":"chat.completion","created":1719046079,"headers":{...}}
{"sentenceId":7,"isEnd":false,"isTruncated":false,"result":"万平方米,有大殿、宫殿、馆舍等七百多座建筑物","needClearHistory":false,"usage":{"promptTokens":3,"completionTokens":0,"totalTokens":3},"id":"as-cztjs2nnfg","object":"chat.completion","created":1719046080,"headers":{...}}
{"sentenceId":8,"isEnd":false,"isTruncated":false,"result":",共计约有9999间半房间。故宫的建筑","needClearHistory":false,"usage":{"promptTokens":3,"completionTokens":0,"totalTokens":3},"id":"as-cztjs2nnfg","object":"chat.completion","created":1719046080,"headers":{...}}
{"sentenceId":9,"isEnd":false,"isTruncated":false,"result":"布局严谨,中轴线对称,体现了中国古代建筑的特点和哲学思想。","needClearHistory":false,"usage":{"promptTokens":3,"completionTokens":0,"totalTokens":3},"id":"as-cztjs2nnfg","object":"chat.completion","created":1719046081,"headers":{...}}
{"sentenceId":10,"isEnd":false,"isTruncated":false,"result":"\n\n故宫不仅是中国古代宫廷建筑的精华,还珍藏有大量的","needClearHistory":false,"usage":{"promptTokens":3,"completionTokens":0,"totalTokens":3},"id":"as-cztjs2nnfg","object":"chat.completion","created":1719046081,"headers":{...}}
{"sentenceId":11,"isEnd":false,"isTruncated":false,"result":"文物,包括绘画、书法、陶瓷、铜器等各种艺术珍品","needClearHistory":false,"usage":{"promptTokens":3,"completionTokens":0,"totalTokens":3},"id":"as-cztjs2nnfg","object":"chat.completion","created":1719046082,"headers":{...}}
{"sentenceId":12,"isEnd":false,"isTruncated":false,"result":",这些文物不仅展示了中国几千年的文化积淀,也是研究中国古代","needClearHistory":false,"usage":{"promptTokens":3,"completionTokens":0,"totalTokens":3},"id":"as-cztjs2nnfg","object":"chat.completion","created":1719046082,"headers":{...}}
{"sentenceId":13,"isEnd":false,"isTruncated":false,"result":"历史、艺术、科技等方面的重要资料。\n\n1925年","needClearHistory":false,"usage":{"promptTokens":3,"completionTokens":0,"totalTokens":3},"id":"as-cztjs2nnfg","object":"chat.completion","created":1719046083,"headers":{...}}
{"sentenceId":14,"isEnd":false,"isTruncated":false,"result":",故宫正式对外开放,成为故宫博物院,向公众","needClearHistory":false,"usage":{"promptTokens":3,"completionTokens":0,"totalTokens":3},"id":"as-cztjs2nnfg","object":"chat.completion","created":1719046084,"headers":{...}}
{"sentenceId":15,"isEnd":false,"isTruncated":false,"result":"展示其丰富的文化和艺术藏品。如今,故宫已成为中国最重要的","needClearHistory":false,"usage":{"promptTokens":3,"completionTokens":0,"totalTokens":3},"id":"as-cztjs2nnfg","object":"chat.completion","created":1719046084,"headers":{...}}
{"sentenceId":16,"isEnd":false,"isTruncated":false,"result":"文化象征之一,也是世界文化遗产之一,每年吸引着来自世界各地的","needClearHistory":false,"usage":{"promptTokens":3,"completionTokens":0,"totalTokens":3},"id":"as-cztjs2nnfg","object":"chat.completion","created":1719046085,"headers":{...}}
{"sentenceId":17,"isEnd":true,"isTruncated":false,"result":"数百万游客前来参观学习。","needClearHistory":false,"usage":{"promptTokens":3,"completionTokens":262,"totalTokens":265},"id":"as-cztjs2nnfg","object":"chat.completion","created":1719046085,"headers":{...}}
{
headers: {...},
id: 'as-3rmjf5v463',
object: 'chat.completion',
created: 1718965693,
sentence_id: 0,
is_end: false,
is_truncated: false,
result: ' 故宫,中国明清时期的皇家宫殿,位于北京市中心的紫禁城中。故宫始建于明朝永乐年间,建筑群占地面积约72万平方米。其建筑',
need_clear_history: false,
usage: { prompt_tokens: 3, completion_tokens: 0, total_tokens: 3 }
}
{
headers: {...},
id: 'as-3rmjf5v463',
object: 'chat.completion',
created: 1718965693,
sentence_id: 1,
is_end: false,
is_truncated: false,
result: '风格高贵典雅,装饰华丽精美,是中国传统宫殿建筑的杰出代表。\n\n故宫是中国历史最为悠久、规模最大、保存最完整的古代宫殿',
need_clear_history: false,
usage: { prompt_tokens: 3, completion_tokens: 0, total_tokens: 3 }
}
{
headers: {...},
id: 'as-3rmjf5v463',
object: 'chat.completion',
created: 1718965694,
sentence_id: 2,
is_end: false,
is_truncated: false,
result: '建筑群之一,也是中国古代文化的瑰宝之一。在中国千年文化中,故宫是举世无与伦比的,也是全球最有知名度的博物馆之一。',
need_clear_history: false,
usage: { prompt_tokens: 3, completion_tokens: 100, total_tokens: 103 }
}
{
headers: {...},
id: 'as-3rmjf5v463',
object: 'chat.completion',
created: 1718965694,
sentence_id: 3,
is_end: true,
is_truncated: false,
result: '游客可以在故宫欣赏到大量的文化遗产和珍贵的文物,了解中国皇帝的生活和文化,感受中国古代宫殿建筑的独特魅力。',
need_clear_history: false,
usage: { prompt_tokens: 3, completion_tokens: 125, total_tokens: 128 }
}
请求参数
注意:以下为Python SDK参数说明,其他SDK参数相关说明请参考Go SDK-对话Chat参数相关说明、Java SDK参数相关说明、Node.js SDK参数相关说明。
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
messages | List[dict] | 是 | 聊天上下文信息。说明: (1)messages成员不能为空,1个成员表示单轮对话,多个成员表示多轮对话 (2)最后一个message为当前请求的信息,前面的message为历史对话信息 (3)必须为奇数个成员,成员中message的role必须依次为user、assistant (4)message中的content总长度不能超过4800个字符 |
model | string | 否 | 模型名称,用于指定平台支持预置服务的模型,说明: (1)如果调用预置服务,即调用本文API,该字段必填,且为固定值BLOOMZ-7B (2)如果指定用户自行发布的模型服务,该字段不填写,需填写endpoint字段,详见参数endpoint说明 |
endpoint | string | 否 | 用于指定用户自行发布的模型服务,说明: (1)如果指定用户自行发布的模型服务,endpoint字段为必填 (2)该字段值可以通过查看服务地址获取:打开模型服务-模型推理-我的服务页面,选择创建的服务-点击详情页查看服务地址,endpoint值为 https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/ 后面的地址,如下图所示(3)注意:在创建服务页面,选择模型后,API地址会自动新增个后缀。例如选择某模型,输入API地址为“test1”,endpoint的取值即为“ngxxxol8_test1”,如下图所示,如何发布服务请参考发布平台预置的模型服务 |
temperature | float | 否 | 说明: (1)较高的数值会使输出更加随机,而较低的数值会使其更加集中和确定 (2) 范围(0, 1.0],不能为0 |
top_k | float | 否 | Top-K 采样参数,在每轮token生成时,保留k个概率最高的token作为候选。说明: (1)影响输出文本的多样性,取值越大,生成文本的多样性越强 (2)取值范围:正整数 |
top_p | float | 否 | 说明: (1)影响输出文本的多样性,取值越大,生成文本的多样性越强 (2)取值范围 [0, 1.0] |
penalty_score | float | 否 | 通过对已生成的token增加惩罚,减少重复生成的现象。说明: (1)值越大表示惩罚越大 (2)取值范围:[1.0, 2.0] |
stream | bool | 否 | 是否以流式接口的形式返回数据,默认False · True:是,以流式接口的形式返回数据 · False:否 |
retry_count | int | 否 | 重试次数,默认1次 |
request_timeout | float | 否 | 请求超时时间,默认60秒 |
backoff_factor | float | 否 | 请求重试参数,用于指定重试的策略,默认为0 |
stop | List[string] | 否 | 生成停止标识。当模型生成结果以stop中某个元素结尾时,停止文本生成。说明: (1)每个元素长度不超过20字符 (2)最多4个元素 |
user_id | string | 否 | 表示最终用户的唯一标识符 |
message说明
名称 | 类型 | 描述 |
---|---|---|
role | string | 当前支持以下: user: 表示用户 assistant: 表示对话助手 |
content | string | 对话内容,不能为空 |
返回参数
名称 | 类型 | 描述 |
---|---|---|
id | string | 本轮对话的id |
object | string | 回包类型。 chat.completion:多轮对话返回 |
created | int | 时间戳 |
sentence_id | int | 表示当前子句的序号。只有在流式接口模式下会返回该字段 |
is_end | bool | 表示当前子句是否是最后一句。只有在流式接口模式下会返回该字段 |
is_truncated | bool | 当前生成的结果是否被截断 |
result | string | 对话返回结果 |
need_clear_history | bool | 表示用户输入是否存在安全,是否关闭当前会话,清理历史会话信息 True:是,表示用户输入存在安全风险,建议关闭当前会话,清理历史会话信息 False:否,表示用户输入无安全风险 |
ban_round | int | 当need_clear_history为True时,此字段会告知第几轮对话有敏感信息,如果是当前问题,ban_round=-1 |
usage | usage | token统计信息 |
usage说明
名称 | 类型 | 描述 |
---|---|---|
prompt_tokens | int | 问题tokens数 |
completion_tokens | int | 回答tokens数 |
total_tokens | int | tokens总数 |
HTTP调用
鉴权说明
本文API,支持2种鉴权方式。不同鉴权方式,调用方式不同,使用Header、Query参数不同,详见本文请求说明。开发者可以选择以下任一种方式进行鉴权。
请求说明
- 基本信息
请求地址: https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/bloomz_7b1
请求方式: 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个成员表示单轮对话,多个成员表示多轮对话 (2)最后一个message为当前请求的信息,前面的message为历史对话信息 (3)必须为奇数个成员,成员中message的role必须依次为user、assistant (4)message中的content总长度不能超过4800 个字符 |
stream | bool | 否 | 是否以流式接口的形式返回数据,默认false |
temperature | float | 否 | 说明: (1)较高的数值会使输出更加随机,而较低的数值会使其更加集中和确定 (2)范围 (0, 1.0],不能为0 |
top_k | int | 否 | Top-K 采样参数,在每轮token生成时,保留k个概率最高的token作为候选。说明: (1)影响输出文本的多样性,取值越大,生成文本的多样性越强 (2)取值范围:正整数 |
top_p | float | 否 | 说明: (1)影响输出文本的多样性,取值越大,生成文本的多样性越强 (2)取值范围 [0, 1.0] |
penalty_score | float | 否 | 通过对已生成的token增加惩罚,减少重复生成的现象。说明: (1)值越大表示惩罚越大 (2)取值范围:[1.0, 2.0] |
stop | List(String) | 否 | 生成停止标识。当模型生成结果以stop中某个元素结尾时,停止文本生成。说明: (1)每个元素长度不超过20字符。 (2)最多4个元素 |
user_id | string | 否 | 表示最终用户的唯一标识符 |
message说明
名称 | 类型 | 描述 |
---|---|---|
role | string | 当前支持以下: user: 表示用户 assistant: 表示对话助手 |
content | string | 对话内容,不能为空 |
响应说明
名称 | 类型 | 描述 |
---|---|---|
id | string | 本轮对话的id |
object | string | 回包类型。 chat.completion:多轮对话返回 |
created | int | 时间戳 |
sentence_id | int | 表示当前子句的序号。只有在流式接口模式下会返回该字段 |
is_end | bool | 表示当前子句是否是最后一句。只有在流式接口模式下会返回该字段 |
is_truncated | bool | 当前生成的结果是否被截断 |
result | string | 对话返回结果 |
need_clear_history | bool | 表示用户输入是否存在安全,是否关闭当前会话,清理历史会话信息 true:是,表示用户输入存在安全风险,建议关闭当前会话,清理历史会话信息 false:否,表示用户输入无安全风险 |
ban_round | int | 当need_clear_history为true时,此字段会告知第几轮对话有敏感信息,如果是当前问题,ban_round=-1 |
usage | usage | token统计信息 |
usage说明
名称 | 类型 | 描述 |
---|---|---|
prompt_tokens | int | 问题tokens数 |
completion_tokens | int | 回答tokens数 |
total_tokens | int | tokens总数 |
注意 :同步模式和流式模式,响应参数返回不同,详细内容参考示例描述。
- 同步模式下,响应参数为以上字段的完整json包。
- 流式模式下,各字段的响应参数为 data: {响应参数}。
请求示例(单轮)
以访问凭证access_token鉴权方式为例,说明如何调用API。
# 步骤一,获取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/bloomz_7b1?access_token=[步骤一调用接口获取的access_token]' -d '{
"messages": [
{"role":"user","content":"介绍一下你自己"}
]
}' | iconv -f utf-8 -t utf-8
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/bloomz_7b1?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
{
"id": "as-bcmt5ct4iy",
"object": "chat.completion",
"created": 1680167072,
"result": "您好,我是业内知名的大语言模型,由BigScience研发并开源,能够以46种语言和13种编程语言输出文本。",
"is_truncated":false,
"need_clear_history": false,
"usage": {
"prompt_tokens": 7,
"completion_tokens": 67,
"total_tokens": 74
}
}
请求示例(多轮)
# 步骤一,获取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/bloomz_7b1?access_token=[步骤一调用接口获取的access_token]' -d '{
"messages": [
{"role":"user","content":"请介绍一下你自己"},
{"role":"assistant","content":"业内知名的大语言模型,由BigScience研发并开源,能够以46种语言和13种编程语言输出文本。"},
{"role":"user","content": "我在上海,周末可以去哪里玩?"},
{"role":"assistant","content": "上海是一个充满活力和文化氛围的城市,有很多适合周末游玩的地方。以下是几个值得推荐的地方:\n\n1. 上海科技馆:上海科技馆是中国大陆最大的科技馆之一,有许多互动展览和科学实验室,可以让您了解科技的发展历史和最新成果。\n2. 上海博物馆:上海博物馆是一座集艺术、历史和文化于一体的博物馆,有许多精美的艺术品和文物,可以让您深入了解中国和世界的文化历史。\n3. 外滩:外滩是上海的标志性景点之一,有许多高楼大厦和繁华的商业街区,是欣赏黄浦江美景和城市风貌的好去处。\n4. 上海迪士尼乐园:上海迪士尼乐园是世界上最大的迪士尼主题公园之一,有许多精彩的游乐项目和演出,可以让您尽情享受娱乐和欢乐。\n5. 上海野生动物园:上海野生动物园是一个以自然保护为主题的野生动物园,有许多珍稀动物和植物,可以让您近距离接触大自然。\n\n这些地方都是上海周末游玩的好去处,可以根据自己的兴趣和需求选择合适的行程。"},
{"role":"user","content": "周末这里的天气怎么样?"}
]
}' | iconv -f utf-8 -t utf-8
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/bloomz_7b1?access_token=[调用鉴权接口获取的token]"
payload = json.dumps({
"messages": [
{
"role": "user",
"content": "请介绍一下你自己"
},
{
"role": "assistant",
"content": "业内知名的大语言模型,由BigScience研发并开源,能够以46种语言和13种编程语言输出文本。"
},
{
"role": "user",
"content": "我在上海,周末可以去哪里玩?"
},
{
"role": "assistant",
"content": "上海是一个充满活力和文化氛围的城市,有很多适合周末游玩的地方。以下是几个值得推荐的地方:\n\n1. 上海科技馆:上海科技馆是中国大陆最大的科技馆之一,有许多互动展览和科学实验室,可以让您了解科技的发展历史和最新成果。\n2. 上海博物馆:上海博物馆是一座集艺术、历史和文化于一体的博物馆,有许多精美的艺术品和文物,可以让您深入了解中国和世界的文化历史。\n3. 外滩:外滩是上海的标志性景点之一,有许多高楼大厦和繁华的商业街区,是欣赏黄浦江美景和城市风貌的好去处。\n4. 上海迪士尼乐园:上海迪士尼乐园是世界上最大的迪士尼主题公园之一,有许多精彩的游乐项目和演出,可以让您尽情享受娱乐和欢乐。\n5. 上海野生动物园:上海野生动物园是一个以自然保护为主题的野生动物园,有许多珍稀动物和植物,可以让您近距离接触大自然。\n\n这些地方都是上海周末游玩的好去处,可以根据自己的兴趣和需求选择合适的行程。"
},
{
"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: Mon, 12 Apr 2021 06:27:55 GMT
Content-Type: application/json;charset=utf-8
Statement: AI-generated
{
"id": "as-1tbbc0x5af",
"object": "chat.completion",
"created": 1680166551,
"result": "2023年4月2日上海气温13~21℃,多云转阴,东风3-4级,空气质量良,空气质量指数55。\n\n\n\n近7日天气信息:\n\n2023-03-29:阴转小雨,11~17℃,东北风<3级,空气质量良。\n\n2023-03-30:小雨转阴,10~14℃,东风3-4级,空气质量良。\n\n2023-03-31:多云,12~18℃,东风3-4级,空气质量优。\n\n2023-04-01:多云转晴,11~20℃,东南风3-4级,空气质量良。\n\n2023-04-02:多云转阴,13~21℃,东风3-4级,空气质量良。\n\n2023-04-03:阴转中雨,15~18℃,东南风4-5级,空气质量良。\n\n2023-04-04:中雨转小雨,10~17℃,南风5-6级,空气质量优。\n\n2023-04-05:阴,9~14℃,西北风3-4级,空气质量优。",
"is_truncated":false,
"need_clear_history": false,
"usage": {
"prompt_tokens": 470,
"completion_tokens": 198,
"total_tokens": 668
}
}
请求示例(流式)
# 步骤一,获取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/bloomz_7b1?access_token=[步骤一调用接口获取的access_token]' -d '{
"messages": [
{"role":"user", "content": "给我推荐一些自驾游路线"}
],
"stream": true
}'
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/bloomz_7b1?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
data: {"id":"as-ywwpgx4dt7","object":"chat.completion","created":1680166793,"sentence_id":0,"is_end":false,"is_truncated":false,"result":"以下是一些适合自驾游的路线推荐:\n\n1.","need_clear_history":false,"usage":{"prompt_tokens":11,"completion_tokens":16,"total_tokens":27}}
data: {"id":"as-ywwpgx4dt7","object":"chat.completion","created":1680166794,"sentence_id":1,"is_end":false,"is_truncated":false,"result":" 中国大陆最美的景观大道:川藏线,从成都出发,沿着川藏公路一路向西,经过稻城亚丁、理塘、巴塘、芒康等美景,最终到达拉萨。","need_clear_history":false,"usage":{"prompt_tokens":11,"completion_tokens":50,"total_tokens":77}}
data: {"id":"as-ywwpgx4dt7","object":"chat.completion","created":1680166795,"sentence_id":2,"is_end":false,"is_truncated":false,"result":"\n2. 丝绸之路:这是一条贯穿中国东西部的公路,从上海出发,经过西安、兰州、乌鲁木齐等城市,最终到达喀什。","need_clear_history":false,"usage":{"prompt_tokens":11,"completion_tokens":43,"total_tokens":120}}
data: {"id":"as-ywwpgx4dt7","object":"chat.completion","created":1680166796,"sentence_id":3,"is_end":false,"is_truncated":false,"result":"沿途可以欣赏到中国北方和南方的不同景色。\n3. 西北大环线:从成都出发,经过都江堰、青城山、丹巴、塔公草原、新都桥等景点,最终到达西宁。","need_clear_history":false,"usage":{"prompt_tokens":11,"completion_tokens":56,"total_tokens":176}}
data: {"id":"as-ywwpgx4dt7","object":"chat.completion","created":1680166799,"sentence_id":4,"is_end":false,"is_truncated":false,"result":"这条路线可以领略到中国西北地区的壮美风光。\n4. 东北环线:从沈阳出发,经过长春、吉林、延吉等城市,最终到达哈尔滨。","need_clear_history":false,"usage":{"prompt_tokens":11,"completion_tokens":48,"total_tokens":224}}
data: {"id":"as-ywwpgx4dt7","object":"chat.completion","created":1680166800,"sentence_id":5,"is_end":false,"is_truncated":false,"result":"沿途可以欣赏到中国东北地区的广阔草原和森林。\n5. 西南环线:从成都出发,经过雅安、康定、理塘、稻城亚丁等景点,最终到达香格里拉。","need_clear_history":false,"usage":{"prompt_tokens":11,"completion_tokens":54,"total_tokens":278}}
data: {"id":"as-ywwpgx4dt7","object":"chat.completion","created":1680166802,"sentence_id":6,"is_end":false,"is_truncated":false,"result":"这条路线可以领略到中国西南地区的高山峡谷和民族文化。\n6. 海南环线:从三亚出发,经过海口、文昌、万宁等城市,最终到达三亚。","need_clear_history":false,"usage":{"prompt_tokens":11,"completion_tokens":52,"total_tokens":330}}
data: {"id":"as-ywwpgx4dt7","object":"chat.completion","created":1680166803,"sentence_id":7,"is_end":false,"is_truncated":false,"result":"这条路线可以欣赏到中国南方的海岸线和热带雨林。\n7. 滇藏线:从昆明出发,经过大理、丽江、香格里拉等景点,最终到达西藏拉萨。","need_clear_history":false,"usage":{"prompt_tokens":11,"completion_tokens":52,"total_tokens":382}}
data: {"id":"as-ywwpgx4dt7","object":"chat.completion","created":1680166804,"sentence_id":8,"is_end":true,"is_truncated":false,"result":"这条路线可以领略到中国西南地区和西藏地区的自然风光和人文景观。","need_clear_history":false,"usage":{"prompt_tokens":11,"completion_tokens":30,"total_tokens":412}}
错误码
如果请求错误,服务器返回的JSON文本包含以下参数。
名称 | 描述 |
---|---|
error_code | 错误码 |
error_msg | 错误描述信息,帮助理解和解决发生的错误 |
例如Access Token失效返回以下内容,需要重新获取新的Access Token再次请求。
{
"error_code": 110,
"error_msg": "Access token invalid or no longer valid"
}
更多相关错误码,请查看错误码说明。