VoxParse API Reference

curl https://api.voxparse.com/v1/balance \
  -H "X-API-Key: YOUR_API_KEY"

import requests

headers = {"X-API-Key": "YOUR_API_KEY"}
r = requests.get("https://api.voxparse.com/v1/balance", headers=headers)
print(r.json())

const res = await fetch("https://api.voxparse.com/v1/balance", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await res.json();
console.log(data);

{
  "error": {
    "message": "Invalid API key.",
    "code": 401
  }
}

{
  "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "queued",
  "model": "standard",
  "message": "Job queued for processing."
}

curl -X POST https://api.voxparse.com/v1/transcribe \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@recording.mp3" \
  -F "model=standard" \
  -F "language=en"

{
  "jobs": [
    {
      "id": "a1b2c3d4-...",
      "status": "completed",
      "type": "transcribe",
      "model": "standard",
      "duration_seconds": 3600,
      "cost_cents": 30,
      "created_at": "2026-04-19 19:13:18",
      "completed_at": "2026-04-19 19:15:22"
    }
  ],
  "limit": 20,
  "offset": 0
}

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "type": "transcribe",
  "model": "standard",
  "duration_seconds": 3600,
  "cost_cents": 30,
  "created_at": "2026-04-19 19:13:18",
  "completed_at": "2026-04-19 19:15:22",
  "error": null,
  "result_url": "/v1/jobs/a1b2c3d4-.../result"
}

{
  "id": "a1300fb2...",
  "object": "chat.completion",
  "created": 1776625997,
  "model": "deepseek/deepseek-v3.2",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 10,
    "total_tokens": 28
  }
}

curl -X POST https://api.voxparse.com/v1/apex/chat/completions \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "apex-latest",
    "messages": [{"role": "user", "content": "Hello"}],
    "max_tokens": 100,
    "temperature": 0.7
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://api.voxparse.com/v1/apex",
    api_key="YOUR_API_KEY"
)

response = client.chat.completions.create(
    model="apex-latest",
    messages=[{"role": "user", "content": "Hello"}]
)
print(response.choices[0].message.content)

{
  "balance_cents": 9998,
  "balance_dollars": "99.98",
  "expired": false,
  "recent_topups": [
    {
      "amount_cents": 5000,
      "bonus_cents": 0,
      "created_at": "2026-04-19 18:00:00"
    }
  ]
}

{
  "products": [
    {"amount_cents":1000,"amount_dollars":"10.00","bonus_cents":0,"bonus_dollars":"0.00","total_credit_cents":1000,"total_credit_dollars":"10.00"},
    {"amount_cents":5000,"amount_dollars":"50.00","bonus_cents":0,"bonus_dollars":"0.00","total_credit_cents":5000,"total_credit_dollars":"50.00"},
    {"amount_cents":20000,"amount_dollars":"200.00","bonus_cents":1000,"bonus_dollars":"10.00","total_credit_cents":21000,"total_credit_dollars":"210.00"},
    {"amount_cents":50000,"amount_dollars":"500.00","bonus_cents":5000,"bonus_dollars":"50.00","total_credit_cents":55000,"total_credit_dollars":"550.00"}
  ],
  "currency": "usd",
  "note": "Credits expire after 6 months of account inactivity."
}

import requests
import time

API_KEY = "YOUR_API_KEY"
BASE = "https://api.voxparse.com"
headers = {"X-API-Key": API_KEY}

# 1. Upload audio
with open("recording.mp3", "rb") as f:
    r = requests.post(f"{BASE}/v1/transcribe",
        headers=headers,
        files={"file": f},
        data={"model": "standard", "language": "en"})
job = r.json()
job_id = job["job_id"]
print(f"Job created: {job_id}")

# 2. Poll for completion
while True:
    r = requests.get(f"{BASE}/v1/jobs/{job_id}", headers=headers)
    status = r.json()["status"]
    print(f"Status: {status}")
    if status in ("completed", "failed"):
        break
    time.sleep(5)

# 3. Download result
if status == "completed":
    r = requests.get(f"{BASE}/v1/jobs/{job_id}/result", headers=headers)
    transcript = r.json()
    print(transcript)

const fs = require("fs");

const API_KEY = "YOUR_API_KEY";
const BASE = "https://api.voxparse.com";
const headers = { "X-API-Key": API_KEY };

async function transcribe(filePath) {
  // 1. Upload
  const form = new FormData();
  form.append("file", new Blob([fs.readFileSync(filePath)]));
  form.append("model", "standard");

  const { job_id } = await fetch(`${BASE}/v1/transcribe`, {
    method: "POST", headers, body: form
  }).then(r => r.json());

  console.log(`Job: ${job_id}`);

  // 2. Poll
  let status;
  do {
    await new Promise(r => setTimeout(r, 5000));
    const job = await fetch(`${BASE}/v1/jobs/${job_id}`, { headers })
      .then(r => r.json());
    status = job.status;
    console.log(`Status: ${status}`);
  } while (!["completed","failed"].includes(status));

  // 3. Result
  if (status === "completed") {
    const result = await fetch(`${BASE}/v1/jobs/${job_id}/result`,
      { headers }).then(r => r.json());
    return result;
  }
}

transcribe("recording.mp3").then(console.log);

from openai import OpenAI

# Point the OpenAI SDK at VoxParse
client = OpenAI(
    base_url="https://api.voxparse.com/v1/apex",
    api_key="YOUR_VOXPARSE_API_KEY"
)

# Works exactly like the OpenAI API
response = client.chat.completions.create(
    model="apex-latest",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Summarize this transcript..."}
    ],
    max_tokens=1000,
    temperature=0.3
)

print(response.choices[0].message.content)
print(f"Tokens used: {response.usage.total_tokens}")