DictatorFlow API Documentation

# 1. Sign up
curl -X POST https://dictatorflow.com/auth/signup \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]", "password": "secret123"}'

# 2. Create an API key (use the token from signup response)
curl -X POST https://dictatorflow.com/auth/api-keys \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-app"}'

# 3. Transcribe audio
curl -X POST https://dictatorflow.com/transcribe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: audio/pcm" \
  --data-binary @audio.pcm

curl -X POST https://dictatorflow.com/transcribe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: audio/pcm" \
  --data-binary @recording.pcm

{
  "text": "Hello, this is a transcription test.",
  "duration_seconds": 0.142,
  "mode": "smart",
  "language": "auto"
}

curl -X POST https://dictatorflow.com/transcribe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: audio/wav" \
  -H "X-Transcription-Mode: verbatim" \
  -H "X-Language-Code: en-NZ" \
  -H "X-Word-Timestamps: true" \
  -H "X-Speaker-Diarization: true" \
  --data-binary @meeting.wav

{
  "text": "Welcome to the meeting.",
  "mode": "verbatim",
  "language": "en-NZ",
  "words": [
    {"text": "Welcome", "start_offset": "0.20s", "end_offset": "0.61s", "speaker": "spk_1"}
  ]
}

curl -X POST https://dictatorflow.com/transcribe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: audio/pcm" \
  -H "X-Provider: meta" \
  -H "X-Provider-Key: YOUR_PROVIDER_KEY" \
  --data-binary @recording.pcm

import requests

with open("recording.pcm", "rb") as f:
    audio = f.read()

resp = requests.post(
    "https://dictatorflow.com/transcribe",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "audio/pcm",
    },
    data=audio,
)

print(resp.json()["text"])

const resp = await fetch("https://dictatorflow.com/transcribe", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "audio/pcm",
  },
  body: audioBuffer, // ArrayBuffer of PCM data
});

const { text } = await resp.json();
console.log(text);

<script src="https://dictatorflow.com/embed/dictatorflow-stt.js"></script>

<textarea id="notes" rows="8"></textarea>

<script>
  window.DictatorFlowSTT.mount(document.getElementById("notes"), {
    apiKey: "YOUR_API_KEY",
    buttonLabel: "Speak",
    title: "Dictate your notes",
    subtitle: "Press Enter when you're done speaking."
  });
</script>

const composer = document.querySelector("#composer");
const trigger = document.querySelector("#voice-trigger");

trigger.addEventListener("click", () => {
  window.DictatorFlowSTT.open({
    target: composer,
    endpoint: "/api/dictation",
    title: "Voice reply",
    subtitle: "Transcribe through your own backend proxy."
  });
});

window.DictatorFlowSTT.mountAll("[data-voice]", (target) => ({
  endpoint: "/api/dictation",
  target,
  buttonLabel: "Speak",
  title: "Talk to " + (target.getAttribute("placeholder") || "this field")
}));

func dictatorflowProxy(w http.ResponseWriter, r *http.Request) {
  req, _ := http.NewRequest(
    http.MethodPost,
    "https://dictatorflow.com/transcribe",
    r.Body,
  )

  req.Header.Set("Authorization", "Bearer "+os.Getenv("DICTATORFLOW_API_KEY"))
  req.Header.Set("Content-Type", r.Header.Get("Content-Type"))

  resp, _ := http.DefaultClient.Do(req)
  defer resp.Body.Close()

  w.Header().Set("Content-Type", "application/json")
  w.WriteHeader(resp.StatusCode)
  io.Copy(w, resp.Body)
}

@app.post("/api/dictation")
def dictatorflow_proxy():
    upstream = requests.post(
        "https://dictatorflow.com/transcribe",
        headers={
            "Authorization": f"Bearer {os.environ['DICTATORFLOW_API_KEY']}",
            "Content-Type": request.headers.get("Content-Type", "audio/webm"),
        },
        data=request.get_data(),
        timeout=30,
    )

    return Response(
        upstream.content,
        status=upstream.status_code,
        content_type="application/json",
    )

curl -X POST https://dictatorflow.com/command \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transcription": "make this uppercase",
    "selected_text": "hello world"
  }'

{
  "result": "HELLO WORLD"
}

curl https://dictatorflow.com/usage \
  -H "Authorization: Bearer YOUR_TOKEN"

[
  {
    "id": "txn-uuid",
    "user_id": "user-uuid",
    "type": "usage",
    "amount_cents": -40,
    "seconds_used": 100.0,
    "created_at": "2026-02-28T15:30:00Z"
  },
  {
    "id": "txn-uuid-2",
    "user_id": "user-uuid",
    "type": "purchase",
    "amount_cents": 1000,
    "seconds_used": 0,
    "stripe_charge_id": "ch_...",
    "created_at": "2026-02-28T12:00:00Z"
  }
]

{
  "error": "insufficient credits or no active subscription"
}