跳转到主要内容
POST
/
v1
/
agent
创建自定义 Agent
curl --request POST \
  --url https://api.senseaudio.cn/v1/agent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "title": "小助理",
  "prompt": "你是一名专业的小助理",
  "llm_model": "senseaudio-vl-lite-1.0-260319",
  "op_statement": "您好,我是小助理",
  "voice_id": "male_0004_a",
  "speech_model": "senseaudio-tts-1.0"
}
'
import requests

url = "https://api.senseaudio.cn/v1/agent"

payload = {
"title": "小助理",
"prompt": "你是一名专业的小助理",
"llm_model": "senseaudio-vl-lite-1.0-260319",
"op_statement": "您好,我是小助理",
"voice_id": "male_0004_a",
"speech_model": "senseaudio-tts-1.0"
}
headers = {
"Content-Type": "<content-type>",
"Authorization": "Bearer <token>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
method: 'POST',
headers: {'Content-Type': '<content-type>', Authorization: 'Bearer <token>'},
body: JSON.stringify({
title: '小助理',
prompt: '你是一名专业的小助理',
llm_model: 'senseaudio-vl-lite-1.0-260319',
op_statement: '您好,我是小助理',
voice_id: 'male_0004_a',
speech_model: 'senseaudio-tts-1.0'
})
};

fetch('https://api.senseaudio.cn/v1/agent', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.senseaudio.cn/v1/agent",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'title' => '小助理',
'prompt' => '你是一名专业的小助理',
'llm_model' => 'senseaudio-vl-lite-1.0-260319',
'op_statement' => '您好,我是小助理',
'voice_id' => 'male_0004_a',
'speech_model' => 'senseaudio-tts-1.0'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: <content-type>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"strings"
"net/http"
"io"
)

func main() {

url := "https://api.senseaudio.cn/v1/agent"

payload := strings.NewReader("{\n \"title\": \"小助理\",\n \"prompt\": \"你是一名专业的小助理\",\n \"llm_model\": \"senseaudio-vl-lite-1.0-260319\",\n \"op_statement\": \"您好,我是小助理\",\n \"voice_id\": \"male_0004_a\",\n \"speech_model\": \"senseaudio-tts-1.0\"\n}")

req, _ := http.NewRequest("POST", url, payload)

req.Header.Add("Content-Type", "<content-type>")
req.Header.Add("Authorization", "Bearer <token>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.senseaudio.cn/v1/agent")
.header("Content-Type", "<content-type>")
.header("Authorization", "Bearer <token>")
.body("{\n \"title\": \"小助理\",\n \"prompt\": \"你是一名专业的小助理\",\n \"llm_model\": \"senseaudio-vl-lite-1.0-260319\",\n \"op_statement\": \"您好,我是小助理\",\n \"voice_id\": \"male_0004_a\",\n \"speech_model\": \"senseaudio-tts-1.0\"\n}")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.senseaudio.cn/v1/agent")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = '<content-type>'
request["Authorization"] = 'Bearer <token>'
request.body = "{\n \"title\": \"小助理\",\n \"prompt\": \"你是一名专业的小助理\",\n \"llm_model\": \"senseaudio-vl-lite-1.0-260319\",\n \"op_statement\": \"您好,我是小助理\",\n \"voice_id\": \"male_0004_a\",\n \"speech_model\": \"senseaudio-tts-1.0\"\n}"

response = http.request(request)
puts response.read_body
{
  "id": "69b6ac2100000d8dbf84289c"
}

说明

管理账号下的自定义 Agent,所创建的 Agent 可在 创建实时会话 中使用。
  • 标识规则:每个 Agent 拥有全局唯一 id,删除不可恢复
  • 配置项:提示词、工具、音色、LLM 模型均可按需组合

授权

Authorization
string
header
必填

格式:Bearer <API_KEY>

请求头

Content-Type
string
默认值:application/json
必填

内容类型。固定为 application/json

示例:

"application/json"

请求体

application/json
title
string
必填

Agent 标题

示例:

"小助理"

prompt
string
必填

Agent 提示词

示例:

"你是一名专业的小助理"

llm_model
string
必填

Agent llm 模型标识

示例:

"doubao-seed-2-0-pro-260215"

op_statement
string
必填

Agent 开场白

示例:

"您好,我是小助理"

voice_id
string
必填

音色 ID,参考 音色目录与权限

示例:

"male_0004_a"

speech_model
string
必填

语音合成模型

示例:

"senseaudio-tts-1.0"

响应

成功响应

id
string
必填

Agent ID

示例:

"69b6ac2100000d8dbf84289c"