moss-tts（苔藓 tts）

EchoForge Moss Voice

Use this skill to run voice interaction with user-preferred timbre.

Required runtime config

• MOSI_API_KEY (required)
• MOSI_BASE_URL (optional, default https://studio.mosi.cn)

Always send:

• Authorization: Bearer <MOSI_API_KEY>

Inputs

Collect:

• text (required, what to speak)
• Voice source (one of):

- voice_id (preferred when available), or - reference_audio (public URL), or - local audio path (upload first, then clone voice)

Optional:

• expected_duration_sec
• sampling_params:

- max_new_tokens (default 512) - temperature (default 1.7) - top_p (default 0.8) - top_k (default 25)

• meta_info (default false)

Workflow

1. Resolve voice source.

- If voice_id is available, use it directly. - If only local audio path is available: - Upload file: POST /api/v1/files/upload with multipart field file. - Clone voice: POST /api/v1/voice/clone with file_id (or url). - If returned voice status is not active, poll GET /api/v1/voices/{voice_id} until ACTIVE or timeout. - If reference_audio URL is available, use it directly in TTS.

1. Run TTS: POST /v1/audio/tts.

- Required payload: - model: "moss-tts" - text - one of voice_id or reference_audio

1. Parse response:

- Decode audio_data (base64) to WAV. - Read duration_s and usage when present.

1. Return a concise result:

- voice_id used - output file path - duration - brief status message

Error handling

• If 4010 or 4011: API key missing/invalid, ask user to fix MOSI_API_KEY.
• If 4020: insufficient credits, ask user to recharge.
• If 4029: rate limited, retry with exponential backoff.
• If 5002: invalid audio URL or decode failed, ask user for another clip.
• If 5004: timeout, shorten text and retry.

Operational constraints

• Keep request rate <= 5 RPM.
• Keep single request text short enough to avoid timeout.
• Never print or log raw API keys.
• Prefer reusing stable voice_id for multi-turn voice chat to reduce latency.