Generate Voice · Moss API

Request parameters

FieldTypeRequiredDescription

model: stringRequired

Model ID. Use the stable model ID for regular calls, or a snapshot model ID when you need to reproduce results from a fixed version.

input: stringRequired

The text to generate speech from.

instruction: stringRequired

A description of the voice style, age, emotion, speaking rate, and so on.

response_format: stringOptional

Audio format for synchronous requests. For asynchronous tasks, use the format returned by the task query as the source of truth.

delivery_method: stringOptional

Result delivery method.

create_voice: booleanOptional

Set to true only when delivery_method=url. After successful creation, the JSON response includes a voice_id for subsequent TTS or TTSD requests. If omitted or set to false, the request only generates a speech preview.

async: booleanOptional

When set to true, creates an asynchronous task and immediately returns a task object.

webhook_url: stringOptional

The HTTPS URL called back after the asynchronous task completes.

Return value

The API returns a preview of the speech generated from the voice description. A synchronous request can return audio directly or provide an audio URL with delivery_method=url; passing async=true returns a task ID. Use the Get a task endpoint to retrieve the result later.

Next steps

List Voices

List the voices available to your account.

Single-speaker Speech

Text-to-speech endpoint.

Request example

curl -X POST "https://api.mosi.cn/v1/audio/voice/generations" \
  -H "Authorization: Bearer $MOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "moss-voice-generator-1.0",
  "input": "Welcome to the show tonight.",
  "instruction": "A gentle, natural young female voice with a hint of a smile",
  "delivery_method": "url",
  "response_format": "mp3"
}'

import os
import requests

response = requests.post(
        "https://api.mosi.cn/v1/audio/voice/generations",
        headers={
        "Authorization": f"Bearer {os.environ['MOSS_API_KEY']}",
        "Content-Type": "application/json",
        },
        json={
            "model": "moss-voice-generator-1.0",
            "input": "Welcome to the show tonight.",
            "instruction": "A gentle, natural young female voice with a hint of a smile",
            "delivery_method": "url",
            "response_format": "mp3",
        },
)

response.raise_for_status()
print(response.json())

const response = await fetch("https://api.mosi.cn/v1/audio/voice/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.MOSS_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "moss-voice-generator-1.0",
    "input": "Welcome to the show tonight.",
    "instruction": "A gentle, natural young female voice with a hint of a smile",
    "delivery_method": "url",
    "response_format": "mp3"
  }),
})

if (!response.ok) throw new Error(`HTTP ${response.status}`)
console.log(await response.json())

Response example

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "object": "audio.voice_generation",
  "status": "SUCCESS",
  "url": "https://cdn.example.com/out.mp3",
  "response_format": "mp3",
  "content_type": "audio/mpeg",
  "created_at": 1710000000
}