Docs

Authentication

Every request to /v1/* (except GET /v1/models and GET /v1/pricing) needs an API key in the Authorization header:

Authorization: Bearer sk-pool-…

Keys

  • Keys are created in the console by an account admin. Creating, rotating or revoking a key needs a fresh second factor.
  • The secret is shown once. We store only a hash. If you lose it, rotate the key.
  • Each key has scopes: transcription, embeddings, jobs:read. Give each service only what it needs.
  • Rotation gives a new secret and keeps the old one working for 24 hours so you can deploy without downtime.
  • Revocation takes effect within seconds on every gateway.

Data class header

HeaderValuesDefault
X-Pool-Data-Classsensitive, publicsensitive

sensitive runs only on our own and vetted cloud hardware. public lets the job run on the distributed network and is honoured only after your account accepts the data policy. Either way, do not send personal or sensitive data: the class controls routing, not what you may send.

Idempotency

Send Idempotency-Key on POSTs. It's required on /v1/audio/transcriptions/jobs. Replaying a key returns the original job; reusing it with a different body returns 409 idempotency_key_reused.

Authentication · Vouch Compute