{
  "api_key": "your_api_key",
  "audio_data": "base64_encoded_audio (optional)",
  "audio_url": "https://url-to-audio-file (optional)",
  "call_id": "12345 (optional)",
  "mime_type": "audio/wav (optional, default: audio/wav)"
}

{
  "api_key": "your_api_key_here",
  "audio_data": "UklGRiQAAABXQVZFZm10IBAAAAABAAEA...",
  "mime_type": "audio/wav"
}

{
  "api_key": "your_api_key_here",
  "audio_url": "https://example.com/audio/recording.wav"
}

{
  "api_key": "your_api_key_here",
  "call_id": "123"
}

{
  "transcription": "AI: Hello, this is an AI assistant...\nUser: Hi, yes I can hear you.\n...",
  "user_credits_deducted": 0.0,
  "timestamp": "2025-10-28T12:34:56.789012"
}

{"error": "One of audio_data, audio_url, or call_id is required"}

{"error": "Only one of audio_data, audio_url, or call_id should be provided"}

{"error": "Audio must be at least 1 second long"}

{"error": "Audio must not exceed 30 minutes"}

{"error": "Invalid API key"}

{"error": "Insufficient credits, recharge at https://playground.aivoco.com"}

{
  "error": "Insufficient admin units for transcription, get now from Vispark Cloud at http://cloud.vispark.in",
  "required_units": 0.1234
}

{
  "error": "Insufficient user credits for transcription, recharge at https://playground.aivoco.com",
  "required_credits": 0.5,
  "current_credits": 0.2
}

{"error": "Call id not found or does not belong to user"}

{"error": "No recording found for this log"}

{"error": "Rate limit exceeded. Please try again later."}

{"error": "Failed to process transcription with Gemini API"}

curl -X POST https://call.aivoco.on.cloud.vispark.in/transcribe   -H "Content-Type: application/json"   -d '{
    "api_key": "your_api_key_here",
    "audio_url": "https://example.com/recording.wav"
  }'

import requests

url = "https://call.aivoco.on.cloud.vispark.in/transcribe"
payload = {"api_key": "your_api_key_here", "call_id": "123"}

response = requests.post(url, json=payload)
data = response.json()

if response.status_code == 200:
    print(f"Transcription:\n{data['transcription']}")
    print(f"Credits used: {data['user_credits_deducted']}")
else:
    print(f"Error: {data['error']}")

const url = 'https://call.aivoco.on.cloud.vispark.in/transcribe';
const payload = {
  api_key: 'your_api_key_here',
  audio_data: 'UklGRiQAAABXQVZFZm10...',
  mime_type: 'audio/wav'
};

fetch(url, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(payload)
})
.then(res => res.json())
.then(data => {
  if (data.transcription) console.log('Transcription:', data.transcription);
  else console.error('Error:', data.error);
})
.catch(err => console.error('Request failed:', err));

AI: Hello, this is an AI assistant calling about your recent inquiry.
User: Hi, yes I can hear you.
AI: Great! I'm calling to discuss your application. Do you have a few minutes?
User: Yes, sure. Go ahead.
AI: Wonderful. I wanted to confirm your contact information first.
User: [unclear] what was that?
AI: I said I need to confirm your contact information. Can you verify your email address?
User: Oh yes, it's [email protected]