For complete API documentation, security details, all parameters, speaker list, and Python examples, read SKILL-DETAIL.md.
| Friendly Name | model_id | Notes |
|---|---|---|
| --------------- | ---------- | ------- |
| Seed TTS 2.0 | seed-tts-2.0 | ✅ Default and only supported model |
Sub-models (via extra-params):
seed-tts-2.0-expressive — More expressive, emotional (default)seed-tts-2.0-standard — More stable, neutralMust ask first:
| Question | Parameter | Required |
|---|---|---|
| ---------- | ----------- | ---------- |
| 要朗读的内容/文案 | prompt | ✅ Yes |
Recommend asking:
| Question | Parameter | Options |
|---|---|---|
| ---------- | ----------- | --------- |
| 音色/发音人 | speaker | 魅力苏菲、Vivi、云舟、大壹 等 (see SKILL-DETAIL.md) |
Optional:
| Question | Parameter | Range |
|---|---|---|
| ---------- | ----------- | ------- |
| 情感/情绪 | audio_params.emotion | neutral, sad, angry |
| 语速 | audio_params.speech_rate | [-50, 100], 0=normal |
| 音量 | audio_params.loudness_rate | [-50, 100], 0=normal |
| User says | Parameter | Value |
|---|---|---|
| ----------- | ----------- | ------- |
| 旁白/配音/朗读 | prompt + speaker | Ask for content first |
| 女声/female | speaker | e.g. zh_female_vv_uranus_bigtts |
| 男声/male | speaker | e.g. zh_male_sophie_uranus_bigtts |
| 语速快/slow | audio_params.speech_rate | Positive/negative value |
| expressive/standard | model | Sub-model selection |
# List available TTS models
python3 {baseDir}/scripts/ima_tts_create.py --api-key $IMA_API_KEY --list-models
# Generate speech (default model: seed-tts-2.0)
python3 {baseDir}/scripts/ima_tts_create.py \
--api-key $IMA_API_KEY \
--model-id seed-tts-2.0 \
--prompt "Text to be spoken here." \
--user-id {user_id} \
--output-json
# With speaker and emotion
python3 {baseDir}/scripts/ima_tts_create.py \
--api-key $IMA_API_KEY \
--model-id seed-tts-2.0 \
--prompt "阳光青年音色测试，你好世界。" \
--extra-params '{"model":"seed-tts-2.0-expressive","speaker":"zh_male_sophie_uranus_bigtts","audio_params":{"emotion":"neutral"}}' \
--user-id {user_id} \
--output-json
# ✅ CORRECT: Use remote URL directly
message(action="send", media=audio_url, caption="✅ 语音合成成功！\n• 模型：[Name]\n• 耗时：[X]s\n• 积分：[N pts]\n\n🔗 原始链接：[url]")
# ❌ WRONG: Never download to local file
media=audio_url + include link in captionNever say to users: script names, API endpoints, attribute_id, technical parameter names.
Base URL: https://api.imastudio.com
Headers: Authorization: Bearer $IMA_API_KEY · x-app-source: ima_skills · x_app_language: en
GET /open/v1/product/list?app=ima&platform=web&category=text_to_speech → get attribute_id, creditPOST /open/v1/tasks/create → get task_idPOST /open/v1/tasks/detail → poll every 2-5s until resource_status==1MANDATORY: Always query product list first. attribute_id is required.
| Model | Estimated Time | Poll Every |
|---|---|---|
| ------- | --------------- | ------------ |
| seed-tts-2.0 | 5~30s | 3s |
Storage: ~/.openclaw/memory/ima_prefs.json
| Category | Speaker Name | speaker ID |
|---|---|---|
| ---------- | ------------- | ------------ |
| 通用 | 魅力苏菲 | zh_male_sophie_uranus_bigtts |
| 通用 | Vivi | zh_female_vv_uranus_bigtts |
| 通用 | 云舟 | zh_male_m191_uranus_bigtts |
| 视频配音 | 大壹 | zh_male_dayi_uranus_bigtts |
| 角色扮演 | 知性灿灿 | zh_female_cancan_uranus_bigtts |
Full speaker list: See volcengine_tts_timbre_list.json in project or SKILL-DETAIL.md.
⚠️ Important: Use native format (_uranus_bigtts), NOT BV_streaming format.
共 5 个版本