openproxy: Skill for Claude Code

openproxy — speech-to-text

OpenProxy transcribes audio on one OpenAI-compatible endpoint and routes it to whichever credentialed STT provider owns the requested model. This skill covers:

1. Probing the server and confirming the route exists
2. Registering an STT provider credential
3. Transcribing over POST /v1/audio/transcriptions (multipart and JSON shapes)
4. Transcribing from the CLI
5. Reading the per-provider response shapes
6. Verifying the whole thing end to end

Everything here is non-interactive and copy-pasteable.

0 · Detect what's already running

Do this before mutating anything:

command -v openproxy && openproxy --version || echo "not installed"
openproxy --robot server status 2>/dev/null || echo "server not running"
curl -sS http://127.0.0.1:4623/health

If the server is not up, start it detached and headless:

openproxy server start --detach --no-open
curl -sS http://127.0.0.1:4623/v1 | jq .endpoints

/v1 advertises /v1/audio/transcriptions in its endpoint list. If it is not there, the binary is older than this skill — upgrade before continuing.

Capture the admin key once and reuse it. /v1/* is gated on settings.requireLogin, which defaults to on, so the bearer is required unless the user has deliberately turned it off:

openproxy key add <NAME> --auto
# Or pass your own secret positionally: openproxy key add <NAME> '<SECRET>'
# If no key exists yet, capture the one-shot admin key from:
openproxy --robot server init | jq -r '.data.admin_key.key'
# Or recover the dashboard password for a running server:
openproxy auth reset-password --show

The bearer may be the admin key from server init or any proxy key minted with openproxy key add. Both work on /v1/audio/transcriptions.

1 · Register an STT provider

STT providers are provider connections tagged with mediaType: "stt". Add one through the media-providers API, which encrypts the key on the way into the database:

curl -sS -X POST http://127.0.0.1:4623/api/media-providers \
  -H "Authorization: Bearer $OPENPROXY_API_KEY" \
  -H 'content-type: application/json' \
  -d '{
        "name": "openai-stt",
        "provider": "openai",
        "apiKey": "sk-...",
        "mediaType": "stt"
      }'