开放文档
复刻人产品
复刻人管理相关接口

复刻人基础属性配置

# 1.设置复刻人基础属性

# 接口描述

接口地址：https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/setRobotBaseConfig (opens new window)
请求方式： HTTP POST
请求类型：application/json; charset=utf-8
接口鉴权：参见接口鉴权
额外补充说明：此为部分更新接口，不需要更新的不传字段;传字段，内容空则为清空配置

# 输入参数

参数名称	必选	字段	说明
robotId	是	string	复刻人ID
robotName	否	string	复刻人名称（长度不超过30个字符）
robotDesc	否	string	复刻人简介（允许中文、字母、数字；长度不超过100个字）
prologue	否	string	开场白（30字以内；支持中英文数字及常用标点符号（，。；！“ ”？、：（）））
sound	否	string	声音标识（来源：发音人列表/复刻音色使用声音ID：sound ）
imageTaskNo	否	string	动态形象，形象复刻任务id
speakingStyle	否	array	语言风格（最大限度：1个）；来源：建议使用基础属性标签库块推荐标签；
catchphrase	否	array	口头禅（最大限度：3个，每个口头禅长度不超过20个字符）
occupation	否	array	职业（最大限度：1个）；来源：建议使用用基础属性标签库块推荐标签；
character	否	string	角色作为永久提示会在表达、目标生成中发挥作用。可填写“你叫什么”、“什么职业”、“什么表达习惯”、“什么性格特征”。填写时10-200字以内，过滤前后空格，支持中英文数字及常用标点符号（，。；！“ ”？、：（））
memoryRouse	否	int	记忆唤醒 0-关 1-开，默认关
personalityEmotion	否	object	设置AI情绪的波动系数、AI对用户态度的波动系数。AI情绪的波动系数包括：愉悦、抑郁、焦虑、悲伤；AI对用户态度的波动系数包括：喜欢、愤怒、仇恨；可设置0到100以内的整数，数值越小该情绪波动越小，越难表现出来，未设置情况，默认50
personalityEmotion.directEmotion	否	object	AI对用户态度的波动系数
personalityEmotion.directEmotion.anger	否	int	容易愤怒的(0到100)
personalityEmotion.directEmotion.hate	否	int	容易仇恨的(0到100)
personalityEmotion.directEmotion.like	否	int	容易喜欢的(0到100)
personalityEmotion.globalEmotion	否	object	AI情绪的波动系数
personalityEmotion.globalEmotion.anxiety	否	int	容易焦虑的(0到100)
personalityEmotion.globalEmotion.depression	否	int	容易抑郁的(0到100)
personalityEmotion.globalEmotion.pleasure	否	int	容易愉悦的(0到100)
personalityEmotion.globalEmotion.sadness	否	int	容易悲伤的(0到100)
personalityTendency	否	object	人格倾向：6个维度推知、求解、好奇、情绪、策略、追加表达，可设置0到100以内的整数，数值越小该人格越难表现出来。未设置情况默认50
personalityTendency.appendResponse	否	int	追加表达(0到100)
personalityTendency.cognition	否	int	推知(0到100)
personalityTendency.convergence	否	int	求解(0到100)
personalityTendency.divergence	否	int	好奇(0到100)
personalityTendency.emotion	否	int	情绪(0到100)
personalityTendency.strategy	否	int	策略(0到100)

# 输出参数

参数名称	必选	字段类型	说明
code	是	int	状态码
msg	是	String	状态描述信息
success	是	boolean	true：成功；false：失败

# 示例

输入示例:

{
  "robotId": "****WY-JCALWrAPhkc7mU",
  "robotName": "李四",
  "robotDesc": "我是一个示例机器人",
  "catchphrase": [
    "俺老孙来也",
    "妖怪哪里走"
  ],
  "speakingStyle": "自负",
  "occupation": "推销员",
  "sound": "gecv***",
  "imageTaskNo": "234***",
  "memoryRouse": 0,
  "character": "我是用于作为示例的机器人",
  "personalityEmotion": {
    "directEmotion": {
      "anger": 50,
      "hate": 50,
      "like": 50
    },
    "globalEmotion": {
      "anxiety": 50,
      "depression": 50,
      "pleasure": 50,
      "sadness": 50
    }
  },
  "personalityTendency": {
    "appendResponse": 50,
    "cognition": 50,
    "convergence": 50,
    "divergence": 50,
    "emotion":50,
    "strategy": 50
  }
}

