百度智能云千帆社区创意开发指南
大模型开发/产品动态
- LLM
- 文心大模型
2023.12.1110951看过
百度智能云千帆社区新版创意模块上线了，支持大家在千帆社区开发、部署运行、上线创意应用，同时支持在创意应用中免费通过千帆社区接口调用千帆API
百度智能云千帆社区新版创意模块上线了，支持大家在千帆社区开发、部署运行、上线创意应用，同时支持在创意应用中免费通过千帆社区接口调用千帆API，当前支持如下两种类型：
-
Gradio
基于Python语言，无需前端知识，几行代码即可完成创意的可视化应用搭建，适合不熟悉前端技术的后端开发同学，以及需要开发文件上传等纯前端无法实现的创意应用。
推荐使用3.x版本的Gradio，4.x版本某些情况下可能会有问题，如您在使用4.x版本Gradio遇到问题时，请先尝试使用3.x版本。
-
Static
基于前端html、css、js，支持快速将已有HTML页面展示在您的创意应用中，适合重交互与视觉体验的创意应用。
下面我们详细介绍开发创意应用的方法。
创建创意
在创意工坊页面点击右上角的【发布创意】按钮，进入创建页面：
填写创意相关字段，注意要选择正确的接入方式，目前不支持创建完成后再修改接入方式。
提交代码
创建完成后，参考您创意应用页面实现说明Tab中的默认说明文档，使用git clone命令来克隆创意应用的代码库，本地开发完成后使用git add、commit、push命令将代码提交入库。
其中 <your_git_token> 可以通过点击右上角的【复制令牌】按钮获得。
your_git_token 是您操控代码库的唯一凭证，请勿泄露给他人！
开发创意
获得代码库后，就可以在本地开发测试您的创意应用了，两种类型创意应用有一定要求，符合要求的创意应用才能正确启动：
-
Gradio类型的创意要求代码库根目录下必须存在app.py文件
-
Static类型的创意要求代码库根目录下必须存在index.html文件，并且其他css、js等静态资源需要使用相对路径引入
为方便大家的创意应用调用千帆API，百度智能云千帆社区基于千帆SDK为您提供了免费的千帆API调用接口（不保证QPS，切勿滥用），当前支持对话Chat、续写Completions、向量Embeddings、文生图API的调用，接口详细说明如下：
接口中要求的参数 qianfan_api_token 可以在您的创意页面编辑设置Tab中的环境变量管理功能中获得。
qianfan_api_token 是您创意应用免费通过千帆社区接口调用千帆API的唯一凭证，请勿泄露给他人，当前每日调用量上限100，不保证QPS，切勿滥用
对于Gradio类型的创意应用，代码运行时可以直接使用Python从环境变量获取：os.environ.get("QIANFAN_API_TOKEN") 。
对于Static类型的创意应用，目前只能写在创意应用源码中。
创意应用的文件列表查看文件时会对源码中的 qianfan_api_token 脱敏。
1. Chat 对话
Request
|
接口描述
|
封装了千帆Chat对话API，参考：对话Chat
|
|
请求路径
|
https://cloud.baidu.com/api/qianfan_agent/v1/chat?qianfan_api_token={qianfan_api_token}
|
|
请求方式
|
POST
|
请求Body参数参考：请求参数
Response
参考：返回参数
2. Completion 续写
Request
|
接口描述
|
封装了千帆Completion续写API，参考：续写Completions
|
|
对应路径
|
https://cloud.baidu.com/api/qianfan_agent/v1/completion?qianfan_api_token={qianfan_api_token}
|
|
请求方式
|
POST
|
参考：返回参数
3. Embedding 向量化
Request
|
接口描述
|
封装了千帆Embedding向量化API，参考：向量Embeddings
|
|
对应路径
|
https://cloud.baidu.com/api/qianfan_agent/v1/embedding?qianfan_api_token={qianfan_api_token}
|
|
请求方式
|
POST
|
请求Body参数参考：请求参数
Response
参考：返回参数
4. 文生图
Request
|
接口描述
|
封装了千帆文生图API，参考：文生图
|
|
对应路径
|
https://cloud.baidu.com/api/qianfan_agent/v1/text2image?qianfan_api_token={qianfan_api_token}
|
|
请求方式
|
POST
|
请求Body参数参考：请求参数
Response
参考：返回参数
5. 错误码
参考千帆API错误码：千帆API错误码
启动（重启）创意服务
在开发创意应用过程中，您可以无限次的启动（重启）您的应用，但是一旦您的创意上线审核通过后，您再操作启动（重启）您的应用，您的创意应用将自动进入审核中状态，需审核通过后才能被大家查看和试用。
上线创意
创意应用开发测试完成后，可以点击创意页面右上角的【上线创意】按钮提交审核，审核通过后就会展示在创意工坊页面，其他人便可以访问和试用。
上线创意前，请至少确保以下几点：
-
已修改代码库的 README.md 文件为该创意的实现说明
-
创意应用必须处于运行中状态
-
创意应用代码库和试用功能均无违规内容，并且创意应用必须使用到千帆API提供的大模型能力
对于不符合以上最基本要求的创意应用，审核时会被直接拒绝。
修改实现说明
您的创意上线前，请修改代码库中的 README.md 文件为您创意的具体实现说明，实现说明要描述创意如何实现的思路和步骤，否则审核会被拒绝，您可以把代码库中的图片以链接形式插入到 README.md 这个markdown文件中，可以在文件列表查看图片文件copy图片链接。
停止创意服务
您可以随时停止您的创意服务，对于已上线审核通过的创意，停止创意服务后该创意将自动下线，该创意将不再能被其他人查看和试用，但该创意作者仍然可以查看和试用，可以通过点击右上角的【上线创意】按钮重新发起创意审核。
环境变量管理
对应Gradio类型创意应用，可以把一些敏感数据放到环境变量中管理，创意应用运行时可以从系统环境变量获取到。
查看日志
应用运行后可以查看创意应用运行日志，尤其是在应用启动报错的情况下，可以通过查看日志排查启动报错问题。
评论
