快速开始
更新时间:2025-07-16
欢迎来到百度智能云千帆AI应用开发者中心!无论您是经验丰富的开发者,还是刚刚开始探索人工智能的世界,本指南都将帮助您快速上手并开始构建智能应用,实现文本生成、对话交互、内容分析等多种功能。
创建API密钥
首先登录控制台-安全认证-API Key。点击创建API Key。创建的API Key可用于千帆AppBuilder、ModelBuilder、AI开放能力
一个API Key支持同时调用千帆AppBuilder、ModelBuilder、AI开放能力 三方面的能力。您可以点击页面的『添加权限』,并在『服务』里选择计划用该API Key调用的能力范围,即可实现多方向调用。
使用API Key发送请求时,在请求的Header头域中的Authorization字段,需要包含API Key的鉴权信息。
注意:填入鉴权信息时,需要在API Key前面加上Bearer
,请求示例如下:
请求头域 | 参数示例 |
---|---|
Authorization | Bearer bce-v3/ALTAK-DaI**2UEDIWx1EF/1c518f0576wee39s49109qq8ciq37 |
发送大模型对话请求
拥有API Key之后,您就可以发送第一个API请求了。您可直接使用您选择的HTTP客户端REST API,也可以使用千帆官方SDK。同时接口协议兼容OPENAI的SDK。
HTTP 请求
参考模型列表选择入参的model。
Bash
1curl --location 'https://qianfan.baidubce.com/v2/chat/completions' \
2--header 'Content-Type: application/json' \
3--header 'Authorization: Bearer bce-v3/ALTAK-*********/614fb**********' \
4--data '{
5 "model": "ernie-3.5-8k",
6 "messages": [
7 {
8 "role": "system",
9 "content": "平台助手"
10 },
11 {
12 "role": "user",
13 "content": "你好"
14 }
15 ]
16}'
SDK请求
Python
1from openai import OpenAI
2
3client = OpenAI(
4 api_key="bce-v3/ALTAK-KZke********/f1d6ee*************", # 千帆bearer token
5 base_url="https://qianfan.baidubce.com/v2", # 千帆域名
6 default_headers={"appid": "app-xxxxxx"} # 用户在千帆上的appid,非必传
7)
8
9completion = client.chat.completions.create(
10 model="ernie-4.0-turbo-8k", # 预置服务请查看模型列表,定制服务请填入API地址
11 messages=[{'role': 'system', 'content': 'You are a helpful assistant.'},
12 {'role': 'user', 'content': 'Hello!'}]
13)
14
15print(completion.choices[0].message)
SDK支持清单
发送语音合成请求
使用API Key可以调用语音模型能力,包括语音识别,语音合成。下面以使用curl调用短语音合成能力为例,为您展示如何合成一段语音。
账户上需要有可用资源才能成功调用。您可以前往资源领取页,领取语音的免费测试资源,领取后调用接口。
其他语音能力,请参考语音模型一节。
Plain Text
1curl --location --request POST 'https://tsn.baidu.com/text2audio' \
2--header 'Content-Type: application/x-www-form-urlencoded' \
3--header 'Authorization: Bearer bce-v3/ALTAK-*********/614fb**********' \
4--header 'Accept: */*' \
5--data-urlencode 'tex=今天真是个风和日丽的日子' \
6--data-urlencode 'cuid=anfpbT9f1yN8kAvte4RsdyDEeYJ5vS62' \
7--data-urlencode 'ctp=1' \
8--data-urlencode 'lan=zh' \
9--data-urlencode 'spd=5' \
10--data-urlencode 'pit=5' \
11--data-urlencode 'vol=5' \
12--data-urlencode 'per=4106' \
13--data-urlencode 'aue=3' \
14-o output.mp3
发送应用对话请求
用于在一轮对话中向agent应用发送消息。
- 在平台的应用空间下,创建自主规划agent或工作流agent,创建成功后可以得到应用ID
- 通过使用应用ID, 调用"应用 — 新建对话"API,获取对话id(conversation_id)
Plain Text
1curl --location 'https://qianfan.baidubce.com/v2/app/conversation' \
2--header 'Authorization: Bearer <AppBuilder API Key>' \
3--header 'Content-Type: application/json' \
4--data '{
5 "app_id": "850**f-239c-469c-b342-b6**d696f6" // 应用ID
6}'
Plain Text
1HTTP/1.1 200 OK
2{
3 "request_id": "355a4f4e-****-4dec-****-7075030c6d22",
4 "conversation_id": "237****3b-5303-4a4f-b5cc-44f****42" // 对话ID
5}
- app_id和conversation_id准备好后,调用“应用 — 对话” API
Plain Text
1curl --location 'https://qianfan.baidubce.com/v2/app/conversation/runs' \
2--header 'Authorization: Bearer <AppBuilder API Key>' \
3--header 'Content-Type: application/json' \
4--data '{
5 "app_id": "your_app_id",
6 "query": "根据文件中的数据,统计这几所学校小学生有多少",
7 "stream": true,
8 "conversation_id": "355a4f4e-a6d8-4dec-b840-7075030c6d22",
9 "file_ids": [
10 "cdd1e194-cfb7-4173-a154-795fae8535d9"
11 ]
12}'
Plain Text
1{
2 "request_id": "a335502e-502d-426d-9e87-ea8ad47efc8d",
3 "date": "2024-04-26T09:11:13Z",
4 "answer": "一共120人",
5 "conversation_id": "1fdc9182-de2d-4c56-bf64-a72d98c2b59f",
6 "message_id": "66c1c8c5-d04a-4376-91ff-3a7285e698f0",
7 "is_completion": false,
8 "content": [
9 {
10 "event_code": 0,
11 "event_message": "",
12 "event_type": "function_call",
13 "event_id": "6",
14 "event_status": "done",
15 "content_type": "function_call",
16 "outputs": {
17 "text": {
18 "arguments": {
19 "query": "对'北京小学.xlsx'文件中的'count'列数据进行求和操作",
20 "upload_file": "北京小学.xlsx"
21 },
22 "component_code": "CodeInterpreter",
23 "component_name": "代码解释器"
24 }
25 },
26 "usage": {
27 "prompt_tokens": 3476,
28 "completion_tokens": 0,
29 "total_tokens": 3476,
30 "name": "ERNIE-4.0-8K"
31 }
32 }
33 ]
34}
后续步骤
现在您已经发出了第一个API 请求,您可以继续探索以下内容:
-
模型能力
-
功能特性
- Function calling:函数调用能力,描述使用场景及方法
- 结构化输出:大模型按照用户指定json_schema格式返回结果。
- 联网搜索:大模型开启联网搜索能力,获取实时信息并总结返回。