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

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.
2. Run TTS: POST /v1/audio/tts.
• Required payload:
• model: "moss-tts"
• text
• one of voice_id or reference_audio
3. Parse response:
• Decode audio_data (base64) to WAV.
• Read duration_s and usage when present.
4. 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.