Skip to main content
POST
Create Voice File Job

인증

Authorization
string
header
필수

API key in format {id}.{secret}.

The notes an endpoint returns depend on the key type. A user key reaches the notes that user can see in the app, including notes in their own private folders. A system key (workspace or organization, no user identity) reaches only notes that sit in a folder shared with all workspace members. Notes in a private folder, in a folder shared with only some members, or in no folder at all fall outside a system key's read scope, and scopes do not widen that boundary.

List and search endpoints drop out-of-scope notes from the response without an error. Single-note reads and their sub-resources return 404, the same response as a deleted note. See What notes a system key reads.

본문

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

Optional locales for translation (max 5)

Maximum array length: 5
예시:

응답

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=..."