跳转到内容
tansr 资料站

List this application user’s private voices

GET
/t1/voices
curl --request GET \
  --url https://api.tansr.com/t1/voices \
  --header 'x-tansr-app-token: <x-tansr-app-token>'

Without taskId returns the latest 50 private voices. With taskId returns at most one resource linked to that original creation task, including after its task result expires. Unknown tasks, other resource kinds and other owner/application/end-user scopes return an empty list. Resource identity, expiry and revocation remain unchanged. No provider call, task replay or charge is made.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
taskId
string
/^nc_[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$/

Exact original voice.create task identifier. Other query parameters and repeated taskId values are rejected.

Responses

Section titled “Responses”

200

Section titled “200”

No upstream calls or provider account listing

Media typeapplication/json
object
data
required
Array<object>
object
id
required
string
state
required
string
Allowed values: creating ready failed unknown deleting deleted expired
targetModel
required
string
createdAt
required
string
updatedAt
required
string
expiresAt
required
Any of:
string
Example
{
  "data": [
    {
      "state": "creating"
    }
  ]
}

Headers

Section titled “Headers”
x-tansr-voice-task-id
string
/^nc_[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$/

Present only for a successful taskId query, including an empty result; exactly echoes its canonical taskId. Clients must verify it before treating the list as task-linked. Absent on the unfiltered list and errors.

400

Section titled “400”

Invalid taskId or unsupported query parameter