Audio Endpoints

POST /api/v1/studio/audio/transcribe

Transcribe audio to text using ElevenLabs Scribe. Takes a JSON body with an audioUrl — the server fetches the audio post-auth, so there is no inbound body-size limit. For local files, upload the bytes first via POST /api/v1/storage/upload-url and pass the returned fileUrl.

Request Body

audioUrlstringrequired

Publicly fetchable (or signed) URL of the audio file to transcribe.

languagestring

Language code (e.g. en, es, fr). Auto-detected if not provided.

fileNamestring

Optional original filename — used only in provider metadata.

Example

curl

curl -X POST https://terramind.com/api/v1/studio/audio/transcribe \
  -H "Authorization: Bearer sk-tm-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audioUrl": "https://example.com/recording.mp3",
    "language": "en"
  }'

Response

JSON

{
  "success": true,
  "data": {
    "text": "Hello, this is a transcription of the audio file...",
    "language_code": "en",
    "words": [
      { "word": "Hello", "start": 0.0, "end": 0.42, "type": "word" }
    ]
  },
  "credits": { "used": 1, "cost": 2.0, "remaining": 9998.0 }
}

POST /api/v1/studio/sfx/generate

Generate a sound effect from a text description using ElevenLabs.

Request Body

promptstringrequired

Description of the sound effect.

titlestringrequired

Title for the sound effect.

durationnumber

Duration in seconds (0.5–22, default: 5).

promptInfluencenumber

How closely to follow the prompt (0–1, default: 0.3).

Example

curl

curl -X POST https://terramind.com/api/v1/studio/sfx/generate \
  -H "Authorization: Bearer sk-tm-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Thunder rumbling in the distance with light rain",
    "title": "Distant Thunder",
    "duration": 10
  }'

Response

JSON

{
  "success": true,
  "data": {
    "url": "https://storage.googleapis.com/...",
    "storagePath": "studios/.../sfx.mp3",
    "format": "mp3",
    "duration": 10,
    "title": "Distant Thunder",
    "model": "elevenlabs-sfx",
    "metadata": {
      "prompt": "Thunder rumbling in the distance with light rain",
      "promptInfluence": 0.3
    }
  },
  "credits": { "used": 1, "cost": 5.0, "remaining": 9995.0 }
}