Auto Story

首页›能力清单›音色定制

音色定制

音色定制是 Auto Story 开放平台的一项能力:音色描述文本 → 该音色的样例音频。产物 result.audio_id。它同时有网页入口(自由工作台与短剧流水线里用的就是这一项),接口与网页跑的是同一套服务端实现,产物与计费口径完全一致。

这一项共 4 个参数,其中必填的是 voice_prompt。参数名、取值范围与默认值以本页下方的目录为准:接口按这份契约严格校验,未知参数直接报错,不会静默丢弃。

调用方式是「提交即返回任务号、再轮询取结果」:文本与图片类通常十几秒到一分钟,视频类一条按分钟计。排队中的任务会给出队列位置,那不代表失败。

参数契约

参数必填说明取值与边界
voice_prompt必填音色描述,如「低沉磁性的中年男声」string
text可选样例音频文本;缺省用默认样例句string
language可选语种(传英文码):Auto=自动识别 / Chinese=中文 / English=英文 / Japanese=日语 / Korean=韩语 / French=法语 / German=德语 / Spanish=西班牙语 / Italian=意大利语 / Portuguese=葡萄牙语 / Russian=俄语;缺省 Autostring;或:Auto/Chinese/English/Japanese/Korean/French/German/Spanish/Italian/Portuguese/Russian
prefix可选样例文件命名前缀string

调用示例

{
  "task_type": "voice_design",
  "params": {
    "voice_prompt": "低沉磁性的中年男声,语速偏慢",
    "text": "欢迎使用本平台的声音定制能力。"
  }
}

常见问题

音色定制怎么计费?
按「voice_clone」这一计费项从账户余额扣除。提交时按最低档预扣,跑完按实际用量结算;任务失败不计费,预扣部分解冻回余额。
生成的文件在哪里?
任务完成时在结果里给出签名直链,图片、视频、音频都是这个形式。直链 24 小时过期,需要长期留存请自行转存。
可以直接在网页上用吗?
可以。自由工作台与短剧流水线里都有这一项的界面入口,接口与 MCP 是给系统和智能体调用的同一能力。