快速开始
用一个最小请求完成第一次 API 调用。你只需要准备 API Key 和一个可用的 voice_id。
获取 API Key
进入 API Key 管理平台创建API Key。完整密钥只展示一次,请保存到服务端环境变量或密钥管理系统,不要写进浏览器代码或公开仓库。
配置环境变量
本地调试时,将 API Key 配置为环境变量。
export MOSS_API_KEY="<your_api_key>"发起第一个请求
以下调用使用单人语音生成接口。voice_id 可通过查询音色列表或创建音色接口获得。
curl -X POST "https://api.mosi.cn/v1/audio/speech" \
-H "Authorization: Bearer $MOSS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "moss-tts-1.5-flash",
"input": "欢迎使用 Moss API。[pause 0.8s]现在开始生成语音。",
"voice_id": "94aa4989-c7e9-5007-ae42-ab401823e6c9",
"response_format": "mp3",
"delivery_method": "url"
}'读取返回结果
当前请求使用 delivery_method=url,成功后读取响应中的 url 获取生成音频。如改为异步调用,则使用返回的 task_id 调用 GET /v1/audio/tasks/{task_id} 查询最终状态和结果。