{"openapi":"3.0.3","info":{"title":"Phonetico API","version":"1","description":"Speech recognition, transcription jobs and speech synthesis for Ethiopian languages. Authenticate with an API key as Authorization: Bearer <key>. Languages and features available now: GET /v1/capabilities. Enforced limits: GET /v1/asr/limits and GET /v1/tts/limits. Guides and error codes: /docs."},"servers":[{"url":"https://api.phonetico.ai"}],"paths":{"/v1/asr":{"post":{"operationId":"transcribe","summary":"Transcribe a short clip (base64 JSON)","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"audio":{"type":"string","minLength":1},"model":{"type":"string","pattern":"^[a-z][a-z0-9]*(-[a-z][a-z0-9]*)*(-[1-9][0-9]*(-[0-9]{8})?)?$","maxLength":80},"localeCode":{"type":"string","minLength":2,"maxLength":10},"wordTimestamps":{"type":"boolean"},"diarize":{"type":"boolean"},"retainTranscript":{"type":"boolean"}},"required":["audio"],"additionalProperties":false}}},"required":true},"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string"},"transcript":{"type":"string"},"localeCode":{"type":"string"},"latencyMs":{"type":"number"},"audioDurationMs":{"type":"number"},"confidence":{"type":"number"},"speakerCount":{"type":"number"},"transcriptRetainedUntil":{"type":"string","nullable":true},"wordTimestamps":{"type":"array","items":{"type":"object","properties":{"word":{"type":"string"},"start":{"type":"number"},"end":{"type":"number"},"confidence":{"type":"number","nullable":true},"speaker":{"type":"number"}}}},"speakerSegments":{"type":"array","items":{"type":"object","properties":{"speaker":{"type":"number"},"start":{"type":"number"},"end":{"type":"number"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true},"detail":{"type":"string"},"usageId":{"type":"string","nullable":true}},"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true},"detail":{"type":"string"},"usageId":{"type":"string","nullable":true}},"additionalProperties":true}}}},"413":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true},"detail":{"type":"string"},"usageId":{"type":"string","nullable":true}},"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true},"detail":{"type":"string"},"usageId":{"type":"string","nullable":true}},"additionalProperties":true}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true},"detail":{"type":"string"},"usageId":{"type":"string","nullable":true}},"additionalProperties":true}}}}}}},"/v1/asr/upload":{"post":{"operationId":"transcribeUpload","summary":"Transcribe a short file (multipart upload)","security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string"},"transcript":{"type":"string"},"localeCode":{"type":"string"},"latencyMs":{"type":"number"},"audioDurationMs":{"type":"number"},"confidence":{"type":"number"},"speakerCount":{"type":"number"},"transcriptRetainedUntil":{"type":"string","nullable":true},"wordTimestamps":{"type":"array","items":{"type":"object","properties":{"word":{"type":"string"},"start":{"type":"number"},"end":{"type":"number"},"confidence":{"type":"number","nullable":true},"speaker":{"type":"number"}}}},"speakerSegments":{"type":"array","items":{"type":"object","properties":{"speaker":{"type":"number"},"start":{"type":"number"},"end":{"type":"number"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true},"detail":{"type":"string"},"usageId":{"type":"string","nullable":true}},"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true},"detail":{"type":"string"},"usageId":{"type":"string","nullable":true}},"additionalProperties":true}}}},"413":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true},"detail":{"type":"string"},"usageId":{"type":"string","nullable":true}},"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true},"detail":{"type":"string"},"usageId":{"type":"string","nullable":true}},"additionalProperties":true}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true},"detail":{"type":"string"},"usageId":{"type":"string","nullable":true}},"additionalProperties":true}}}}}}},"/v1/asr/stream":{"get":{"operationId":"transcribeStream","summary":"Streaming transcription (WebSocket; the API key goes in the init message)","responses":{"200":{"description":"Default Response"}},"security":[]}},"/v1/asr/limits":{"get":{"operationId":"getAsrLimits","summary":"Transcription, key and job limits enforced now","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"maxFileSizeBytes":{"type":"number"},"maxAudioDurationSeconds":{"type":"number"},"requestsPerMinute":{"type":"number"},"requestsPerHour":{"type":"number"},"upstreamTimeoutMs":{"type":"number"},"streamInitTimeoutSeconds":{"type":"number"},"maxActiveKeysPerAccount":{"type":"number"},"maxKeyExpiryDays":{"type":"number"},"keyRotationGraceMinutes":{"type":"number"},"maxActiveJobsPerAccount":{"type":"number"},"jobMaxDurationSeconds":{"type":"number"},"jobMaxUploadBytes":{"type":"number"},"jobUploadPartBytes":{"type":"number"},"jobUploadWindowHours":{"type":"number"},"jobResultPickupHours":{"type":"number"},"webhookTimeoutSeconds":{"type":"number"},"webhookMaxAttempts":{"type":"number"},"webhookFirstRetrySeconds":{"type":"number"}}}}}}},"security":[]}},"/v1/asr/jobs":{"post":{"operationId":"createJob","summary":"Create a transcription job (from an upload or a public URL)","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","pattern":"^[a-z][a-z0-9]*(-[a-z][a-z0-9]*)*(-[1-9][0-9]*(-[0-9]{8})?)?$","maxLength":80},"localeCode":{"type":"string","minLength":2,"maxLength":12},"name":{"type":"string","maxLength":1020},"options":{"type":"object","properties":{"wordTimestamps":{"type":"boolean"},"diarize":{"type":"boolean"},"retainTranscript":{"type":"boolean"}},"additionalProperties":false,"default":{}},"webhookUrl":{"type":"string","minLength":1,"maxLength":2048},"source":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["upload"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["url"]},"url":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","url"],"additionalProperties":false}]},"translation":{"type":"object","properties":{"targets":{"type":"array","items":{"type":"string","minLength":2,"maxLength":3},"minItems":1,"maxItems":50},"shareAudio":{"type":"boolean"},"notes":{"type":"string","maxLength":20000,"nullable":true},"consentVersion":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["targets","shareAudio","consentVersion"],"additionalProperties":false}},"required":["source"],"additionalProperties":false}}},"required":true},"security":[{"apiKey":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"job":{"type":"object","properties":{"jobId":{"type":"string"},"status":{"type":"string"},"model":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"localeCode":{"type":"string"},"options":{"type":"object","properties":{"wordTimestamps":{"type":"boolean"},"diarize":{"type":"boolean"},"retainTranscript":{"type":"boolean"}}},"sourceKind":{"type":"string"},"progress":{"type":"number"},"audioDurationMs":{"type":"number","nullable":true},"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object","nullable":true},"createdAt":{"type":"string"},"queuedAt":{"type":"string","nullable":true},"startedAt":{"type":"string","nullable":true},"finishedAt":{"type":"string","nullable":true},"deletedAt":{"type":"string","nullable":true},"webhookUrl":{"type":"string","nullable":true},"translationOf":{"type":"string","nullable":true},"transcriptRetainedUntil":{"type":"string","nullable":true},"cost":{"properties":{"amount":{"type":"number"},"freeMinutes":{"type":"number"}},"type":"object","nullable":true},"translationTargets":{"type":"array","items":{"type":"string"}}}},"upload":{"properties":{"maxBytes":{"type":"number"},"partBytes":{"type":"number"},"maxParts":{"type":"number"},"urlTtlSeconds":{"type":"number"}},"type":"object","nullable":true}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true}},"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true}},"additionalProperties":true}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"get":{"operationId":"listJobs","summary":"List jobs, newest first","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","maxLength":200},"in":"query","name":"before","required":false}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"jobs":{"type":"array","items":{"type":"object","properties":{"jobId":{"type":"string"},"status":{"type":"string"},"model":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"localeCode":{"type":"string"},"options":{"type":"object","properties":{"wordTimestamps":{"type":"boolean"},"diarize":{"type":"boolean"},"retainTranscript":{"type":"boolean"}}},"sourceKind":{"type":"string"},"progress":{"type":"number"},"audioDurationMs":{"type":"number","nullable":true},"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object","nullable":true},"createdAt":{"type":"string"},"queuedAt":{"type":"string","nullable":true},"startedAt":{"type":"string","nullable":true},"finishedAt":{"type":"string","nullable":true},"deletedAt":{"type":"string","nullable":true},"webhookUrl":{"type":"string","nullable":true},"translationOf":{"type":"string","nullable":true},"transcriptRetainedUntil":{"type":"string","nullable":true},"cost":{"properties":{"amount":{"type":"number"},"freeMinutes":{"type":"number"}},"type":"object","nullable":true},"translationTargets":{"type":"array","items":{"type":"string"}}}}},"nextCursor":{"type":"string","nullable":true}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}}}},"/v1/asr/jobs/{id}/upload/parts":{"post":{"operationId":"createUploadPartUrls","summary":"Presigned URLs for upload parts","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"partNumbers":{"type":"array","items":{"type":"integer","exclusiveMinimum":true,"minimum":0},"minItems":1,"maxItems":100}},"required":["partNumbers"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"parts":{"type":"array","items":{"type":"object","properties":{"partNumber":{"type":"number"},"url":{"type":"string"}}}},"expiresAt":{"type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}}},"get":{"operationId":"listUploadedParts","summary":"Upload parts stored so far (to resume)","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"parts":{"type":"array","items":{"type":"object","properties":{"partNumber":{"type":"number"},"size":{"type":"number"}}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}}}},"/v1/asr/jobs/{id}/upload/complete":{"post":{"operationId":"completeUpload","summary":"Finish the upload; the job is queued","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"jobId":{"type":"string"},"status":{"type":"string"},"model":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"localeCode":{"type":"string"},"options":{"type":"object","properties":{"wordTimestamps":{"type":"boolean"},"diarize":{"type":"boolean"},"retainTranscript":{"type":"boolean"}}},"sourceKind":{"type":"string"},"progress":{"type":"number"},"audioDurationMs":{"type":"number","nullable":true},"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object","nullable":true},"createdAt":{"type":"string"},"queuedAt":{"type":"string","nullable":true},"startedAt":{"type":"string","nullable":true},"finishedAt":{"type":"string","nullable":true},"deletedAt":{"type":"string","nullable":true},"webhookUrl":{"type":"string","nullable":true},"translationOf":{"type":"string","nullable":true},"transcriptRetainedUntil":{"type":"string","nullable":true},"cost":{"properties":{"amount":{"type":"number"},"freeMinutes":{"type":"number"}},"type":"object","nullable":true},"translationTargets":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}}}},"/v1/asr/jobs/translation-options":{"get":{"operationId":"getTranslationOptions","summary":"Professional translation a job in this language may ask for","parameters":[{"schema":{"type":"string","minLength":2,"maxLength":12},"in":"query","name":"localeCode","required":true},{"schema":{"type":"integer","minimum":1,"maximum":2147483647},"in":"query","name":"audioDurationMs","required":false}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"offered":{"type":"boolean"},"reason":{"type":"string","nullable":true},"consent":{"properties":{"title":{"type":"string"},"version":{"type":"number"},"effectiveDate":{"type":"string"},"url":{"type":"string"}},"type":"object","nullable":true},"targets":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"price":{"properties":{"centsPerMinute":{"type":"number"},"minimumCents":{"type":"number"}},"type":"object","nullable":true},"estimateCents":{"type":"number","nullable":true}}}},"schedule":{"type":"object","properties":{"dueDays":{"type":"number"},"graceDays":{"type":"number"}}}}}}}}}}},"/v1/asr/jobs/{id}":{"get":{"operationId":"getJob","summary":"Get a job","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"jobId":{"type":"string"},"status":{"type":"string"},"model":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"localeCode":{"type":"string"},"options":{"type":"object","properties":{"wordTimestamps":{"type":"boolean"},"diarize":{"type":"boolean"},"retainTranscript":{"type":"boolean"}}},"sourceKind":{"type":"string"},"progress":{"type":"number"},"audioDurationMs":{"type":"number","nullable":true},"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object","nullable":true},"createdAt":{"type":"string"},"queuedAt":{"type":"string","nullable":true},"startedAt":{"type":"string","nullable":true},"finishedAt":{"type":"string","nullable":true},"deletedAt":{"type":"string","nullable":true},"webhookUrl":{"type":"string","nullable":true},"translationOf":{"type":"string","nullable":true},"transcriptRetainedUntil":{"type":"string","nullable":true},"cost":{"properties":{"amount":{"type":"number"},"freeMinutes":{"type":"number"}},"type":"object","nullable":true},"translationTargets":{"type":"array","items":{"type":"string"}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}}},"delete":{"operationId":"deleteJobResult","summary":"Delete an ended job's result (the job stays as the record of its charge)","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"jobId":{"type":"string"},"status":{"type":"string"},"model":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"localeCode":{"type":"string"},"options":{"type":"object","properties":{"wordTimestamps":{"type":"boolean"},"diarize":{"type":"boolean"},"retainTranscript":{"type":"boolean"}}},"sourceKind":{"type":"string"},"progress":{"type":"number"},"audioDurationMs":{"type":"number","nullable":true},"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object","nullable":true},"createdAt":{"type":"string"},"queuedAt":{"type":"string","nullable":true},"startedAt":{"type":"string","nullable":true},"finishedAt":{"type":"string","nullable":true},"deletedAt":{"type":"string","nullable":true},"webhookUrl":{"type":"string","nullable":true},"translationOf":{"type":"string","nullable":true},"transcriptRetainedUntil":{"type":"string","nullable":true},"cost":{"properties":{"amount":{"type":"number"},"freeMinutes":{"type":"number"}},"type":"object","nullable":true},"translationTargets":{"type":"array","items":{"type":"string"}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}}}},"/v1/asr/jobs/{id}/cancel":{"post":{"operationId":"cancelJob","summary":"Cancel an unfinished job","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"jobId":{"type":"string"},"status":{"type":"string"},"model":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"localeCode":{"type":"string"},"options":{"type":"object","properties":{"wordTimestamps":{"type":"boolean"},"diarize":{"type":"boolean"},"retainTranscript":{"type":"boolean"}}},"sourceKind":{"type":"string"},"progress":{"type":"number"},"audioDurationMs":{"type":"number","nullable":true},"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object","nullable":true},"createdAt":{"type":"string"},"queuedAt":{"type":"string","nullable":true},"startedAt":{"type":"string","nullable":true},"finishedAt":{"type":"string","nullable":true},"deletedAt":{"type":"string","nullable":true},"webhookUrl":{"type":"string","nullable":true},"translationOf":{"type":"string","nullable":true},"transcriptRetainedUntil":{"type":"string","nullable":true},"cost":{"properties":{"amount":{"type":"number"},"freeMinutes":{"type":"number"}},"type":"object","nullable":true},"translationTargets":{"type":"array","items":{"type":"string"}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}}}},"/v1/asr/jobs/{id}/translation":{"post":{"operationId":"requestJobTranslation","summary":"Ask for a professional translation of a finished job","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"targets":{"type":"array","items":{"type":"string","minLength":2,"maxLength":3},"minItems":1,"maxItems":50},"shareAudio":{"type":"boolean"},"notes":{"type":"string","maxLength":20000,"nullable":true},"consentVersion":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["targets","shareAudio","consentVersion"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"requests":{"type":"array","items":{"type":"object","properties":{"requestId":{"type":"string"},"targetLanguage":{"type":"string"},"status":{"type":"string"}}}},"job":{"anyOf":[{"type":"object","properties":{"jobId":{"type":"string"},"status":{"type":"string"},"model":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"localeCode":{"type":"string"},"options":{"type":"object","properties":{"wordTimestamps":{"type":"boolean"},"diarize":{"type":"boolean"},"retainTranscript":{"type":"boolean"}}},"sourceKind":{"type":"string"},"progress":{"type":"number"},"audioDurationMs":{"type":"number","nullable":true},"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object","nullable":true},"createdAt":{"type":"string"},"queuedAt":{"type":"string","nullable":true},"startedAt":{"type":"string","nullable":true},"finishedAt":{"type":"string","nullable":true},"deletedAt":{"type":"string","nullable":true},"webhookUrl":{"type":"string","nullable":true},"translationOf":{"type":"string","nullable":true},"transcriptRetainedUntil":{"type":"string","nullable":true},"cost":{"properties":{"amount":{"type":"number"},"freeMinutes":{"type":"number"}},"type":"object","nullable":true},"translationTargets":{"type":"array","items":{"type":"string"}}}},{"type":"null"}]},"upload":{"properties":{"maxBytes":{"type":"number"},"partBytes":{"type":"number"},"maxParts":{"type":"number"},"urlTtlSeconds":{"type":"number"}},"type":"object","nullable":true}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}}}},"/v1/asr/jobs/{id}/result":{"get":{"operationId":"getJobResult","summary":"Get the result as JSON, TXT, SRT, VTT or DOCX","parameters":[{"schema":{"type":"string","enum":["json","txt","srt","vtt","docx"],"default":"json"},"in":"query","name":"format","required":false},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}}}},"/v1/asr/jobs/{id}/speakers":{"put":{"operationId":"renameSpeakers","summary":"Name the result's speakers","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"speakerNames":{"type":"object","additionalProperties":{"type":"string","maxLength":1000}}},"required":["speakerNames"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}}}},"/v1/asr/jobs/{id}/webhook-deliveries":{"get":{"operationId":"listWebhookDeliveries","summary":"Attempts to deliver the job's webhook","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"deliveries":{"type":"array","items":{"type":"object","properties":{"deliveryId":{"type":"string"},"event":{"type":"string"},"requestId":{"type":"string","nullable":true},"url":{"type":"string"},"attempt":{"type":"number"},"statusCode":{"type":"number","nullable":true},"error":{"type":"string","nullable":true},"responseExcerpt":{"type":"string","nullable":true},"createdAt":{"type":"string"}}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}}}},"/v1/asr/jobs/{id}/translations":{"get":{"operationId":"listJobTranslations","summary":"The job's professional translations and their status","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"translations":{"type":"array","items":{"type":"object","properties":{"requestId":{"type":"string"},"jobId":{"type":"string"},"targetLanguage":{"type":"string"},"targetName":{"type":"string"},"status":{"type":"string","enum":["in_progress","completed","cancelled","failed"]},"audioPermitted":{"type":"boolean"},"quotedCents":{"type":"number","nullable":true},"chargedCents":{"type":"number","nullable":true},"requestedAt":{"type":"string"},"endedAt":{"type":"string","nullable":true},"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object","nullable":true},"file":{"properties":{"fileName":{"type":"string"},"contentType":{"type":"string"},"retainedUntil":{"type":"string","nullable":true}},"type":"object","nullable":true}}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}}}},"/v1/asr/jobs/{id}/translations/{requestId}/file":{"get":{"operationId":"getJobTranslationFile","summary":"Download a completed translation","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"requestId","required":true}],"security":[{"apiKey":[]}],"responses":{"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}}}},"/v1/tts":{"post":{"operationId":"synthesize","summary":"Synthesize speech with a preset or custom voice","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","pattern":"^[a-z][a-z0-9]*(-[a-z][a-z0-9]*)*(-[1-9][0-9]*(-[0-9]{8})?)?$","maxLength":80},"text":{"type":"string","minLength":1},"language":{"type":"string","minLength":2,"maxLength":10},"voice":{"type":"object","properties":{"preset":{"type":"string","minLength":1},"saved":{"type":"string","format":"uuid"},"reference":{"type":"object","properties":{"audio":{"type":"string","minLength":1},"transcript":{"type":"string","minLength":1},"rightsAttestation":{"type":"boolean","enum":[true]}},"required":["audio","transcript","rightsAttestation"],"additionalProperties":false}},"additionalProperties":false},"options":{"type":"object","properties":{"qualityTier":{"type":"string","minLength":1,"maxLength":40},"format":{"type":"string","enum":["wav"]},"seed":{"type":"integer"},"speed":{"type":"number","exclusiveMinimum":true,"minimum":0},"instruction":{"type":"string","minLength":1,"maxLength":2000},"delivery":{"type":"string","minLength":1,"maxLength":40}},"additionalProperties":false}},"required":["text","voice"],"additionalProperties":false}}},"required":true},"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["model","audio","format","sampleRate","outputAudioDurationMs","latencyMs","rtf","voice","seed","qualityTier","delivery"],"properties":{"model":{"type":"string"},"audio":{"type":"string"},"format":{"type":"string"},"sampleRate":{"type":"number"},"outputAudioDurationMs":{"type":"number"},"latencyMs":{"type":"number"},"rtf":{"type":"number"},"voice":{"type":"string"},"seed":{"type":"number"},"qualityTier":{"type":"string","nullable":true},"delivery":{"type":"string","nullable":true}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true}},"additionalProperties":true}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true}},"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true}},"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true}},"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true}},"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true}},"additionalProperties":true}}}},"413":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true}},"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true}},"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true}},"additionalProperties":true}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true}},"additionalProperties":true}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true}},"additionalProperties":true}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}}},"/v1/tts/voices":{"get":{"operationId":"listVoices","summary":"Preset voices","parameters":[{"schema":{"type":"string"},"in":"query","name":"language","required":false}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["voices"],"properties":{"voices":{"type":"array","items":{"type":"object","required":["voiceId","displayName","language","consentScope"],"properties":{"voiceId":{"type":"string"},"displayName":{"type":"string"},"language":{"type":"string"},"gender":{"type":"string","nullable":true},"accentRegion":{"type":"string","nullable":true},"register":{"type":"string","nullable":true},"consentScope":{"type":"string"}}}}}}}}}}}},"/v1/tts/voices/previews":{"get":{"operationId":"listVoicePreviews","summary":"Voices you can hear before choosing","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["previews"],"properties":{"previews":{"type":"array","items":{"type":"object","required":["voiceId","displayName","language","text"],"properties":{"voiceId":{"type":"string"},"displayName":{"type":"string"},"language":{"type":"string"},"gender":{"type":"string","nullable":true},"text":{"type":"string"}}}}}}}}}},"security":[]}},"/v1/tts/voices/{voiceId}/preview":{"get":{"operationId":"getVoicePreview","summary":"Hear a preset voice","parameters":[{"schema":{"type":"string"},"in":"query","name":"model","required":false},{"schema":{"type":"string"},"in":"query","name":"tier","required":false},{"schema":{"type":"string","pattern":"^[a-z][a-z0-9_-]{1,63}$"},"in":"path","name":"voiceId","required":true}],"responses":{"200":{"description":"Default Response"}},"security":[]}},"/v1/tts/saved-voices":{"get":{"operationId":"listSavedVoices","summary":"Your saved voices","security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["voices"],"properties":{"voices":{"type":"array","items":{"type":"object","properties":{"voiceId":{"type":"string"},"name":{"type":"string"},"language":{"type":"string"},"transcript":{"type":"string"},"description":{"type":"string","nullable":true},"speaker":{"type":"string","nullable":true},"clipDurationMs":{"type":"number"},"createdAt":{"type":"string"},"consent":{"type":"object","properties":{"documentVersion":{"type":"number"},"agreedAt":{"type":"string"}}}}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}}}},"/v1/tts/limits":{"get":{"operationId":"getTtsLimits","summary":"Speech synthesis limits enforced now, overall or for one model","parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"model","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","nullable":true},"maxTextLengthChars":{"type":"number"},"absoluteMaxTextLengthChars":{"type":"number"},"maxReferenceAudioBytes":{"type":"number"},"absoluteMaxReferenceAudioBytes":{"type":"number"},"upstreamTimeoutMs":{"type":"number"},"freeTierMonthlyChars":{"type":"number"},"premiumTierMonthlyChars":{"type":"number"},"premiumTierDailyChars":{"type":"number"},"deviceMaxReferenceAudioSeconds":{"type":"number"},"speedMin":{"type":"number"},"speedMax":{"type":"number"},"speedStep":{"type":"number"},"maxActiveJobsPerAccount":{"type":"number"},"jobMaxSynthesisSeconds":{"type":"number"},"jobUnretainedAudioHours":{"type":"number"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true}},"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true}},"additionalProperties":true}}}}},"security":[]}},"/v1/tts/usage":{"get":{"operationId":"getTtsUsage","summary":"This key's speech synthesis usage and quota","security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["entitlement","monthly"],"properties":{"entitlement":{"type":"string","enum":["free","premium","developer"]},"monthly":{"type":"object","required":["used","cap","period"],"properties":{"used":{"type":"number"},"cap":{"type":"number","nullable":true},"period":{"type":"object","required":["start","end"],"properties":{"start":{"type":"string"},"end":{"type":"string"}}}}},"daily":{"type":"object","required":["used","cap","period"],"properties":{"used":{"type":"number"},"cap":{"type":"number","nullable":true},"period":{"type":"object","required":["start","end"],"properties":{"start":{"type":"string"},"end":{"type":"string"}}}},"nullable":true}}}}}}}}},"/v1/tts/jobs":{"post":{"operationId":"createSpeechJob","summary":"Create a speech synthesis job","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","pattern":"^[a-z][a-z0-9]*(-[a-z][a-z0-9]*)*(-[1-9][0-9]*(-[0-9]{8})?)?$","maxLength":80},"text":{"type":"string","minLength":1},"language":{"type":"string","minLength":2,"maxLength":10},"voice":{"type":"object","properties":{"preset":{"type":"string","minLength":1},"saved":{"type":"string","format":"uuid"},"reference":{"type":"object","properties":{"audio":{"type":"string","minLength":1},"transcript":{"type":"string","minLength":1},"rightsAttestation":{"type":"boolean","enum":[true]}},"required":["audio","transcript","rightsAttestation"],"additionalProperties":false}},"additionalProperties":false},"options":{"type":"object","properties":{"qualityTier":{"type":"string","minLength":1,"maxLength":40},"format":{"type":"string","enum":["wav"]},"seed":{"type":"integer"},"speed":{"type":"number","exclusiveMinimum":true,"minimum":0},"instruction":{"type":"string","minLength":1,"maxLength":2000},"delivery":{"type":"string","minLength":1,"maxLength":40},"retainAudio":{"type":"boolean"}},"additionalProperties":false},"name":{"type":"string","maxLength":1020},"webhookUrl":{"type":"string","minLength":1,"maxLength":2048}},"required":["text","voice"],"additionalProperties":false}}},"required":true},"security":[{"apiKey":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"job":{"type":"object","properties":{"jobId":{"type":"string"},"status":{"type":"string"},"model":{"type":"string"},"name":{"type":"string","nullable":true},"language":{"type":"string"},"text":{"type":"string"},"characters":{"type":"number"},"options":{"type":"object","properties":{"qualityTier":{"type":"string","nullable":true},"seed":{"type":"number"},"speed":{"type":"number"},"instruction":{"type":"string"},"delivery":{"type":"string"},"retainAudio":{"type":"boolean"}}},"voice":{"type":"object","properties":{"kind":{"type":"string"},"voiceId":{"type":"string"}}},"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object","nullable":true},"createdAt":{"type":"string"},"queuedAt":{"type":"string","nullable":true},"startedAt":{"type":"string","nullable":true},"finishedAt":{"type":"string","nullable":true},"deletedAt":{"type":"string","nullable":true},"webhookUrl":{"type":"string","nullable":true},"audio":{"properties":{"durationMs":{"type":"number"},"sampleRate":{"type":"number"},"seed":{"type":"number","nullable":true},"retainedUntil":{"type":"string"}},"type":"object","nullable":true},"cost":{"properties":{"amount":{"type":"number"}},"type":"object","nullable":true}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true}},"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true}},"additionalProperties":true}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"reason":{"type":"string"},"successor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"get":{"operationId":"listSpeechJobs","summary":"List speech jobs, newest first","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","maxLength":200},"in":"query","name":"before","required":false}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"jobs":{"type":"array","items":{"type":"object","properties":{"jobId":{"type":"string"},"status":{"type":"string"},"model":{"type":"string"},"name":{"type":"string","nullable":true},"language":{"type":"string"},"text":{"type":"string"},"characters":{"type":"number"},"options":{"type":"object","properties":{"qualityTier":{"type":"string","nullable":true},"seed":{"type":"number"},"speed":{"type":"number"},"instruction":{"type":"string"},"delivery":{"type":"string"},"retainAudio":{"type":"boolean"}}},"voice":{"type":"object","properties":{"kind":{"type":"string"},"voiceId":{"type":"string"}}},"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object","nullable":true},"createdAt":{"type":"string"},"queuedAt":{"type":"string","nullable":true},"startedAt":{"type":"string","nullable":true},"finishedAt":{"type":"string","nullable":true},"deletedAt":{"type":"string","nullable":true},"webhookUrl":{"type":"string","nullable":true},"audio":{"properties":{"durationMs":{"type":"number"},"sampleRate":{"type":"number"},"seed":{"type":"number","nullable":true},"retainedUntil":{"type":"string"}},"type":"object","nullable":true},"cost":{"properties":{"amount":{"type":"number"}},"type":"object","nullable":true}}}},"nextCursor":{"type":"string","nullable":true}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}}}},"/v1/tts/jobs/counts":{"get":{"operationId":"countSpeechJobs","summary":"Speech jobs unfinished now and created this month","security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"active":{"type":"number"},"thisMonth":{"type":"number"},"limit":{"type":"number"}}}}}}}}},"/v1/tts/jobs/{id}":{"get":{"operationId":"getSpeechJob","summary":"A speech job","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"jobId":{"type":"string"},"status":{"type":"string"},"model":{"type":"string"},"name":{"type":"string","nullable":true},"language":{"type":"string"},"text":{"type":"string"},"characters":{"type":"number"},"options":{"type":"object","properties":{"qualityTier":{"type":"string","nullable":true},"seed":{"type":"number"},"speed":{"type":"number"},"instruction":{"type":"string"},"delivery":{"type":"string"},"retainAudio":{"type":"boolean"}}},"voice":{"type":"object","properties":{"kind":{"type":"string"},"voiceId":{"type":"string"}}},"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object","nullable":true},"createdAt":{"type":"string"},"queuedAt":{"type":"string","nullable":true},"startedAt":{"type":"string","nullable":true},"finishedAt":{"type":"string","nullable":true},"deletedAt":{"type":"string","nullable":true},"webhookUrl":{"type":"string","nullable":true},"audio":{"properties":{"durationMs":{"type":"number"},"sampleRate":{"type":"number"},"seed":{"type":"number","nullable":true},"retainedUntil":{"type":"string"}},"type":"object","nullable":true},"cost":{"properties":{"amount":{"type":"number"}},"type":"object","nullable":true}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}}},"delete":{"operationId":"deleteSpeechJob","summary":"Delete an ended speech job's audio","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"jobId":{"type":"string"},"status":{"type":"string"},"model":{"type":"string"},"name":{"type":"string","nullable":true},"language":{"type":"string"},"text":{"type":"string"},"characters":{"type":"number"},"options":{"type":"object","properties":{"qualityTier":{"type":"string","nullable":true},"seed":{"type":"number"},"speed":{"type":"number"},"instruction":{"type":"string"},"delivery":{"type":"string"},"retainAudio":{"type":"boolean"}}},"voice":{"type":"object","properties":{"kind":{"type":"string"},"voiceId":{"type":"string"}}},"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object","nullable":true},"createdAt":{"type":"string"},"queuedAt":{"type":"string","nullable":true},"startedAt":{"type":"string","nullable":true},"finishedAt":{"type":"string","nullable":true},"deletedAt":{"type":"string","nullable":true},"webhookUrl":{"type":"string","nullable":true},"audio":{"properties":{"durationMs":{"type":"number"},"sampleRate":{"type":"number"},"seed":{"type":"number","nullable":true},"retainedUntil":{"type":"string"}},"type":"object","nullable":true},"cost":{"properties":{"amount":{"type":"number"}},"type":"object","nullable":true}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}}}},"/v1/tts/jobs/{id}/audio":{"get":{"operationId":"getSpeechJobAudio","summary":"A speech job's audio (WAV)","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}}}},"/v1/tts/jobs/{id}/cancel":{"post":{"operationId":"cancelSpeechJob","summary":"Cancel an unfinished speech job","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"jobId":{"type":"string"},"status":{"type":"string"},"model":{"type":"string"},"name":{"type":"string","nullable":true},"language":{"type":"string"},"text":{"type":"string"},"characters":{"type":"number"},"options":{"type":"object","properties":{"qualityTier":{"type":"string","nullable":true},"seed":{"type":"number"},"speed":{"type":"number"},"instruction":{"type":"string"},"delivery":{"type":"string"},"retainAudio":{"type":"boolean"}}},"voice":{"type":"object","properties":{"kind":{"type":"string"},"voiceId":{"type":"string"}}},"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object","nullable":true},"createdAt":{"type":"string"},"queuedAt":{"type":"string","nullable":true},"startedAt":{"type":"string","nullable":true},"finishedAt":{"type":"string","nullable":true},"deletedAt":{"type":"string","nullable":true},"webhookUrl":{"type":"string","nullable":true},"audio":{"properties":{"durationMs":{"type":"number"},"sampleRate":{"type":"number"},"seed":{"type":"number","nullable":true},"retainedUntil":{"type":"string"}},"type":"object","nullable":true},"cost":{"properties":{"amount":{"type":"number"}},"type":"object","nullable":true}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}}}},"/v1/tts/jobs/{id}/webhook-deliveries":{"get":{"operationId":"listSpeechWebhookDeliveries","summary":"Attempts to deliver the speech job's webhook","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"deliveries":{"type":"array","items":{"type":"object","properties":{"deliveryId":{"type":"string"},"event":{"type":"string"},"requestId":{"type":"string","nullable":true},"url":{"type":"string"},"attempt":{"type":"number"},"statusCode":{"type":"number","nullable":true},"error":{"type":"string","nullable":true},"responseExcerpt":{"type":"string","nullable":true},"createdAt":{"type":"string"}}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}}}},"/v1/capabilities":{"get":{"operationId":"getCapabilities","summary":"Languages and features available now, with their stage","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["features","languages"],"properties":{"features":{"type":"array","items":{"type":"object","required":["code","name","description"],"properties":{"code":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"}}}},"languages":{"type":"array","items":{"type":"object","required":["code","name","script","features","models","defaultModels"],"properties":{"models":{"type":"array","items":{"type":"string"}},"defaultModels":{"type":"object","required":["asr","tts"],"properties":{"asr":{"type":"string","nullable":true},"tts":{"type":"string","nullable":true}}},"code":{"type":"string"},"name":{"type":"string"},"nativeName":{"type":"string","nullable":true},"script":{"type":"string"},"features":{"type":"array","items":{"type":"object","required":["feature","stage","available"],"properties":{"feature":{"type":"string"},"stage":{"type":"string","enum":["stable","beta"]},"available":{"type":"boolean"}}}}}}}}}}}}},"security":[]}},"/v1/models":{"get":{"operationId":"listModels","summary":"Models available to call, with their languages, options, limits and prices","parameters":[{"schema":{"type":"string","enum":["asr","tts"]},"in":"query","name":"service","required":false},{"schema":{"type":"string"},"in":"query","name":"language","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["models"],"properties":{"models":{"type":"array","items":{"type":"object","required":["id","service","family","generation","displayName","description","releasedOn","aliases","languages","defaultFor","stage","available","deprecatedAt","retiresAt","successor","controls","limits","pricing"],"properties":{"id":{"type":"string"},"service":{"type":"string","enum":["asr","tts"]},"family":{"type":"string"},"generation":{"type":"number"},"displayName":{"type":"string"},"description":{"type":"string"},"releasedOn":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"}},"defaultFor":{"type":"array","items":{"type":"string"}},"stage":{"type":"string","enum":["stable","beta"]},"available":{"type":"boolean"},"deprecatedAt":{"type":"string","nullable":true},"retiresAt":{"type":"string","nullable":true},"successor":{"type":"string","nullable":true},"controls":{"type":"object","properties":{"seed":{"type":"boolean"},"customVoice":{"type":"boolean"},"speed":{"type":"object","properties":{"min":{"type":"number"},"max":{"type":"number"},"step":{"type":"number"}}},"qualityTiers":{"type":"object","properties":{"default":{"type":"string"},"tiers":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"costMultiplier":{"type":"number"}}}}}},"delivery":{"type":"object","properties":{"default":{"type":"string"},"presets":{"type":"array","items":{"type":"string"}},"maxInstructionChars":{"type":"number"}}},"wordTimestamps":{"type":"boolean"},"diarize":{"type":"boolean"}}},"limits":{"type":"object","properties":{"maxTextLengthChars":{"type":"number"},"maxReferenceSeconds":{"type":"number"}}},"pricing":{"type":"object","required":["currency"],"properties":{"currency":{"type":"string","enum":["USD"]},"perMinute":{"type":"number"},"perCharacter":{"type":"number"},"baseCharge":{"type":"number"}}}}}}}}}}}},"security":[]}},"/v1/models/{id}":{"get":{"operationId":"getModel","summary":"One model, by name (phonetico-speak-2) or alias (phonetico-speak)","parameters":[{"schema":{"type":"string","maxLength":80},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["id","service","family","generation","displayName","description","releasedOn","aliases","languages","defaultFor","stage","available","deprecatedAt","retiresAt","successor","controls","limits","pricing"],"properties":{"id":{"type":"string"},"service":{"type":"string","enum":["asr","tts"]},"family":{"type":"string"},"generation":{"type":"number"},"displayName":{"type":"string"},"description":{"type":"string"},"releasedOn":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"}},"defaultFor":{"type":"array","items":{"type":"string"}},"stage":{"type":"string","enum":["stable","beta"]},"available":{"type":"boolean"},"deprecatedAt":{"type":"string","nullable":true},"retiresAt":{"type":"string","nullable":true},"successor":{"type":"string","nullable":true},"controls":{"type":"object","properties":{"seed":{"type":"boolean"},"customVoice":{"type":"boolean"},"speed":{"type":"object","properties":{"min":{"type":"number"},"max":{"type":"number"},"step":{"type":"number"}}},"qualityTiers":{"type":"object","properties":{"default":{"type":"string"},"tiers":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"costMultiplier":{"type":"number"}}}}}},"delivery":{"type":"object","properties":{"default":{"type":"string"},"presets":{"type":"array","items":{"type":"string"}},"maxInstructionChars":{"type":"number"}}},"wordTimestamps":{"type":"boolean"},"diarize":{"type":"boolean"}}},"limits":{"type":"object","properties":{"maxTextLengthChars":{"type":"number"},"maxReferenceSeconds":{"type":"number"}}},"pricing":{"type":"object","required":["currency"],"properties":{"currency":{"type":"string","enum":["USD"]},"perMinute":{"type":"number"},"perCharacter":{"type":"number"},"baseCharge":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}},"security":[]}},"/v1/pricing":{"get":{"operationId":"getPricing","summary":"Prices and the monthly free transcription minutes","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["currency","rates","freeAsrMinutesPerMonth","translationOffered"],"properties":{"currency":{"type":"string","enum":["USD"]},"rates":{"type":"object","required":["models"],"properties":{"models":{"type":"array","items":{"type":"object","required":["model","service","displayName","tierMultipliers"],"properties":{"model":{"type":"string"},"service":{"type":"string","enum":["asr","tts"]},"displayName":{"type":"string"},"perMinute":{"type":"number"},"perCharacter":{"type":"number"},"baseCharge":{"type":"number"},"tierMultipliers":{"additionalProperties":{"type":"number"},"type":"object","nullable":true}}}}}},"freeAsrMinutesPerMonth":{"type":"number"},"translationOffered":{"type":"boolean"}}}}}}},"security":[]}}},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer"}},"schemas":{}}}