Openapi

get

List all API tokens for the authenticated user

Authorizations
AuthorizationstringRequired

'Enter your access token with Bearer prefix, e.g., "Bearer YOUR_API_KEY"'

Responses
200Success
application/json
get
/openapi/auth/token/
GET /openapi/auth/token/ HTTP/1.1
Host: app.timbr.studio
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": 1,
  "result_code": "text",
  "message": "text",
  "data": {
    "tokens": [
      {
        "access_token": "text",
        "token_type": "text",
        "expires_in": 1
      }
    ]
  }
}
post

Issue a new API token

Authorizations
AuthorizationstringRequired

'Enter your access token with Bearer prefix, e.g., "Bearer YOUR_API_KEY"'

Body
grant_typestring · enumRequiredPossible values:
scopestringOptional
client_idstring · uuidRequired
client_secretstring · min: 1Optional
Responses
200Success
application/json
post
/openapi/auth/token/
POST /openapi/auth/token/ HTTP/1.1
Host: app.timbr.studio
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 124

{
  "grant_type": "client_credentials",
  "scope": "text",
  "client_id": "123e4567-e89b-12d3-a456-426614174000",
  "client_secret": "text"
}
{
  "status": 1,
  "result_code": "text",
  "message": "text",
  "data": {
    "access_token": "text",
    "token_type": "text",
    "expires_in": 1
  }
}
post

Delete API tokens

Authorizations
AuthorizationstringRequired

'Enter your access token with Bearer prefix, e.g., "Bearer YOUR_API_KEY"'

Body
api_tokensstring[]Required
Responses
200Success
application/json
post
/openapi/auth/token/delete/
POST /openapi/auth/token/delete/ HTTP/1.1
Host: app.timbr.studio
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "api_tokens": [
    "text"
  ]
}
{
  "status": 1,
  "result_code": "text",
  "message": "text",
  "data": {
    "requested_count": 1,
    "deleted_count": 1
  }
}
post

Audio source seperation

Authorizations
AuthorizationstringRequired

'Enter your access token with Bearer prefix, e.g., "Bearer YOUR_API_KEY"'

Body
file_idstringRequired

File ID

Responses
200Success
application/json
post
/openapi/v1/audio-separation/
POST /openapi/v1/audio-separation/ HTTP/1.1
Host: app.timbr.studio
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 18

{
  "file_id": "text"
}
{
  "status": 1,
  "result_code": "text",
  "message": "text",
  "data": {
    "task_id": "text"
  }
}
get

API user gets credit

Authorizations
AuthorizationstringRequired

'Enter your access token with Bearer prefix, e.g., "Bearer YOUR_API_KEY"'

Responses
200Success
application/json
get
/openapi/v1/credit/
GET /openapi/v1/credit/ HTTP/1.1
Host: app.timbr.studio
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": 1,
  "result_code": "text",
  "message": "text",
  "data": {
    "credit": 1
  }
}
post

View task

Authorizations
AuthorizationstringRequired

'Enter your access token with Bearer prefix, e.g., "Bearer YOUR_API_KEY"'

Body
task_idstringRequired

Task ID

Responses
200Success
application/json
post
/openapi/v1/task/
POST /openapi/v1/task/ HTTP/1.1
Host: app.timbr.studio
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 18

{
  "task_id": "text"
}
{
  "status": 1,
  "result_code": "text",
  "message": "text",
  "data": {
    "source_assets": [
      {
        "id": "text",
        "name": "text",
        "mime_type": "text",
        "extension": "text",
        "link": "text"
      }
    ],
    "output_assets": [
      {
        "id": "text",
        "name": "text",
        "mime_type": "text",
        "extension": "text",
        "link": "text"
      }
    ],
    "status": "text",
    "created_at": "text",
    "updated_at": "text",
    "started_at": "text",
    "error_message": "text"
  }
}
post

Transcription

Authorizations
AuthorizationstringRequired

'Enter your access token with Bearer prefix, e.g., "Bearer YOUR_API_KEY"'

Body
file_idstringRequired

File ID

detect_speakersbooleanRequired

Detect speakers

Default: true
speakersinteger · int32Optional

Number of speakers (0~9, 0 for auto-detect)

speaker_namebooleanOptional

Enable speaker name

denoise_audiobooleanRequired

Denoise audio

Default: false
Responses
200Success
application/json
post
/openapi/v1/transcription/
POST /openapi/v1/transcription/ HTTP/1.1
Host: app.timbr.studio
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 96

{
  "file_id": "text",
  "detect_speakers": true,
  "speakers": 1,
  "speaker_name": true,
  "denoise_audio": false
}
{
  "status": 1,
  "result_code": "text",
  "message": "text",
  "data": {
    "task_id": "text"
  }
}
post

Translation

Authorizations
AuthorizationstringRequired

'Enter your access token with Bearer prefix, e.g., "Bearer YOUR_API_KEY"'

Body
file_idstringRequired

File ID of SRT file

speaker_namebooleanOptional

Enable speaker name

source_languagestringRequired

Source language (en, ko, ja, zh, ca, cs, da, de, el, hu, hi, id, it, lv, mk, ms, nl, pl, pt, ro, ru, sr, sl, es, sv, th, fr, hr, yue)

target_languagestringRequired

Target language (en, ko, ja, es, zh, de, fr, pt, vi, id, ru, hi, ta, hr, el, sv, cs, ro, hu, da, fi, ms, sk)

Responses
200Success
application/json
post
/openapi/v1/translation/
POST /openapi/v1/translation/ HTTP/1.1
Host: app.timbr.studio
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 88

{
  "file_id": "text",
  "speaker_name": true,
  "source_language": "text",
  "target_language": "text"
}
{
  "status": 1,
  "result_code": "text",
  "message": "text",
  "data": {
    "task_id": "text"
  }
}
post

API user uploads a single file

Authorizations
AuthorizationstringRequired

'Enter your access token with Bearer prefix, e.g., "Bearer YOUR_API_KEY"'

Body
filestring · binaryRequired

Upload a file (e.g. @/path/to/file.wav;type=audio/wav)

Responses
200Success
application/json
post
/openapi/v1/upload/file/
POST /openapi/v1/upload/file/ HTTP/1.1
Host: app.timbr.studio
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17

{
  "file": "binary"
}
{
  "status": 1,
  "result_code": "text",
  "message": "text",
  "data": {
    "files": [
      {
        "file_id": "text",
        "expires_at": "text",
        "content_type": "text",
        "file_size": 1,
        "uploaded_size": 1
      }
    ]
  }
}
PreviousApiNextModels

Last updated