메인 콘텐츠로 건너뛰기
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": "b2d1ab32-3fe2-4201-b0b4-391abdbaa023",
  "uploadUri": "https://storage.example.com/upload/signed-url-abc123"
}

인증

​
Authorization
string
header
필수

API key in format {id}.{secret}

본문

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
예시:
["en_US"]
​
translationLocales
string[]

Optional locales for translation (max 5)

Maximum array length: 5
예시:
["ko_KR", "ja_JP"]

응답

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
필수

Unique job identifier (UUID format). Use this ID in subsequent API calls.

예시:

"b2d1ab32-3fe2-4201-b0b4-391abdbaa023"

​
uploadUri
string<uri>
필수

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)
예시:

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