mingyan

SoundClone - Query Result

Query the status and result of a voice cloning preview task or audio generation task

GET/kyyReactApiServer/v1/result/{id}

SoundClone Query Result

Use the id returned by a create task API to query the voice cloning task status and result. A completed preview task returns modelId and the preview audio URL. A completed audio generation task returns the generated audio URL, and returns a subtitle file URL when subtitle generation is enabled.

认证

获取 Key

All requests must include a Bearer token in the request header:

cURL

Authorization: Bearer {{key}}

Base URL

https://zcbservice.aizfw.cn/kyyReactApiServer

baseUrl is the shared prefix for all public APIs. The api field in the current page frontmatter shows the full endpoint. Use this baseUrl as the common prefix when reading or composing request paths.

Path Parameters

idstringrequired

Voice cloning task ID returned by the create preview task API or create audio task API.

Response Parameters

idstring

Task ID.

objectstring

Object type, fixed as audio.

createdinteger

Task creation timestamp.

modelstring

Model name used by the task, fixed as soundCloningClone or soundCloningAudio.

statusstring

Task status: queued, processing, completed, or failed.

modelIdstring

Voice model ID. Returned after a preview task is completed, and used to create audio generation tasks.

audioUrlstring

Generated audio URL. For preview tasks, this is the preview audio URL. For audio generation tasks, this is the generated audio URL.

subtitleFilestring

Subtitle file URL, returned after the task is completed when subtitle generation is enabled.

errorstring

Error message, returned when the task fails.

Polling

Query every 5-10 seconds. Stop polling when the status becomes completed or failed.