Execute voice.delete with the selected model and a frozen quote

POST

/t1/voices/delete/tasks

const url = 'https://api.tansr.com/t1/voices/delete/tasks';
const options = {
  method: 'POST',
  headers: {
    'idempotency-key': 'example',
    'x-tansr-app-token': '<x-tansr-app-token>',
    'Content-Type': 'application/json'
  },
  body: '{"model":"example","voiceRef":"example"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.tansr.com/t1/voices/delete/tasks \
  --header 'Content-Type: application/json' \
  --header 'idempotency-key: example' \
  --header 'x-tansr-app-token: <x-tansr-app-token>' \
  --data '{ "model": "example", "voiceRef": "example" }'

Requires its application capability. Every model remains subject to explicit supplier wire, meter, price and quota admission. A registered endpoint is not a claim that all vendor models are enabled.

Authorizations

Parameters

Header Parameters

idempotency-key

required

string

>= 16 characters <= 128 characters

Reuse the same key and original input after a transport interruption. An unknown outcome must not be retried with a new key.

Request Body^required

application/json

object

model

string

>= 1 characters <= 256 characters

voiceRef

required

string

/^voice_[a-f0-9-]{36}$/

Example^generated

{
  "model": "example",
  "voiceRef": "example"
}

Responses

200

Application-private operation receipt; result may expire independently of billing and idempotency.

application/json

object

protocol

required

string

Allowed value: nonchat-operations-v1

taskId

required

string

requestId

required

string

operation

required

string

model

required

string

status

required

Any of:

string

Allowed value: preparing

pollIntervalMs

required

integer

>= 1000

retainedUntil

required

string

resultAvailable

required

boolean

result

meter

object

errorCode

string

billing

required

object

state

required

Any of:

string

Allowed value: unreserved

cost

required

Any of:

string
null

string

Example

{
  "protocol": "nonchat-operations-v1",
  "status": "preparing",
  "billing": {
    "state": "unreserved"
  }
}

202

Application-private operation receipt; result may expire independently of billing and idempotency.

application/json

object

protocol

required

string

Allowed value: nonchat-operations-v1

taskId

required

string

requestId

required

string

operation

required

string

model

required

string

status

required

Any of:

string

Allowed value: preparing

pollIntervalMs

required

integer

>= 1000

retainedUntil

required

string

resultAvailable

required

boolean

result

meter

object

errorCode

string

billing

required

object

state

required

Any of:

string

Allowed value: unreserved

cost

required

Any of:

string
null

string

Example

{
  "protocol": "nonchat-operations-v1",
  "status": "preparing",
  "billing": {
    "state": "unreserved"
  }
}

400

Invalid operation input

403

Capability or model not authorized

409

Idempotency key conflict

503

Selected binding is not configured for this operation

Execute voice.delete with the selected model and a frozen quote

Authorizations

Parameters

Header Parameters

Request Bodyrequired

Examplegenerated

Responses

200

Example

202

Example

400

403

409

503

本文是否有帮助?

Request Body^required

Example^generated