输出示例：

{
    "msg": "OK",
    "code": 0,
    "success": true
}

# 快速测试

curl

curl --location --request POST 'https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/setRobotBaseConfig' \
--header 'X-Bm-Access-Token: ****yMjc3LCJhY2Nlc3NLZXkiOiJlZTg4OGYyMjY1MGI0YzdkYjExODA0ZWFkNTQyMmEwMyIsImp3dF90b2tlbl9pZCI6ImU4NjljYTc3LTJiMjctNDBjZC04Yzg4LWE1ODY5NWJlN2Q2NiIsInRlbmFudElkIjoiODUyNTM1NTE0MTIwMDYwOTI4Iiwiand0X3Rva2VuX3R5cGUiOjN9.U5QYuSI-ymzTm6QcAHs2ow1MV3BTXwsACWDGaSeW84Y' \
--header 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
  "robotId": "****WY-JCALWrAPhkc7mU",
  "robotName": "李四",
  "robotDesc": "我是一个示例机器人",
  "prologue":"有何贵干？",
  "catchphrase": [
    "俺老孙来也",
    "妖怪哪里走"
  ],
  "speakingStyle": "自负",
  "occupation": "推销员",
  "sound": "gecv***",
  "imageTaskNo": "234***",
  "memoryRouse": 0,
  "character": "我是用于作为示例的机器人",
  "personalityEmotion": {
    "directEmotion": {
      "anger": 50,
      "hate": 50,
      "like": 50
    },
    "globalEmotion": {
      "anxiety": 50,
      "depression": 50,
      "pleasure": 50,
      "sadness": 50
    }
  },
  "personalityTendency": {
    "appendResponse": 50,
    "cognition": 50,
    "convergence": 50,
    "divergence": 50,
    "emotion":50,
    "strategy": 50
  }
}'

# 2.获取基础属性标签库

# 接口描述

接口地址：https://open.galaxyeye-api.com/intellect-saas-v4/v2/robot/portrait/getHabitTags (opens new window)
请求方式： HTTP POST
请求类型：application/json; charset=utf-8
接口鉴权：参见接口鉴权

# 输入参数

空JSON

# 输出参数

参数名称	必选	字段类型	描述
code	是	int	状态码
msg	是	String	状态描述信息
data	是	object	标签属性
data.occupation	是	array	职业
data.speakingStyle	是	array	语言风格

# 示例

输入示例：

{}

输出示例：

{
    "msg": "OK",
    "code": 0,
    "data": {
        "occupation": [
            "编辑",
            "客服",
            "心理咨询师",
            "推销员",
            "程序员",
            "医生",
            "主播",
            "律师",
            "作家",
            "主持人"
        ],
        "speakingStyle": [
            "幽默",
            "夸张",
            "威胁",
            "娇滴滴",
            "自负",
            "逻辑性强",
            "热情",
            "消极",
            "高冷",
            "明快简洁",
            "辞藻华丽"
        ]
    }
}

# 快速测试

curl

curl --location --request POST 'https://open.galaxyeye-api.com/intellect-saas-v4/v2/robot/portrait/getHabitTags' \
--header 'X-Bm-Access-Token: ****yMjc3LCJhY2Nlc3NLZXkiOiJlZTg4OGYyMjY1MGI0YzdkYjExODA0ZWFkNTQyMmEwMyIsImp3dF90b2tlbl9pZCI6ImU4NjljYTc3LTJiMjctNDBjZC04Yzg4LWE1ODY5NWJlN2Q2NiIsInRlbmFudElkIjoiODUyNTM1NTE0MTIwMDYwOTI4Iiwiand0X3Rva2VuX3R5cGUiOjN9.U5QYuSI-ymzTm6QcAHs2ow1MV3BTXwsACWDGaSeW84Y' \
--header 'Content-Type: application/json; charset=utf-8' \
--data-raw '{}'

