Skip to main content
POST
/
issues
Create a new issue
curl --request POST \
  --url https://restapi.deepdub.ai/api/v1/issues \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "generationId": "abc123-def456",
  "generatedText": "Hello world, welcome to Deepdub.",
  "problemWord": "Deepdub",
  "voicePromptId": "bd1b00bb-be1c-4679-8eaa-0fcbfd4ff773"
}
'
{
  "id": "iss_12345abcde",
  "state": "open",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "generationId": "<string>",
  "generatedText": "<string>",
  "problemWord": "<string>",
  "voicePromptId": "<string>",
  "additionalComments": "<string>",
  "problemSeconds": 123
}

​
Reporting generation problems

Use this endpoint to flag a TTS generation that didn’t sound right — a mispronunciation, an unwanted artifact, or any other quality issue. Reports are reviewed by the Deepdub team and feed into model improvements. To make a report actionable, include:
  • generationId — the ID of the affected generation
  • generatedText — the exact text passed to TTS
  • problemWord — the specific word or phrase that was generated incorrectly
  • voicePromptId — the voice prompt that was used
  • problemSeconds — timestamp (in seconds) where the problem occurs
  • problemAudioFile (optional) — base64-encoded clip of the problem audio
  • additionalComments (optional) — anything else that helps reproduce or explain the issue
The response includes an id you can use with the GET, PUT, and DELETE endpoints.

Authorizations

​
x-api-key
string
header
required

API key for authentication. Must start with dd- prefix.

Headers

​
x-api-key
string
default:dd-00000000000000000000000065c9cbfe
required

API Key

Body

application/json

Payload for creating a new issue against a TTS generation

​
generationId
string
required

ID of the generation that has the problem

Example:

"abc123-def456"

​
generatedText
string
required

Text that was passed to the TTS endpoint

Example:

"Hello world, welcome to Deepdub."

​
problemWord
string
required

Word (or phrase) that was generated incorrectly

Example:

"Deepdub"

​
voicePromptId
string
required

ID of the voice prompt used in the generation

Example:

"bd1b00bb-be1c-4679-8eaa-0fcbfd4ff773"

​
additionalComments
string

Free-form comments describing the problem

Example:

"Mispronunciation of brand name"

​
problemAudioFile
string

Optional base64-encoded audio clip to attach to the issue

​
problemSeconds
number

Seconds in the audio where the problem appears

Example:

2.5

Response

Issue created

Issue details

​
id
string
Example:

"iss_12345abcde"

​
state
string

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

Example:

"open"

​
createdAt
string<date-time>
​
updatedAt
string<date-time>
​
generationId
string
​
generatedText
string
​
problemWord
string
​
voicePromptId
string
​
additionalComments
string
​
problemSeconds
number