插件-角色描述自动生成
更新时间:
角色描述自动生成
接口
POST /v2/api/character/auto/desc
入参
名称  | 类型  | 是否必传  | 说明  | 
type  | String  | 是  | file或者text  | 
fileUrl  | String  | 否  | 外部文件链接  | 
text  | String  | 否  | 文本内容  | 
fileName  | String  | 否  | type是file时必填,带有文件类型后缀的文件名  | 
返回
名称  | 类型  | 说明  | 
content  | string  | 自动生成的内容  | 
usage  | object  | token用量  | 
usage.outputTokens  | int  | token输出用量  | 
usage.inputTokens  | int  | token输入用量  | 
示例参考
说明 
传入内容type分为file、text类型
file类型传入可访问fileUrl地址和fileName
text类型传入文本内容
调用示例
curl --location 'https://nlp.aliyuncs.com/v2/api/character/auto/desc' \
--header 'Expect;' \
--header 'accept: */*' \
--header 'Content-Type: application/json' \
--header 'x-fag-servicename: aca-char-auto-desc' \
--header 'x-fag-appcode: aca' \
--header 'Authorization: Bearer {YOUR_API_KEY}' \
--data '{
  "type": "file",
  "fileUrl":"https://lang.alicdn.com/xingchen/guanyu.txt",
  "fileName":"test.txt"
}'
/**
 * API名称:角色描述自动生成
 * 环境要求:Java 17及以上
 */
public class Example {
    private static final String URL = "https://nlp.aliyuncs.com/v2/api/character/auto/desc";
    private static final String API_KEY = "Bearer {YOUR_API_KEY}";
//    type text 用法
//    private static final String jsonBody = """
//    {
//        "type": "text",
//        "text":"刘备(161年-223年),字玄德,涿郡涿县(今河北涿州)人,三国时期蜀汉开国皇帝。作为汉室后裔,他以仁德宽厚、礼贤下士著称。早年颠沛流离,屡遭挫败,但始终坚韧不拔。他三顾茅庐请出诸葛亮,奠定鼎足之势。于221年在成都称帝,国号“汉”,史称蜀汉。刘备重信义,关爱百姓,其“仁君”形象深入人心。在《三国演义》中,他被塑造为理想化的明主代表,与关羽、张飞的君臣情谊更是千古佳话。"
//    }
//    """;
    
//    type file 用法
    private static final String jsonBody = """
    {
        "type": "file",
        "fileUrl":"https://lang.alicdn.com/xingchen/guanyu.txt",
        "fileName":"test.txt"
    }
    """;
    public static void main(String[] args) throws Exception {
        call();
    }
    private static void call() throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(URL))
                .headers(
                        "Authorization", API_KEY,
                        "X-AcA-DataInspection", "enable",
                        "x-fag-servicename", "aca-char-auto-desc",
                        "x-fag-appcode", "aca",
                        "Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
                .build();
        // 同步调用
        HttpResponse<String> response = client.send(
                request,
                HttpResponse.BodyHandlers.ofString()
        );
        String responseBody = response.body();
        System.out.println("响应数据: " + responseBody);
    }
}import requests
URL = "https://nlp.aliyuncs.com/v2/api/character/auto/desc"
# API名称:角色描述自动生成
# 环境要求:python3.10及以上
def call(api_key):
    headers = {
        "Content-Type": "application/json",
        "x-fag-servicename": "aca-char-auto-desc",
        "x-fag-appcode": "aca",
        "Authorization": f"Bearer {api_key}",
        "X-AcA-DataInspection": "enable"
    }
    # type file 用法
    payload = {
        "type": "file",
        "fileUrl": "https://lang.alicdn.com/xingchen/guanyu.txt",
        "fileName": "test.txt"
    }
    # type text 用法
    # payload = {
    #      "type": "text",
    #      "text":"刘备(161年-223年),字玄德,涿郡涿县(今河北涿州)人,三国时期蜀汉开国皇帝。作为汉室后裔,他以仁德宽厚、礼贤下士著称。早年颠沛流离,屡遭挫败,但始终坚韧不拔。他三顾茅庐请出诸葛亮,奠定鼎足之势。于221年在成都称帝,国号“汉”,史称蜀汉。刘备重信义,关爱百姓,其“仁君”形象深入人心。在《三国演义》中,他被塑造为理想化的明主代表,与关羽、张飞的君臣情谊更是千古佳话。"
    # }
    response = requests.post(URL, json=payload, headers=headers)
    # 逐行打印原始响应内容
    for line in response.iter_lines():
        if line:
            print(line.decode('utf-8'))
    # 检查响应状态,如有错误则抛出异常
    response.raise_for_status()
    return response
