Skip to main content
POST
/
v1
/
external
/
voice-file
/
jobs
Create Voice File Job
curl --request POST \
  --url https://api.tiro.ooo/v1/external/voice-file/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "transcriptLocaleHints": [
    "en_US"
  ],
  "translationLocales": [
    "ko_KR",
    "ja_JP"
  ]
}
'
{
  "id": "job_abc123def456",
  "uploadUri": "https://storage.example.com/upload/signed-url-abc123",
  "status": "CREATED",
  "createdAt": "2024-01-15T10:30:00Z",
  "transcriptLocaleHints": [
    "ko_KR"
  ],
  "translationLocales": [
    "en_US"
  ]
}

Authorizations

​
Authorization
string
header
required

API key in format {id}.{secret}

Body

application/json

Optional parameters for transcription and translation.

  • If transcriptLocaleHints is omitted, language is auto-detected from audio
  • If translationLocales is omitted, no translations are generated
​
transcriptLocaleHints
string[]

Locale hints for transcription.

  • Maximum 1 locale
  • If omitted, language is auto-detected from audio content
Maximum array length: 1
Example:
["en_US"]
​
translationLocales
string[]

Optional locales for translation (max 5)

Maximum array length: 5
Example:
["ko_KR", "ja_JP"]

Response

Job created successfully

Response returned when a new Voice File Job is created. Contains the job ID and a presigned URL for uploading the audio file.

Next Steps:

  1. Upload your audio file to uploadUri using HTTP PUT
  2. Call PUT /v1/external/voice-file/jobs/{id}/upload-complete to start processing
​
id
string
required

Unique job identifier. Use this ID in subsequent API calls.

Example:

"job-abc123"

​
uploadUri
string<uri>
required

Presigned URL for uploading the audio file.

  • Use HTTP PUT method to upload
  • URL expires in 1 hour
  • Set appropriate Content-Type header (e.g., audio/mpeg, audio/wav)
Example:

"https://tiro-uploads.s3.amazonaws.com/voice-files/job-abc123?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=..."