curl -X POST https://api.tryhamsa.com/v1/jobs/transcribe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mediaUrl": "https://your-storage.com/audio.mp3",
    "model": "Hamsa-General-V2.0",
    "language": "ar",
    "webhookUrl": "https://your-server.com/webhook"
  }'

import requests

url = "https://api.tryhamsa.com/v1/jobs/transcribe"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "mediaUrl": "https://your-storage.com/audio.mp3",
    "model": "Hamsa-General-V2.0",
    "language": "ar",
    "webhookUrl": "https://your-server.com/webhook"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())
# Returns: { "success": true, "data": { "jobId": "..." } }

curl -X POST https://api.tryhamsa.com/v1/realtime/stt \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audioBase64": "<base64-encoded-wav-audio>",
    "language": "ar",
    "model": "s2"
  }'

import requests
import base64

# Read and encode your audio file
with open("audio.wav", "rb") as f:
    audio_base64 = base64.b64encode(f.read()).decode()

url = "https://api.tryhamsa.com/v1/realtime/stt"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "audioBase64": audio_base64,
    "language": "ar",
    "model": "s2"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())
# Returns: { "text": "مرحبا بك في خدمة همسة" }