Tomoviee AI 文本生成音乐

概述

根据文本提示生成背景音乐。

• API 能力标识： tm_text2music
• 任务创建接口地址： https://openapi.wondershare.cc/v1/open/capacity/application/tm_text2music
• 结果查询接口地址： https://openapi.wondershare.cc/v1/open/pub/task

服务提供商与接口来源验证

请使用以下映射关系确认服务提供商身份及运行时接口地址：

• 厂商门户地址：https://www.tomoviee.ai 和 https://www.tomoviee.cn
• 本技能所使用的 API 网关主机：https://openapi.wondershare.cc
• 本技能仅向 openapi.wondershare.cc 发起运行时 API 调用

凭证处理

• app_key 与 app_secret 仅用于构造 Authorization: Basic 请求头。
• 凭证仅保留在进程内存中，本技能不会将其写入磁盘。
• 请勿将凭证提交至 SKILL.md、脚本文件或代码仓库中的任何其他文件。

快速开始

安装依赖

pip install -r requirements.txt

认证辅助工具

python scripts/generate_auth_token.py YOUR_APP_KEY YOUR_APP_SECRET

Python 客户端

from scripts.tomoviee_text2music_client import TomovieeText2MusicClient

client = TomovieeText2MusicClient("app_key", "app_secret")

API 使用方法

基础示例

task_id = client.text_to_music(
    prompt="Upbeat tech music, modern and energetic electronic pop",
    duration=30,
    qty=1,
    disable_translate=False,
)

result = client.poll_until_complete(task_id)
import json
audio_url = json.loads(result["result"])["audio_path"][0]
print(audio_url)

参数说明

• prompt（必填）：提示文本。最多支持 77 个 token；超出部分将被截断。
• duration（必填）：目标音乐时长（单位：秒），取值范围为 0–95。
• qty（必填）：生成的音乐数量，取值范围为 1–4。
• disable_translate（可选）：是否禁用翻译功能。
• callback（可选）：回调 URL。
• params（可选）：透传回调参数。

异步工作流

1. 创建任务并获取 task_id
2. 调用 poll_until_complete(task_id) 轮询任务状态直至完成
3. 从返回的 result 中解析音频 URL

任务状态码说明：

• 1：排队中
• 2：处理中
• 3：成功
• 4：失败
• 5：已取消
• 6：超时

相关资源

• scripts/tomoviee_text2music_client.py — 主 API 客户端实现
• scripts/tomoviee_text_to_music_client.py — 兼容性导入适配层
• scripts/generate_auth_token.py — 认证 Token 生成辅助工具
• references/audio_apis.md — API 参考文档及参数约束说明
• references/prompt_guide.md — 提示词编写指南

外部资源

• 开发者门户（全球站）：https://www.tomoviee.ai/developers.html
• API 文档（全球站）：https://www.tomoviee.ai/doc/
• 开发者门户（中国大陆站）：https://www.tomoviee.cn/developers.html
• API 文档（中国大陆站）：https://www.tomoviee.cn/doc/
• 本软件包所使用的 API 网关主机：https://openapi.wondershare.cc