Access and keys
The API is for businesses and broadcasters. Every plan is agreed with you, and comes with keys and monthly limits.
Getting access
- Contact us with what you want to build and roughly how much: how many words a month, how many hours of live signing, how many videos.
- Most start with a trial: about a month with modest limits, to try Signa on your own content.
- We agree your plan, and you get live keys with the limits of your plan.
Using a key
Send it as a bearer token on every request:
curl https://api.usesigna.org/v1/api/me \
-H "Authorization: Bearer $SIGNA_KEY"| Key | Meaning |
|---|---|
sk_live_… | A live key, with the limits of your plan. |
sk_trial_… | A trial key. It stops working on the trial's end date. |
You can have several keys, for example one per product, station or environment, all counting against the same plan. Ask us for another at any time.
We can't show a key twice
We only store a fingerprint of each key, so nobody at Signa can read it back to you. If a key is lost or leaks, tell us: we revoke it at once and issue a new one.
Monthly limits
Your plan sets up to three monthly limits. A limit that is not set means no limit.
| Limit | What counts |
|---|---|
| Characters | The characters of every text you sign, through /v1/sign or /v1/spoken-to-signed-pose. |
| Live minutes | Time connected to /v1/live. |
| Videos | Every video made with /v1/sign/video. |
Months are calendar months in UTC. When a limit is reached, requests that need it are refused with 429 API_LIMIT_REACHED until the 1st, or until we raise it. Errors and limits.