Retry a failed target

Confirm the server’s retry plan and restart the failed target language.

POST /sound_clone/api/v1/interpretation/projects/{projectId}/targets/{targetId}/retry

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/interpretation/projects/ip_.../targets/it_.../retry' \
--header 'accessKey: <your_api_key>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: 2b8f0d47c1e35a90' \
--data '{
  "nextReservationCycle": 2,
  "characters": 6000,
  "rateVersion": "interp-2026-09-27-v1"
}'

200 Success

{
  "code": 1,
  "message": "success",
  "data": {
    "targetId": "it_...",
    "language": "es",
    "generationId": "ia_...",
    "state": "QUEUED",
    "reservationCycle": 2,
    "reservedCharacters": "6000",
    "message": "Retry accepted.",
    "requestId": "..."
  }
}

Restarts one target language that ended in FAILED_RELEASED. The amount fields you send are a confirmation of the server’s plan, taken from the retry plan — not client-side pricing.

Header

accessKey · string · required

API key for authentication.

Idempotency-Key · string · required

Unique per operation: 16–64 printable ASCII characters. OPERATION_RETRY is replay-safe, so a repeated POST with the same key does not create a second charge.

Path

projectId · string · required

The project identifier.

targetId · string · required

The target to retry.

Body

nextReservationCycle · number · required

From the retry plan.

characters · number · required

From the retry plan. Confirms the server’s amount; do not compute it yourself.

rateVersion · string · required

From the retry plan.

Response

targetId · string

The target identifier.

language · string

The target language.

generationId · string

The logical generation being retried.

state · string

The new target state.

reservationCycle · number

The reservation cycle used.

reservedCharacters · string

Reserved Characters, as a string.

message · string

A human-readable message.

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/interpretation/projects/ip_.../targets/it_.../retry' \
--header 'accessKey: <your_api_key>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: 2b8f0d47c1e35a90' \
--data '{
  "nextReservationCycle": 2,
  "characters": 6000,
  "rateVersion": "interp-2026-09-27-v1"
}'

200 Success

{
  "code": 1,
  "message": "success",
  "data": {
    "targetId": "it_...",
    "language": "es",
    "generationId": "ia_...",
    "state": "QUEUED",
    "reservationCycle": 2,
    "reservedCharacters": "6000",
    "message": "Retry accepted.",
    "requestId": "..."
  }
}

Do not adjust or recompute characters. If the plan is no longer valid, request a new retry plan instead of guessing a new amount.

Common errors

• code = 47118: the target cannot be retried (wrong state or a stale plan).
• code = 47110: not enough Characters available.
• code = 47117: the target does not exist, is not part of this project, or is not owned by your account.
• code = 47111: the Idempotency-Key was reused with a different body.