快速接入指南

本指南以语音合成能力为例，帮助您在 5 分钟内完成首个 API 调用，并直接得到可播放的 mp3 文件。

1. 获取密钥 (API Key)

进入 API 密钥

进入 API 密钥页面。

新增并保存 API Key

点击 “新增 API Key”，复制并安全保存您的 API Key。

2. 发起请求

选择您熟悉的编程语言，复制以下示例即可直接运行。

以下示例统一输出 output.mp3。其中 model 需填写模型名称，voice_setting.voice_id 需填写可调用音色 ID。

CURL
Python
JavaScript
Go
Java

curl -X POST https://api.senseaudio.cn/v1/t2a_v2 \
  -H "Authorization: Bearer $SENSEAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "senseaudio-tts-1.5-260319",
    "text": "你好，这是来自 SenseAudio 的第一条语音。",
    "voice_setting": {
      "voice_id": "male_0004_a"
    },
    "audio_setting": {
      "format": "mp3",
      "sample_rate": 32000
    }
  }' -o response.json

jq -r '.data.audio' response.json | xxd -r -p > output.mp3

import requests

# 1. 配置 API Key 和 URL
SENSEAUDIO_API_KEY = "SENSEAUDIO_API_KEY"
url = "https://api.senseaudio.cn/v1/t2a_v2"

# 2. 准备请求数据
payload = {
    "model": "senseaudio-tts-1.5-260319",
    "text": "你好，这是来自 SenseAudio 的第一条语音。",
    "voice_setting": {
        "voice_id": "male_0004_a",
        "speed": 1.0,
        "vol": 1.0,
        "pitch": 0
    },
    "audio_setting": {
        "format": "mp3",
        "sample_rate": 32000
    }
}

headers = {
    "Authorization": f"Bearer {SENSEAUDIO_API_KEY}",
    "Content-Type": "application/json"
}

# 3. 发送请求
response = requests.post(url, json=payload, headers=headers)
result = response.json()

if result.get("data") and result["data"].get("audio"):
    audio_bytes = bytes.fromhex(result["data"]["audio"])
    with open("output.mp3", "wb") as f:
        f.write(audio_bytes)
    print("语音已保存到 output.mp3")
else:
    print(f"请求失败: {result.get('base_resp', {}).get('status_msg', 'unknown error')}")

const axios = require('axios');
const fs = require('fs');

const SENSEAUDIO_API_KEY = "SENSEAUDIO_API_KEY";
const url = 'https://api.senseaudio.cn/v1/t2a_v2';

const payload = {
  model: 'senseaudio-tts-1.5-260319',
  text: '你好，这是来自 SenseAudio 的第一条语音。',
  voice_setting: {
    voice_id: 'male_0004_a',
    speed: 1.0,
    vol: 1.0,
    pitch: 0
  },
  audio_setting: {
    format: 'mp3',
    sample_rate: 32000
  }
};

axios.post(url, payload, {
  headers: {
    'Authorization': `Bearer ${SENSEAUDIO_API_KEY}`,
    'Content-Type': 'application/json'
  }
})
.then(response => {
  const result = response.data;

  if (result.data?.audio) {
    const audioBuffer = Buffer.from(result.data.audio, 'hex');
    fs.writeFileSync('output.mp3', audioBuffer);
    console.log('语音已保存到 output.mp3');
  } else {
    console.error('请求失败:', result.base_resp?.status_msg || 'unknown error');
  }
})
.catch(error => {
  console.error('请求失败:', error.message);
});

package main

import (
    "bytes"
    "encoding/hex"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
    "os"
)

type TTSRequest struct {
    Model         string        `json:"model"`
    Text          string        `json:"text"`
    VoiceSetting  VoiceSetting  `json:"voice_setting"`
    AudioSetting  AudioSetting  `json:"audio_setting"`
}

type VoiceSetting struct {
    VoiceID string  `json:"voice_id"`
    Speed   float64 `json:"speed"`
    Vol     float64 `json:"vol"`
    Pitch   int     `json:"pitch"`
}

type AudioSetting struct {
    Format     string `json:"format"`
    SampleRate int    `json:"sample_rate"`
}