# 3.复刻人基础属性查询

# 接口描述

接口地址：https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/getRobotBaseConfig (opens new window)
请求方式： HTTP GET
接口鉴权：参见接口鉴权

####输入参数

参数名称	必选	字段类型	说明
robotId	是	String	复刻人ID

# 输出参数

参数名称	必选	字段类型	说明
code	是	int	状态码
msg	是	String	状态描述信息
data	是	object	业务数据
data.robotId	是	string	复刻人ID
data.robotName	否	string	复刻人名称
data.robotDesc	否	string	复刻人个人简介
data.prologue	否	string	复刻开场白
data.catchphrase	否	array	口头禅
data.speakingStyle	否	array	语言风格；
data.occupation	否	array	职业
data.sound	否	string	声音标识
data.audioRate	否	number	推荐的声音合成速率
data.icon	否	string	复刻人头像地址
data.mouthImage	否	string	说话视频地址
data.unMouthImage	否	string	静默视频地址
data.videoRate	否	number	推荐的视频播放速率
data.character	否	string	角色作为永久提示会在表达、目标生成中发挥作用。
data.memoryRouse	否	int	记忆唤醒 0-关 1-开，默认关
data.personalityEmotion	否	object	设置AI情绪的波动系数、AI对用户态度的波动系数。
data.personalityEmotion.directEmotion	否	object	AI对用户态度的波动系数
data.personalityEmotion.directEmotion.anger	否	int	容易愤怒的
data.personalityEmotion.directEmotion.hate	否	int	容易仇恨的
data.personalityEmotion.directEmotion.like	否	int	容易喜欢的
data.personalityEmotion.globalEmotion	否	object	AI情绪的波动系数
data.personalityEmotion.globalEmotion.anxiety	否	int	容易焦虑的
data.personalityEmotion.globalEmotion.depression	否	int	容易抑郁的
data.personalityEmotion.globalEmotion.pleasure	否	int	容易愉悦的
data.personalityEmotion.globalEmotion.sadness	否	int	容易悲伤的
data.personalityTendency	否	object	人格倾向：6个维度推知、求解、好奇、情绪、策略、追加表达
data.personalityTendency.appendResponse	否	int	追加表达
data.personalityTendency.cognition	否	int	推知
data.personalityTendency.convergence	否	int	求解
data.personalityTendency.divergence	否	int	好奇
data.personalityTendency.emotion	否	int	情绪
data.personalityTendency.strategy	否	int	策略

# 示例

输入示例: https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/getRobotBaseConfig?robotId=****WY-JCALWrAPhkc7mU
输出示例：

{
    "msg": "OK",
    "code": 0,
    "data": {
        "robotId": "****WY-JCALWrAPhkc7mU",
        "robotName": "李四",
        "robotDesc": "我是一个示例机器人",
        "prologue" :"有何贵干？",
        "catchphrase": [
            "俺老孙来也",
            "妖怪哪里走"
        ],
        "speakingStyle": "自负",
        "occupation": "推销员",
        "sound": "gecv***",
        "audioRate":0.9,
        "icon":"https://*********.jpg",
        "mouthImage":"https://*********.mp4",
        "unMouthImage":"https://*********.mp4",
        "videoRate":1,
        "character": "我是用于作为示例的机器人",
        "memoryRouse": 0,
        "personalityEmotion": {
             "directEmotion": {
                "anger": 50,
                "hate": 50,
                "like": 50
            },
            "globalEmotion": {
                "anxiety": 50,
                "depression": 50,
                "pleasure": 50,
                "sadness": 50
            }
        },
        "personalityTendency": {
            "appendResponse": 50,
            "cognition": 50,
            "convergence": 50,
            "divergence": 50,
            "emotion":50,
            "strategy": 50
        }
    }
}

# 快速测试

curl