if __name__ == "__main__":
    api_key = "YOUR_API_KEY"
    try:
        response = call(api_key)
    except requests.HTTPError as e:
        print(f"请求出错: {e}")package main
import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)
// API名称:角色描述自动生成
// 环境要求:go 1.20及以上
const URL = "https://nlp.aliyuncs.com/v2/api/chat/send"
func call(apiKey string) (*http.Response, error) {
    // type file 用法
    payload := map[string]interface{}{
    "type":     "file",
    "fileUrl":  "https://lang.alicdn.com/xingchen/guanyu.txt",
    "fileName": "test.txt",
    }
    // type text 用法
    //payload := map[string]interface{}{
    //	  "type": "text",
    //	  "text":"刘备(161年-223年),字玄德,涿郡涿县(今河北涿州)人,三国时期蜀汉开国皇帝。作为汉室后裔,他以仁德宽厚、礼贤下士著称。早年颠沛流离,屡遭挫败,但始终坚韧不拔。他三顾茅庐请出诸葛亮,奠定鼎足之势。于221年在成都称帝,国号“汉”,史称蜀汉。刘备重信义,关爱百姓,其“仁君”形象深入人心。在《三国演义》中,他被塑造为理想化的明主代表,与关羽、张飞的君臣情谊更是千古佳话。"
    //}
    payloadBytes, err := json.Marshal(payload)
    if err != nil {
        return nil, err
    }
    req, err := http.NewRequest("POST", URL, bytes.NewBuffer(payloadBytes))
    if err != nil {
        return nil, err
    }
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("x-fag-servicename", "aca-char-auto-desc")
    req.Header.Set("x-fag-appcode", "aca")
    req.Header.Set("Authorization", "Bearer "+apiKey)
    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        return nil, err
    }
    // 逐行打印原始响应内容
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
    if resp.StatusCode != http.StatusOK {
        return nil, fmt.Errorf("请求出错,状态码:%d", resp.StatusCode)
    }
    return resp, nil
}
func main() {
    apiKey := "YOUR_API_KEY"
    _, err := call(apiKey)
    if err != nil {
        fmt.Printf("请求出错: %v\n", err)
    }
}
返回示例
{
    "requestId": "3a42685c-497b-4a54-aeb7-555b68ac410f",
    "code": 200,
    "data": {
        "content": "【关羽基本信息】\n- 原名:长生\n- 后改字:云长\n- 民族:汉族\n- 出生地:并州河东解(今山西运城)\n\n【关羽生平与成就】\n- 中国东汉末年著名将领\n- 自刘备于乡里聚众起兵开始追随刘备,是刘备最为信任的将领之一\n\n【关羽形象神化及后世地位】\n- 关羽去世后,其形象逐渐被后人神化,一直是历来民间祭祀的对象,被尊称为“关公”\n- 经历代朝廷褒封,清代时被奉为“忠义神武灵佑仁勇威显关圣大帝”,崇为“武圣”,与“文圣” 孔子齐名\n- 长篇历史小说《三国演义》对关羽的事迹多有描写和夸大,在《演义》中关羽被描写为“五虎大将”之首\n\n【其他相关】\n- 古代有地名关羽,但其确切位置不明。",
        "usage": {
            "outputTokens": 233,
            "inputTokens": 230,
            "cachedTokens": 0
        },
        "context": {
            "modelName": "xingchen-plus"
        }
    },
    "success": true
}该文章对您有帮助吗?