样本标注

更新时间：2025-05-16

功能介绍

用于进行样本标注。

使用说明

本文API支持通过Python SDK、Go SDK、Java SDK 和 Node.js SDK调用，调用流程请参考SDK安装及使用流程。

权限说明

调用本文API，需符合以下权限要求，权限介绍及分配，请查看角色与权限控制列表、账号创建与权限分配。需具有以下任一权限：

完全控制千帆大模型平台的权限：QianfanFullControlAccessPolicy
完全控制千帆大模型平台数据管理（除数据标注外）的权限：QianfanDataFullControlAccessPolicy
运维操作千帆大模型平台数据管理（除数据标注外）的权限：QianfanDataOperateAccessPolicy

SDK调用

调用示例

            Python
        
            Go
        
            Java
        
            Node.js
        

            import os
from qianfan  import resources

# 通过环境变量初始化认证信息
# 使用安全认证AK/SK调用，替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk，如何获取请查看https://cloud.baidu.com/doc/Reference/s/9jwvz2egb
os.environ["QIANFAN_ACCESS_KEY"] = "your_iam_ak"
os.environ["QIANFAN_SECRET_KEY"] = "your_iam_sk"



resp = resources.console.utils.call_action(
    # 调用本文API，该参数值为固定值，无需修改；对应API调用文档-请求结构-请求地址的后缀
    "/wenxinworkshop/entity/annotate", "", 
    # 请查看本文请求参数说明，根据实际使用选择参数；对应API调用文档-请求参数-Body参数
    {
         "id": "48dc586f7eb638457b826c02c1b868ef8ac8911b495504625a1ac824f9d38ff8_5f9ac12ca15e4c9c9351174942865e5a",
        "datasetId": "ds-7pkzh1exthpuy10n",
        "content": [{
            "prompt": "请根据下面的新闻生成摘要, 内容如下:一辆小轿车，一名女司机，竟造成9死24伤。日前，深圳市交警局对事故进行通报：从目前证据看，事故系司机超速行驶且操作不当导致。目前24名伤员已有6名治愈出院，其余正接受治疗，预计事故赔偿费或超一千万元。\n生成摘要如下:",
            "response": [
                ["女司机疲劳驾驶导致9死24伤"]
            ]
        }]
    }
    
)

print(resp.body)
        

            package main
