Skip to main content
POST
complete voice persona
这是免费 Init + Complete Voice Persona 的第二阶段。产物与收费的 Clone Voice 相同。须先完成第一阶段:Init,等到 awaiting。详见完整工作流程指南
使用 init 返回的相同 taskId。调用 complete 后,继续轮询同一个 taskId,直到状态变为 success
您必须在任务达到 awaiting 状态后的 30 秒内调用此端点。超过此超时时间将导致任务失败,错误码为 VP_USER_TIMEOUT
不需要中间数据(vox_audio_idphrase_id 等)— 系统会自动从 init 阶段读取这些数据。只需传入 taskIdverification_audio_urlname 和可选字段即可。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
taskId
string<uuid>
必填

init 返回的 taskId(同一个任务)

示例:

"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

verification_audio_url
string<uri>
必填

用户朗读验证短语后的录音 URL(WAV/MP3)

示例:

"https://example.com/verification.wav"

name
string
必填

Persona 名称

示例:

"My Voice"

description
string

Persona 描述

is_public
boolean

是否公开,默认 false

示例:

false

image_s3_id
string

封面图片(base64 或 null 自动生成)

响应

201 - application/json
taskId
string
必填

task id. Use this id to query task status.

示例:

"15c257ff-43f7-4678-bd41-202ad6b8488b"