Keys and access¶
Why can't my key call this model?¶
Your team (or your agent) doesn't allow it, or the key was narrowed to fewer models. Your account › Models lists the models you may call and why; the refused call in Request logs says what refused it, in words. Ask a group admin of your team to allow it. See See your models.
Why was my key turned off?¶
The key says why. A key is Suspended when someone suspended it by hand, it went unused for the organisation's dormant-key period, a budget covering it was reached, its person was disabled or its agent suspended. It's Expired once it passes its expiry date, and Revoked when stopped for good. See Statuses: keys.
Can a key work in two environments?¶
No: a key belongs to one environment at a time, such as production or staging, with that environment's rules and lifetime. Issue one key for each, or move a key from staging to production when it's ready. See Move a key to another environment.
Keys or tokens: which do I need?¶
A key lets a program call models through the gateway. A token lets a script manage Vidai itself through its API: a personal access token acts as you; a service account's token Enterprise acts as a system. See Service accounts and tokens.
Why do I see a different model name in the answer?¶
Routing, a model name (alias) or a fallback chain chose another model for your call. The answer's x-vidai-model
header names the model that answered, and x-vidai-requested-model the one you asked for. Request logs shows every
model a fallback chain tried. See Model names.
Why can't my Anthropic SDK upload a file to OpenAI?¶
Files, batches and uploads work only in the same format as the provider: an Anthropic-format upload goes to Anthropic. Chat, messages and content generation are translated between formats; files aren't. See the developer reference.
Can another key see files I uploaded?¶
Yes, if it reaches the same provider account. A provider can't tell the gateway's keys apart, so any key whose calls go to that account can list, read and delete its files. Every upload is recorded with its name, type, size and checksum, never its content, and guardrails don't scan file content. See Files, batches and uploads.
Why was I told my key's rate limit was reached?¶
Each key may make a set number of requests a minute: its own limit, or the organisation's default. Ask the key's admin for a higher limit. See Set key defaults.
Where do I find the gateway's address for my SDK?¶
On Keys, under Connect your app. If it says the address isn't set yet, ask an organisation admin to set it.