curl --location --request GET 'https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/getRobotBaseConfig?robotId=****WY-JCALWrAPhkc7mU' \
--header 'X-Bm-Access-Token: ****yMjc3LCJhY2Nlc3NLZXkiOiJlZTg4OGYyMjY1MGI0YzdkYjExODA0ZWFkNTQyMmEwMyIsImp3dF90b2tlbl9pZCI6ImU4NjljYTc3LTJiMjctNDBjZC04Yzg4LWE1ODY5NWJlN2Q2NiIsInRlbmFudElkIjoiODUyNTM1NTE0MTIwMDYwOTI4Iiwiand0X3Rva2VuX3R5cGUiOjN9.U5QYuSI-ymzTm6QcAHs2ow1MV3BTXwsACWDGaSeW84Y' \

# 4.批量查询复刻人详情

# 接口描述

接口地址：https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/getRobotListOpen (opens new window)
请求方式： HTTP POST
请求类型：application/json; charset=utf-8
接口鉴权：参见接口鉴权

# 输入参数

参数名称	必选	字段类型	说明
robotIds	是	array	复刻人ID，每次最多可传50个

# 输出参数

参数名称	必选	字段类型	说明
code	是	int	状态码
msg	是	String	状态描述信息
data	是	array	业务数据
data.robotId	是	string	复刻人ID
data.robotName	否	string	复刻人名称
data.sound	否	string	声音标识
data.audioRate	否	number	推荐的声音合成速率
data.icon	否	string	复刻人头像地址
data.mouthImage	否	string	说话视频地址
data.unMouthImage	否	string	静默视频地址
data.videoRate	否	number	推荐的视频播放速率

# 示例

输入示例: https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/getRobotListOpen (opens new window)

{
  "robotIds":[
    "****WY-JCALWrAPhkc7mU"
  ]  
}

输出示例：

{
    "msg": "OK",
    "code": 0,
    "data": {
        "robotId": "****WY-JCALWrAPhkc7mU",
        "robotName": "李四",
        "sound": "gecv***",
        "audioRate":1,
        "mouthImage":"https://*********.mp4",
        "unMouthImage":"https://*********.mp4",
        "videoRate":1

    }
}

# 快速测试

curl

curl --location --request POST 'https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/getRobotListOpen' \
--header 'X-Bm-Access-Token: ****yMjc3LCJhY2Nlc3NLZXkiOiJlZTg4OGYyMjY1MGI0YzdkYjExODA0ZWFkNTQyMmEwMyIsImp3dF90b2tlbl9pZCI6ImU4NjljYTc3LTJiMjctNDBjZC04Yzg4LWE1ODY5NWJlN2Q2NiIsInRlbmFudElkIjoiODUyNTM1NTE0MTIwMDYwOTI4Iiwiand0X3Rva2VuX3R5cGUiOjN9.U5QYuSI-ymzTm6QcAHs2ow1MV3BTXwsACWDGaSeW84Y' \
--header 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
  "robotIds":[
    "****WY-JCALWrAPhkc7mU"
  ]  
}'

# 5.状态码

返回码	返回码说明	备注
8223	复刻人不属于当前租户
8327	个人简介字段长度超出允许范围，请核实
8234	复刻人个人简介仅支持：中文、字母、数字、空格、常见标点
8235	复刻人开场白仅支持：中文、字母、数字、空格、常见标点
8328	开场白字段长度超出允许范围，请核实
11054	形象任务id不存在
11055	形象任务状态异常
11056	复刻人名称不能为空字符
11057	复刻人名称只允许输入汉字、字母、数字
8310	职业仅支持：中文、字母、数字
8315	职业不能包含空格
8318	职业字段长度超出允许范围，请核实
8316	语言风格不能包含空格
8311	语言风格仅支持：中文、字母、数字
8319	语言风格字段长度超出允许范围，请核实
8324	口头禅字段长度超出允许范围，请核实
8325	口头禅字段数量超出允许范围，请核实
57000	agent远程调用查询标签字典异常远程调用查询机器人标签异常请检查robotId
-1	当前机器人没配置引擎；当前返回对象为空
56010	robotIds个数超出上限

上次更新: 2024/07/15, 14:36:24

← 复刻人创建复刻人观点训练→