百度智能云千帆 AppBuilder- 应用 API 调用说明

​百度智能云千帆AppBuilder

 概述

本文介绍了百度智能云千帆 AI 原生应用工作台提供的 API 调用应用能力以及如何调用 API 的流程等。

API 调用流程

首先请登录工作台，创建个人应用并完成配置，其次点击发布应用并新增该应用 API Key（密钥），然后即可参考下文应用调用接口说明，进行个人应用的 API 调用。

鉴权介绍

鉴权的主要目的是通过 API Key（密钥），校验调用者的身份信息。在调用百度智能云千帆 AI 原生应用工作台提供的 API 前，必须先获取 API Key（密钥）。

如何获取 API Key（密钥）

在完成应用配置和效果调试后，可点击【发布】按钮完成应用发布。成功发布将获得体验分享链接并支持创建 API 调用密钥，你可通过分享该链接给朋友或其他开发者，使他们能够在 web 体验页立即体验你的 AI 原生应用 demo；同时你也可以通过应用 API 调用接口，以 API 形式进行调用。

• 体验 demo 或 API 调用，都将消耗开发者的调用额度。

• API Key（密钥）为该应用的重要凭证，您最多可创建 10 个，且因密钥长期有效，请勿放在浏览器或外部客户端代码中；如意外泄露，删除密钥即可关闭对应访问入口。

• 重新生成体验地址或删除 API Key（密钥）后，旧地址和已删除密钥将无法继续请求服务，并无法恢复，请谨慎操作。

web 体验页应用 demo 示意：

应用调用接口

您可通过 API Key（密钥)，和下文的应用调用接口进行个人应用的 API 调用。出于安全考虑，目前该接口不支持跨域请求。

请求说明

基本信息

请求地址：https://appbuilder.baidu.com/rpc/2.0/cloud_hub/v1/ai_engine/agi_platform/v1/instance/integrated

请求方式：POST

Header 参数

Body 参数

注意：要求使用 JSON 格式的结构体来描述一个请求的具体内容。

响应说明

错误码

示例代码

基础生成应用与对话式类似，但不需要传 conversation_id 参数。

请求示例：以 RAG 问答应用对话为例，因为是首次对话，未传 conversation_id 参数。注意：示例代码中 Bearer {API Key}的大括号为占位符，实际使用时请删除大括号并替换应用 API Key。

curl --location 'https://appbuilder.baidu.com/rpc/2.0/cloud_hub/v1/ai_engine/agi_platform/v1/instance/integrated' \--header 'Content-Type: application/json' \--header 'X-Appbuilder-Authorization: Bearer {API Key}' \--data '{  "query": "大模型SFT训练要收费吗",  "response_mode": "blocking"}'| native2ascii -encoding UTF-8 -reverse

返回示例：对应的返回示例如下，后端生成了一个 conversation_id，后续继续对话需要在请求时带上该 conversation_id 参数。

{    "code": 0,    "message": "",    "trace_id": "fc1a2d87-ac5d-4a44-acdd-1cfd3d0b9ce8",    "time": 1699005894181,    "result": {        "answer": "**大模型SFT训练要收费**。\n\n大模型SFT训练不同服务类型的单价不同，如ERNIE-Bot-turbo大模型公有云训练服务-SFT-全量更新的单价为0.1元/千tokens，BLOOMZ-7B大模型公有云训练服务-SFT-全量更新的单价为0.08元/千tokens等。",        "conversation_id": "384abd07-f73a-4336-8ca7-74256fb40b1c"    }}