百度文心大模型API测试

功能介绍

ERNIE 3.0系列API可以广泛应用于任何涉及自然语言理解或自然语言生成的任务中。我们预置了多种任务，您可以通过API的方式直接调用ERNIE 3.0大模型的“零样本”能力，也可以自定义任务体验大模型的强大能力。

应用场景

ERNIE 3.0系列API的应用场景包括几乎所有自然语言处理的任务，我们预置了同义改写、写作文、写文案、写摘要、对对联、写小说、自由问答、文本补全等任务，您也可以根据自己业务需要自定义任务。 您使用API接口调用ERNIE 3.0的能力时，需要按照prompt的形式进行输入，您可以参考以下prompt模板的输入形式，更好地引导大模型完成特定任务。

• 注意：{input_text}为需要输入的目标文本，\n为换行符。

API地址及参数说明

返回参数

code返回的错误码解释

服务说明

• ERNIE 3.0 API接口调用从同步预测升级为异步预测，支持未返回结果前可同时提交多个任务请求
• 升级至API接口调用异步预测服务时，需在请求参数中新增参数：async，查看参数描述
• 重新安装 wenxin-api 工具包即可自动升级为调用异步预测服务

• API接口调用同步预测服务已于【1月31号晚上20:00】下线，届时线上API接口调用全部为异步预测服务。

参数描述

获取API Key

您可以登录文心大模型API服务平台个人中心获取您的专属API Key（AK）和Secret Key（SK），或者查看您的AK/SK。请注意保护您的密钥信息，避免泄露。您可以通过删除已泄露的密钥来保护您的账户安全。

https://wenxin.baidu.com/user/key

步骤一：获取access_token

• 向授权服务地址 https://wenxin.baidu.com/moduleApi/portal/api/oauth/token 发送请求（使用POST），并在URL中带上以下参数：

  • grant_type： 必须参数，固定为client_credentials；
  • client_id： 必须参数，应用的API Key(AK) 从链接专区申请；
  • client_secret： 必须参数，应用的Secret Key(SK) 从链接专区申请；
• Content-Type：application/x-www-form-urlencoded
• 需要将{your_ak}、{your_sk}替换成您的AK、SK（注意：连同花括号也一起替换）
• token有效期为24小时

GET https://wenxin.baidu.com/moduleApi/portal/api/oauth/token?grant_type=client_credentials&client_id={your_ak}&client_secret={your_sk}

{
    "code": 0,
    "msg": "success",
    "data": "24.f8629f539d6ba631c834d258a95b264f.86400000.1681357928791.595bc075a111acad1d5a21dea5ef7060-173836"
}

步骤二：异步预测

• 每个技能对应一个请求地址，请求地址如下方“获取结果-请求地址”表格
• 需要将{accessToken}替换成上一步得到的data值（注意：连同花括号也一起替换）

POST https://wenxin.baidu.com/moduleApi/portal/api/rest/1.0/ernie/3.0.25/zeus

 {
    "access_token": "24.f8629f539d6ba631c834d258a95b264f.86400000.1681357928791.595bc075a111acad1d5a21dea5ef7060-173836",
    "async": 1,
    "typeId":1,
    "text": "你好",
    "seq_len": 256,
    "task_prompt": "qa",
    "penalty_score":1.2,
    "dataset_prompt": "qa",
    "is_unidirectional": 0,
    "min_dec_len": 2,
    "min_dec_penalty_text": "。?：！[<S>]",
    "mask_type":"word",
    "topp": 0.8
}

 {
    "code":0,
    "msg":"success",
    "data":{
        "taskId": 1229202,
        "requestId":"7fad28872989e274914ee1687b8f2a13"
    }
}

步骤三：获取结果

• 需要将{accessToken}替换成上一步得到的data值（注意：连同花括号也一起替换）
• 将第二步（异步预测）的返回结果中的taskId 作为参数传入

POST https://wenxin.baidu.com/moduleApi/portal/api/rest/1.0/ernie/v1/getResult

{
    "access_token": "24.f8629f539d6ba631c834d258a95b264f.86400000.1681357928791.595bc075a111acad1d5a21dea5ef7060-173836",
    "taskId": 15346824
}

{
  "code": 0,
  "msg": "success",
  "data": {
    "result": "因为我们有个好心情",
    "createTime": "2022-12-16 16:02:10",
    "requestId": "71a6efb46acbd64394374f44579a01eb",
    "text": "天为什么这么蓝",
    "taskId": 1000000,
    "status": 1 # 0表示生成中，1表示生成成功
  }
}

作画大模型接口说明

ERNIE-ViLG AI作画大模型：文心ERNIE-ViLG2.0 是基于用户输入文本、或文本加图片生成图像及图像编辑功能的技术，主要为用户提供跨模态的文本生成图像的大模型技术服务。

其中，参考图功能是需要用户上传一张符合要求的图片，再输入prompt文本，选择相应的参数设置，即可生成新的图像。

POST https://wenxin.baidu.com/moduleApi/portal/api/rest/1.0/ernievilg/v1/txt2img

 {
    "access_token":"24.f8629f539d6ba631c834d258a95b264f.86400000.1681357928791.595bc075a111acad1d5a21dea5ef7060-173836",
    "text":"钢铁侠",
    "style":"油画",
    "resolution":"1024*1024",
    "num":4
}

 {
    "code": 0,
    "msg": "success",
    "data": {
        "requestId": "78dbc09ab549d9ab48f88619448c391f",
        "taskId": 15348972
    }
}

• 参数：

• 返回参数

异步查询返回图片

POST https://wenxin.baidu.com/moduleApi/portal/api/rest/1.0/ernievilg/v1/getImg

 {
    "access_token":"24.f8629f539d6ba631c834d258a95b264f.86400000.1681357928791.595bc075a111acad1d5a21dea5ef7060-173836",
    "taskId": 15346973
}

 {
    "code": 0,
    "msg": "success",
    "data": {
        "img": "https://wenxin.baidu.com/younger/file/ERNIE-ViLG/82e45bea071d565fdf808aee0a907d8ai4",
        "waiting": "0",
        "imgUrls": [
            {
                "image": "https://wenxin.baidu.com/younger/file/ERNIE-ViLG/82e45bea071d565fdf808aee0a907d8ai4",
                "score": null
            },
            {
                "image": "https://wenxin.baidu.com/younger/file/ERNIE-ViLG/82e45bea071d565fdf808aee0a907d8a30",
                "score": null
            },
            {
                "image": "https://wenxin.baidu.com/younger/file/ERNIE-ViLG/82e45bea071d565fdf808aee0a907d8aex",
                "score": null
            },
            {
                "image": "https://wenxin.baidu.com/younger/file/ERNIE-ViLG/82e45bea071d565fdf808aee0a907d8a5q",
                "score": null
            }
        ],
        "createTime": "2023-04-12 16:23:13",
        "requestId": "6f1edf3b23e13fa39252abc33ffb7d36",
        "style": "油画",
        "text": "钢铁侠",
        "resolution": "1024*1024",
        "taskId": 15346973,
        "status": 1
    }
}

• 入参

• 返回参数

资料来源：https://wenxin.baidu.com/

热门相关：首席的独宠新娘   天启预报   仗剑高歌   网游之逆天飞扬   豪门闪婚：帝少的神秘冷妻