OurScent

Authentication and keys

Test and live keys, scopes, IP allowlists, allowed origins and key rotation in the OurScent API.

Every request carries your key in the Authorization header:

Authorization: Bearer os_live_…

Test and live keys

PrefixReturnsCost
os_test_Fixed sample dataFree
os_live_Real dataSpends credits

Scopes

Each key has scopes: vision, data and images. A call outside a key’s scopes returns 403 forbidden_scope. Give each app the least it needs.

IP allowlist

Restrict a server key to IP addresses or CIDR ranges (e.g. 203.0.113.0/24). Calls from anywhere else are refused with 403.

Allowed origins (browser keys)

A key used from a web page is locked to your origins (e.g. https://shop.example.com), so it fails if copied to another site. Never put an unrestricted key in browser code.

Rotation and revocation

“Rotate” in the console creates a replacement with the same settings and revokes the old key at once. Revocation takes effect within a minute. We store only the key’s SHA-256 hash, so a lost key cannot be recovered.

Your first key in two minutes

Sign in with your OurScent account, create a test key, send your first call.