Text-to-Speech

GET /voice/v1/voices

curl https://api.case.dev/voice/v1/voices?category=premade \
  -H "Authorization: Bearer sk_case_your_api_key_here"

{
  "voices": [
    {
      "voice_id": "EXAVITQu4vr4xnSDxMaL",
      "name": "Rachel",
      "category": "premade",
      "description": "Professional, clear, and authoritative female voice",
      "labels": {
        "accent": "american",
        "age": "young",
        "gender": "female",
        "use_case": "narration"
      },
      "preview_url": "https://..."
    },
    {
      "voice_id": "21m00Tcm4TlvDq8ikWAM",
      "name": "Adam",
      "category": "premade",
      "description": "Deep, professional male voice",
      "labels": {
        "accent": "american",
        "age": "middle_aged",
        "gender": "male",
        "use_case": "narration"
      }
    }
  ],
  "has_more": false,
  "total_count": 45
}

POST /voice/v1/speak

curl -X POST https://api.case.dev/voice/v1/speak \
  -H "Authorization: Bearer sk_case_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "The court finds in favor of the plaintiff.",
    "voice_id": "EXAVITQu4vr4xnSDxMaL"
  }' \
  -o judgment.mp3

curl -X POST https://api.case.dev/voice/v1/speak \
  -H "Authorization: Bearer sk_case_..." \
  -d '{"text": "Hello from CaseMark"}' \
  -o output.mp3

curl -X POST https://api.case.dev/voice/v1/speak \
  -H "Authorization: Bearer sk_case_..." \
  -d '{
    "text": "The defendant failed to meet the standard of care.",
    "voice_id": "EXAVITQu4vr4xnSDxMaL",
    "voice_settings": {
      "stability": 0.7,
      "similarity_boost": 0.8,
      "style": 0.2,
      "speaker_boost": true
    }
  }' \
  -o statement.mp3

POST /voice/v1/speak/stream

curl -X POST https://api.case.dev/voice/v1/speak/stream \
  -H "Authorization: Bearer sk_case_..." \
  -H "Content-Type: application/json" \
  -d '{
    "text": "All rise. The court is now in session.",
    "optimize_streaming_latency": 3
  }' \
  -o announcement.mp3

// Browser example
const response = await fetch('/api/voice/v1/speak/stream', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ text: 'Hello from the courtroom' })
});

const audioContext = new AudioContext();
const reader = response.body.getReader();

// Start playback as chunks arrive
while (true) {
  const { done, value } = await reader.read();
  if (done) break;

  // Decode and play chunk
  const audioData = await audioContext.decodeAudioData(value.buffer);
  // ... play audio
}

curl -X POST https://api.case.dev/voice/v1/speak \
  -H "Authorization: Bearer sk_case_..." \
  -d '{
    "text": "All rise. The Honorable Judge Sarah Martinez presiding. Court is now in session for Case Number 2024-CV-1234, Smith versus Hospital Medical Center.",
    "voice_id": "21m00Tcm4TlvDq8ikWAM",
    "voice_settings": {
      "stability": 0.9,
      "style": 0.1
    }
  }' \
  -o court-announcement.mp3

curl -X POST https://api.case.dev/voice/v1/speak \
  -H "Authorization: Bearer sk_case_..." \
  -d '{
    "text": "Plaintiff alleges negligence in post-operative care, citing failure to monitor vital signs and delayed response to complications. Medical records show a pattern of inadequate staffing during overnight shifts.",
    "voice_id": "EXAVITQu4vr4xnSDxMaL",
    "model_id": "eleven_multilingual_v2"
  }' \
  -o case-summary.mp3

curl -X POST https://api.case.dev/voice/v1/speak \
  -H "Authorization: Bearer sk_case_..." \
  -d '{
    "text": "Su caso ha sido archivado exitosamente. Nos pondremos en contacto con usted dentro de 48 horas.",
    "language_code": "es",
    "voice_id": "EXAVITQu4vr4xnSDxMaL"
  }' \
  -o client-message-spanish.mp3

#!/bin/bash
API_KEY="sk_case_your_api_key_here"
VOICE_ID="EXAVITQu4vr4xnSDxMaL"

# Array of sections
sections=(
  "Introduction to the case"
  "Plaintiff testimony summary"
  "Defense arguments overview"
  "Medical expert opinions"
  "Conclusion and verdict"
)

for i in "${!sections[@]}"; do
  echo "Generating section $((i+1))/${#sections[@]}: ${sections[$i]}"

  curl -s -X POST https://api.case.dev/voice/v1/speak \
    -H "Authorization: Bearer $API_KEY" \
    -H "Content-Type: application/json" \
    -d "{
      \"text\": \"${sections[$i]}\",
      \"voice_id\": \"$VOICE_ID\"
    }" \
    -o "section-$((i+1)).mp3"
done

echo "All sections generated!"

{
  "text": "The payment of $2,500,000 is due on 01/15/2024",
  "apply_text_normalization": "on"
}

{
  "text": "The voir dire process began at 9 AM",
  "pronunciation_dictionary_locators": [
    {
      "pronunciation_dictionary_id": "dict_123",
      "version_id": "v1"
    }
  ]
}

{
  "text": "This is the middle section.",
  "previous_text": "This was said before.",
  "next_text": "This comes after."
}

#!/bin/bash
API_KEY="sk_case_your_api_key_here"
VAULT_ID="sytp1b5f5j1yuj7uffzzxgw6"
OBJECT_ID="text-doc-123"

# Step 1: Get text document from vault
DOWNLOAD_URL=$(curl -s https://api.case.dev/vault/$VAULT_ID/objects/$OBJECT_ID \
  -H "Authorization: Bearer $API_KEY" \
  | jq -r '.downloadUrl')

# Download and extract text
TEXT_CONTENT=$(curl -s "$DOWNLOAD_URL")

# Step 2: Generate speech from text
curl -X POST https://api.case.dev/voice/v1/speak \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"text\": \"$TEXT_CONTENT\",
    \"voice_id\": \"EXAVITQu4vr4xnSDxMaL\",
    \"output_format\": \"mp3_44100_128\"
  }" \
  -o /tmp/audio-output.mp3

# Step 3: Upload audio back to vault
AUDIO_UPLOAD=$(curl -s -X POST https://api.case.dev/vault/$VAULT_ID/upload \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"filename\": \"case-summary-audio.mp3\",
    \"contentType\": \"audio/mpeg\",
    \"metadata\": {
      \"source_document_id\": \"$OBJECT_ID\",
      \"voice\": \"Rachel\",
      \"generated_at\": \"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"
    }
  }")

AUDIO_OBJECT_ID=$(echo "$AUDIO_UPLOAD" | jq -r '.objectId')
UPLOAD_URL=$(echo "$AUDIO_UPLOAD" | jq -r '.uploadUrl')

curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: audio/mpeg" \
  --data-binary "@/tmp/audio-output.mp3"

echo "✓ Audio version stored in vault: $AUDIO_OBJECT_ID"