360 Secure SkillHub
360 安全技能中心

SenseAudio-TTS

面向 SenseAudio 文本转语音集成的开发与排错技能,覆盖同步 HTTP、SSE 增量流式与 WebSocket 实时会话三种协议,指导构造鉴权请求与语音参数、将返回的十六进制音频解码为字节、依据终止状态收尾,并给出错误处理、重试与日志等生产化建议。

scikkk
scikkk
热度 52.05
最近更新 2026-05-11 17:31:25
分类:开发依赖:第三方 API应用场景:API 集成 / 代码生成 / 调试排错

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add senseaudio-tts
Metadata
name
senseaudio-tts
description
Build and debug SenseAudio text-to-speech integrations on `/v1/t2a_v2` and `/ws/v1/t2a_v2`, including sync HTTP, SSE stream, WebSocket event sequencing, hex audio decoding, and voice/audio parameter tuning. Use this whenever user requests TTS generation, low-latency streaming speech, voice selection, or TTS error troubleshooting.
metadata
{"openclaw":{"requires":{"env":["SENSEAUDIO_API_KEY"]},"primaryEnv":"SENSEAUDIO_API_KEY","homepage":"https://senseaudio.cn"}}
compatibility
{"required_credentials":[{"name":"SENSEAUDIO_API_KEY","description":"API key from https://senseaudio.cn/platform/api-key","env_var":"SENSEAUDIO_API_KEY"}]}

SenseAudio TTS

Use this skill for all SenseAudio speech synthesis tasks.

Read First

  • references/tts.md

Workflow

  1. Pick protocol:
  • HTTP sync for simple one-shot generation.
  • SSE for incremental HTTP audio chunks.
  • WebSocket for realtime incremental text-to-audio sessions.
  1. Build minimal valid request:
  • Auth header, model, text, voice_setting.voice_id.
  • Add optional tuning only if user asks.
  1. Implement output parsing:
  • Decode data.audio hex to bytes.
  • Finalize on terminal status/event.
  1. Harden for production:
  • Handle auth and parameter errors.
  • Add retry/backoff for transient network failures.
  • Log session and trace identifiers.