v4

latestOpenAPI 3.0.0raw.githubusercontent.com2026-05-23171869.8 KB
Issues

Create a new issue

Report a problem with a TTS generation by creating a new issue. Issues are tracked internally by the Deepdub team and used to improve voice quality. The problemAudioFile field can optionally include base64-encoded audio attached to the issue, and problemSeconds indicates the timestamp in the audio where the problem appears.

post/issues

Headers

x-api-keystring required

API Key

Request body

generationIdstring required

ID of the generation that has the problem

generatedTextstring required

Text that was passed to the TTS endpoint

problemWordstring required

Word (or phrase) that was generated incorrectly

voicePromptIdstring required

ID of the voice prompt used in the generation

additionalCommentsstring

Free-form comments describing the problem

problemAudioFilestring

Optional base64-encoded audio clip to attach to the issue

problemSecondsnumber

Seconds in the audio where the problem appears

Example request

{
  "generationId": "abc123-def456",
  "generatedText": "Hello world, welcome to Deepdub.",
  "problemWord": "Deepdub",
  "voicePromptId": "bd1b00bb-be1c-4679-8eaa-0fcbfd4ff773",
  "additionalComments": "Mispronunciation of brand name",
  "problemSeconds": 2.5
}

Response

Issue created

idstring
statestring

Current state of the issue (e.g., open, in progress, resolved)

createdAtstring date-time
updatedAtstring date-time
generationIdstring
generatedTextstring
problemWordstring
voicePromptIdstring
additionalCommentsstring
problemSecondsnumber

Example response

{
  "id": "iss_12345abcde",
  "state": "open"
}