获取Prompt模板详情
更新时间:2024-11-04
注意: 为提升开发者使用体验,本文内容已合并至对应API文档,请查看API鉴权及调用-Prompt工程-Prompt工程V1-获取Prompt模板详情文档;本文档已于2024年6月28日在平台文档中心下线,内容不再更新。
功能介绍
用于获取Prompt模板详情。
注意事项
调用本文API,需使用安全认证AK/SK鉴权,调用流程及鉴权介绍详见SDK安装及使用流程。
调用示例
import os
from qianfan.resources import Prompt
# 使用安全认证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"
resp = Prompt.info(
id="6610", # Prompt ID
var1="example", # 变量值
var2="example"
)
print(resp)
返回示例
QfResponse(code=200,
headers={...},
body={
'log_id': 'w7d9cxqa2z80m3c9',
'result': {
'content':'我需要你帮我们规划一场专业的展览活动,以提高我们公司营收',
'creatorName':'',
'frameworkType':0,
'labels': [{
'color': '#E62E6B',
'labelId': 1735,
'labelName': '营销文案'
}],
'sceneType':1,
'templateContent':'我需要你帮我们规划一场专业的展览活动,以提高我们公司{target}',
'templateId':6610,
'templatePK': 'pt-7508xxx61c56f',
'templateName':'展览活动',
'templateVariables':'target',
'type':1,
'variableIdentifier':'{}'
},
'status': 200,
'success': True
})
参数说明
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
id | string | 是 | Prompt模板ID,通过以下任一方式获取该字段值: · 方式一:通过调用创建Prompt模板接口,返回的字段templatePK 或 templateId获取;需注意转换为string类型,例如返回templateId是int类型6610,该字段id值为“6610” · 方式二:通过调用获取Prompt模板列表接口,返回的字段templatePK 或 templateId获取;需注意转换为string类型,例如返回templateId是int类型6610,该字段id值为“6610” · 方式三:在千帆控制台-Prompt模板-点击自制模板页面,选择模板,在模板详情查看模板ID,如下图所示: ![]() |
插值变量1 | string | 是 | 插值变量1对应的值 |
插值变量2 | string | 是 | 插值变量2对应的值 |
插值变量n | string | 是 | 插值变量n对应的值 |
返回参数
名称 | 类型 | 描述 |
---|---|---|
result | dict | 返回结果 |
log_id | string | 操作记录id |
status | int | 状态码 |
success | bool | 是否操作成功,说明: · true:成功 · false:失败 |
result说明
名称 | 类型 | 描述 |
---|---|---|
templateId | int | Prompt模板ID |
templatePK | string | Prompt模板ID,字符串类型 |
templateName | string | Prompt模板的名称 |
templateContent | string | 模板内容,说明: (1)如果不使用框架,示例:请以{number}字数生成{province}省相关简介" (2)如果使用模型框架该字段值需符合框架要求,详见模板框架说明 |
templateVariables | string | 模板变量,以逗号隔开,示例:"var1,var2" |
variableIdentifier | string | 变量识别符号,现有符号: · 大括号{} · 双大括号{{}} · 中括号[] · 双中括号[[]] · 小括号() · 双小括号(()) |
negativeTemplateContent | string | 反向Prompt模板内容,表示不希望大模型生成的内容,说明:只有sceneType为2,即场景类型为文生图时,返回该字段 |
negativeTemplateVariables | string | 反向Prompt模板的变量,说明:只有sceneType为2时,即场景类型为文生图时,返回该字段 |
labels | label | 模板标签 |
creatorName | string | 创建者名 |
type | int | 模板类型 · 1:预置模板 · 2:用户创建模板 |
sceneType | int | 场景类型: · 1:文生文 · 2:文生图 |
frameworkType | int | 模板框架,说明: · 0:表示无框架,如果不传,默认是0 · 1:Basic Prompt Framework · 2:CRISPE Prompt Framework · 3:Few-shot Promt |
label说明
名称 | 类型 | 描述 |
---|---|---|
labelId | int | 标签ID |
labelName | string | 标签名称 |
color | string | 标签颜色,仅预置标签返回该字段 |