func main() {
    SENSEAUDIO_API_KEY := "SENSEAUDIO_API_KEY"
    url := "https://api.senseaudio.cn/v1/t2a_v2"

    payload := TTSRequest{
        Model: "senseaudio-tts-1.5-260319",
        Text:  "你好，这是来自 SenseAudio 的第一条语音。",
        VoiceSetting: VoiceSetting{
            VoiceID: "male_0004_a",
            Speed:   1.0,
            Vol:     1.0,
            Pitch:   0,
        },
        AudioSetting: AudioSetting{
            Format:     "mp3",
            SampleRate: 32000,
        },
    }

    jsonData, _ := json.Marshal(payload)
    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "Bearer "+SENSEAUDIO_API_KEY)
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        fmt.Println("请求失败:", err)
        return
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    var result map[string]any
    json.Unmarshal(body, &result)

    data, ok := result["data"].(map[string]any)
    if !ok || data["audio"] == nil {
        fmt.Println("请求失败")
        return
    }

    audioHex, _ := data["audio"].(string)
    audioBytes, err := hex.DecodeString(audioHex)
    if err != nil {
        fmt.Println("音频解码失败:", err)
        return
    }

    os.WriteFile("output.mp3", audioBytes, 0644)
    fmt.Println("语音已保存到 output.mp3")
}

import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;
import org.json.JSONObject;

public class SenseAudioQuickStart {
    public static void main(String[] args) {
        try {
            String SENSEAUDIO_API_KEY = "SENSEAUDIO_API_KEY";
            String apiUrl = "https://api.senseaudio.cn/v1/t2a_v2";

            // 构建请求体
            JSONObject voiceSetting = new JSONObject();
            voiceSetting.put("voice_id", "male_0004_a");
            voiceSetting.put("speed", 1.0);
            voiceSetting.put("vol", 1.0);
            voiceSetting.put("pitch", 0);

            JSONObject audioSetting = new JSONObject();
            audioSetting.put("format", "mp3");
            audioSetting.put("sample_rate", 32000);

            JSONObject payload = new JSONObject();
            payload.put("model", "senseaudio-tts-1.5-260319");
            payload.put("text", "你好，这是来自 SenseAudio 的第一条语音。");
            payload.put("voice_setting", voiceSetting);
            payload.put("audio_setting", audioSetting);

            // 发送请求
            URL url = new URL(apiUrl);
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setRequestMethod("POST");
            conn.setRequestProperty("Authorization", "Bearer " + SENSEAUDIO_API_KEY);
            conn.setRequestProperty("Content-Type", "application/json");
            conn.setDoOutput(true);

            try (OutputStream os = conn.getOutputStream()) {
                byte[] input = payload.toString().getBytes("utf-8");
                os.write(input, 0, input.length);
            }

            // 读取响应
            try (BufferedReader br = new BufferedReader(
                    new InputStreamReader(conn.getInputStream(), "utf-8"))) {
                StringBuilder response = new StringBuilder();
                String responseLine;
                while ((responseLine = br.readLine()) != null) {
                    response.append(responseLine.trim());
                }

                JSONObject result = new JSONObject(response.toString());
                JSONObject data = result.optJSONObject("data");

                if (data != null && data.has("audio")) {
                    byte[] audioBytes = hexStringToByteArray(data.getString("audio"));
                    try (FileOutputStream fos = new FileOutputStream("output.mp3")) {
                        fos.write(audioBytes);
                    }
                    System.out.println("语音已保存到 output.mp3");
                } else {
                    JSONObject baseResp = result.optJSONObject("base_resp");
                    System.out.println("请求失败: " +
                        (baseResp != null ? baseResp.optString("status_msg", "unknown error") : "unknown error"));
                }
            }
        } catch (Exception e) {
            System.out.println("请求失败: " + e.getMessage());
        }
    }

    private static byte[] hexStringToByteArray(String hex) {
        int len = hex.length();
        byte[] data = new byte[len / 2];
        for (int i = 0; i < len; i += 2) {
            data[i / 2] = (byte) ((Character.digit(hex.charAt(i), 16) << 4)
                + Character.digit(hex.charAt(i + 1), 16));
        }
        return data;
    }
}

3. 命名与取值说明

model：填写模型名称，例如 senseaudio-tts-1.5-260319，可在 模型列表 中查询。
voice_setting.voice_id：填写可调用音色 ID，可在 音色列表 中获取。
output.mp3：示例中的输出文件名，可按业务需要自行修改。

TTS API

语音合成同步合成接口参数详解。

SSE 流式合成

Server-Sent Events 协议流式语音合成接口。

模型列表

查看全部可调用模型与计费概览。

计费规则

了解各项能力的积分消耗规则。

开始使用

文本生成

语音合成

语音识别

人声分离

音乐生成

图片生成

视频生成

智能体

常见问题

条款与政策

1. 获取密钥 (API Key)

2. 发起请求

3. 命名与取值说明

相关资源

TTS API

SSE 流式合成

模型列表

计费规则

​1. 获取密钥 (API Key)

​2. 发起请求

​3. 命名与取值说明

​相关资源

TTS API

SSE 流式合成

模型列表

计费规则

1. 获取密钥 (API Key)

2. 发起请求

3. 命名与取值说明

相关资源