控制台

快速开始

用一个最小请求完成第一次 API 调用。你只需要准备 API Key 和一个可用的 voice_id

获取 API Key

进入 API Key 管理平台创建API Key。完整密钥只展示一次,请保存到服务端环境变量或密钥管理系统,不要写进浏览器代码或公开仓库。

配置环境变量

本地调试时,将 API Key 配置为环境变量。

macOS / Linux
export MOSS_API_KEY="<your_api_key>"

发起第一个请求

以下调用使用单人语音生成接口。voice_id 可通过查询音色列表创建音色接口获得。

创建语音 · cURL
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} 查询最终状态和结果。

下一步