Skip to main content
POST
音效生成

说明

根据文本描述同步生成 1-4 个音效变体,默认模型为 senseaudio-sfx-1.0-260626,完成媒体校验、文件上传和实际成功数量结算后返回结果。备注:单条消耗 100 积分,单次最多生成 4 条,合计消耗 400 积分。
至少一个变体成功时返回 HTTP 200,statuscompletedpartial_success;仅对成功变体计费。全部失败时返回业务错误并全额退款。
传入 duration_seconds 时会强制关闭 smart_duration,即使请求中 smart_duration=true

授权

Authorization
string
header
必填

格式:Bearer <API_KEY>

请求体

application/json
text
string
必填

音效描述文本,去除首尾空白后不可为空。

Maximum string length: 2000
model
string
默认值:senseaudio-sfx-1.0-260626
必填

已启用的音效模型 label。

示例:

"senseaudio-sfx-1.0-260626"

variants_count
integer
默认值:4

生成变体数量。备注:单条消耗 100 积分,单次最多生成 4 条,合计消耗 400 积分。

必填范围: 1 <= x <= 4
duration_seconds
integer

固定生成时长,单位秒;优先于 smart_duration。

必填范围: 1 <= x <= 10
smart_duration
boolean
默认值:true

由模型根据提示词自动决定时长。

prompt_influence
number

提示词影响权重;不传时使用模型默认值。

必填范围: 0 <= x <= 1
output_format
enum<string>
默认值:mp3

输出音频格式。

可用选项:
mp3,
wav

响应

200 - application/json

成功

generation_id
string

本次同步生成批次 ID。

status
enum<string>

批次聚合状态。

可用选项:
completed,
partial_success
items
object[]

按变体序号排列的生成结果。