Get a retry plan

Ask the server what a retry of a failed target would cost and which cycle it would use.

GET /sound_clone/api/v1/interpretation/projects/{projectId}/targets/{targetId}/retry-plan

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/interpretation/projects/ip_.../targets/it_.../retry-plan' \
--header 'accessKey: <your_api_key>'

200 Success

{
  "code": 1,
  "message": "success",
  "data": {
    "targetId": "it_...",
    "language": "es",
    "generationId": "ia_...",
    "nextReservationCycle": 2,
    "characters": "6000",
    "rateVersion": "interp-2026-09-27-v1",
    "retryable": true,
    "reason": "PREVIOUS_ATTEMPT_RELEASED",
    "requestId": "..."
  }
}

Only a target in FAILED_RELEASED with action = "RETRY" can be retried. This endpoint returns the server’s plan; the client never prices a retry.

Header

accessKey · string · required

API key for authentication.

Path

projectId · string · required

The project identifier.

targetId · string · required

The target language entry to retry.

Response

targetId · string

The target identifier.

language · string

The target language.

generationId · string

The logical generation the retry would continue.

nextReservationCycle · number

The reservation cycle the retry would use. Pass it to the retry endpoint.

characters · string

The Characters the retry would confirm, as a string.

rateVersion · string

The rate version applied.

retryable · boolean

Whether a retry is currently allowed.

reason · string

A human-readable reason.

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/interpretation/projects/ip_.../targets/it_.../retry-plan' \
--header 'accessKey: <your_api_key>'

200 Success

{
  "code": 1,
  "message": "success",
  "data": {
    "targetId": "it_...",
    "language": "es",
    "generationId": "ia_...",
    "nextReservationCycle": 2,
    "characters": "6000",
    "rateVersion": "interp-2026-09-27-v1",
    "retryable": true,
    "reason": "PREVIOUS_ATTEMPT_RELEASED",
    "requestId": "..."
  }
}

Common errors

• code = 47117: the target does not exist, is not part of this project, or is not owned by your account.
• code = 47118: the target is not in a retryable state.
• code = 47102: the project does not exist or is not owned by your account.