import (
    "context"
    "fmt"
    "os"
    "github.com/baidubce/bce-qianfan-sdk/go/qianfan"
)
func main() {
     // 使用安全认证AK/SK鉴权，通过环境变量初始化；替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk
    os.Setenv("QIANFAN_ACCESS_KEY", "your_iam_ak")
    os.Setenv("QIANFAN_SECRET_KEY", "your_iam_sk")
    
    ca := qianfan.NewConsoleAction()
    
    res, err := ca.Call(context.TODO(),
    // 调用本文API，该参数值为固定值，无需修改；对应API调用文档-请求结构-请求地址的后缀
    "/wenxinworkshop/entity/annotate", "",
    // 请查看本文请求参数说明，根据实际使用选择参数；对应API调用文档-请求参数-Body参数
    map[string]interface{}{
                "id": "48dc586f7eb638457b826c02c1b868ef8ac8911b495504625a1ac824f9d38ff8_5f9ac12ca15e4c9c9351174942865e5a",
                "datasetId": "ds-7pkzh1exthpuy10n",
                "content": []map[string]any{{
                    "prompt": "请根据下面的新闻生成摘要, 内容如下:一辆小轿车，一名女司机，竟造成9死24伤。日前，深圳市交警局对事故进行通报：从目前证据看，事故系司机超速行驶且操作不当导致。目前24名伤员已有6名治愈出院，其余正接受治疗，预计事故赔偿费或超一千万元。\n生成摘要如下:",
                    "response": [][]string{
                        {"女司机疲劳驾驶导致9死24伤"},
                    },
                }},
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(string(res.Body))
    
}
        

            import com.baidubce.qianfan.Qianfan;
import com.baidubce.qianfan.model.console.ConsoleResponse;
import com.baidubce.qianfan.util.CollUtils;
import com.baidubce.qianfan.util.Json;
import java.util.Map;

public class Dome {
    public static void main(String args[]){
        // 使用安全认证AK/SK鉴权，替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk
        Qianfan qianfan = new Qianfan("your_iam_ak", "your_iam_sk");
        
        ConsoleResponse<Map<String, Object>> response = qianfan.console()
                // 调用本文API，该参数值为固定值，无需修改；对应API调用文档-请求结构-请求地址的后缀
                .route("/wenxinworkshop/entity/annotate")
                // 需要传入参数的场景，可以自行封装请求类，或者使用Map.of()来构建请求Body
                // Java 8可以使用SDK提供的CollUtils.mapOf()来替代Map.of()
                // 请查看本文请求参数说明，根据实际使用选择参数；对应API调用文档-请求参数-Body参数
                .body(CollUtils.mapOf(
                    "id", "48dc586f7eb638457b826c02c1b868ef8ac8911b495504625a1ac824f9d38ff8_5f9ac12ca15e4c9c9351174942865e5a",
                    "datasetId", "ds-7pkzh1exthpuy10n",
                    "content",new Map[]{CollUtils.mapOf(
                        "prompt", "请根据下面的新闻生成摘要, 内容如下:一辆小轿车，一名女司机，竟造成9死24伤。日前，深圳市交警局对事故进行通报：从目前证据看，事故系司机超速行驶且操作不当导致。目前24名伤员已有6名治愈出院，其余正接受治疗，预计事故赔偿费或超一千万元。\n生成摘要如下:",
                        "response", new String[][]{
                            new String[]{"女司机疲劳驾驶导致9死24伤"}
                        }
                    )}
                ))
                .execute();

        System.out.println(Json.serialize(response));
    }
}
        

            import {consoleAction, setEnvVariable} from "@baiducloud/qianfan";

// 使用安全认证AK/SK鉴权，通过环境变量初始化；替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk
setEnvVariable('QIANFAN_ACCESS_KEY','your_iam_ak');
setEnvVariable('QIANFAN_SECRET_KEY','your_iam_sk');

async function main() {
  //base_api_route:调用本文API，该参数值为固定值，无需修改；对应API调用文档-请求结构-请求地址的后缀
  //data:请查看本文请求参数说明，根据实际使用选择参数；对应API调用文档-请求参数-Body参数
  const res = await consoleAction({base_api_route: '/wenxinworkshop/entity/annotate',data: {
        "id": "48dc586f7eb638457b826c02c1b868ef8ac8911b495504625a1ac824f9d38ff8_5f9ac12ca15e4c9c9351174942865e5a",
        "datasetId": "ds-7pkzh1exthpuy10n",
        "content": [{
            "prompt": "请根据下面的新闻生成摘要, 内容如下:一辆小轿车，一名女司机，竟造成9死24伤。日前，深圳市交警局对事故进行通报：从目前证据看，事故系司机超速行驶且操作不当导致。目前24名伤员已有6名治愈出院，其余正接受治疗，预计事故赔偿费或超一千万元。\n生成摘要如下:",
            "response": [
                ["女司机疲劳驾驶导致9死24伤"]
            ]
        }]
    }
  });    
    
  console.log(res);
}

main();
        

返回示例

            Python
        
            Go
        
            Java
        
            Node.js
        

            {
	"log_id": "x7wwxwhykirrt30n",
	"result": True,
	"status": 200,
	"success": True
}
        

            {
	"log_id": "x7wwxwhykirrt30n",
	"result": true,
	"status": 200,
	"success": true
}
        

            {
	"log_id": "x7wwxwhykirrt30n",
	"result": true,
	"status": 200,
	"success": true
}
        

            {
	log_id: 'x7wwxwhykirrt30n',
	result: true,
	status: 200,
	success: true
}
        

请求参数

名称	类型	必填	说明
id	string	是	样本ID，通过调用获取样本列表接口，返回的id字段获取样本ID
datasetId	string	是	数据集版本id，说明：（1）可以通过以下任一方式获取该字段值： · 方式一，通过调用创建数据集接口，返回的datasetId字段获取 · 方式二，在控制台-数据集管理列表页面，点击详情，在版本信息页查看，如下图所示（2）该字段新增支持string类型，如果之前使用的是int类型，建议变更为string类型，后续可能将逐步废弃int类型；例如之前是通过调用创建数据集V1接口，返回的id字段获取，请替换为接口返回的datasetId字段获取
content	List<object>	否	问答对信息，只有在文本对话标注类型时，该字段有效
labels	List<object>	否	标签列表，只有在文生图类型时，该字段有效

content说明

名称	类型	必填	描述
prompt	string	是	问题
response	List<List<string>>	是	问答对。文本对话不同标注模版，对应content格式不同，说明：（1）目前有2种格式，分别为非排序文本对话、排序文本对话格式（2）如果为非排序文本对话，注意： · 一个样本最多支持十个问答对(content) · 非排序文本对话的回答为一个string，放在string[][]中，示例如下：`"response": [ ["《山水情》作为中国水墨动画的绝唱，折服了无数中外人士。"]]` （3）如果为排序文本对话格式，注意： · 一个样本最多支持十个问答对，单个问答对中的排序及回答数量总和最多支持添加5个 · 外层列表表示不同排序，内层列表表示某个排序的所有回答，示例如下： "response": [["国家食药监管总局发布《食品召回管理办法》，明确一级召回，食用后已经或可能导致严重健康损害甚至死亡的食品应在知悉食品安全风险后24小时内启动召回，自公告发布之日起10个工作日内完成召回。", "国家食药监管总局发布《食品召回管理办法》，明确一级召回食品生产者应在知悉食品安全风险后24小时内启动召回，自公告发布之日起10个工作日内完成召回。对于可能导致严重健康损害甚至死亡的食品也明确需要召回。", "国家食药监管总局发布新规定《食品召回管理办法》，对于可能导致严重健康损害甚至死亡的食品，生产者需在知悉风险后的24小时内启动召回，并需在10个工作日内完成。"],["国家食药监管总局发布新规定《食品召回管理办法》，对于可能导致严重健康损害甚至死亡的食品，生产者需在知悉风险后24小时内启动召回，并须在10个工作日内完成召回。"],["国家食药监管总局发布《食品召回管理办法》，明确一级召回的食品应知悉食品安全风险后24小时内启动召回，且自公告发布之日起10个工作日内完成召回。该办法适用于食用后可能导致严重健康损害甚至死亡的食品。"]]}]