> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexinference.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Autenticação
> Sua chave de API FlexInference e sua chave OpenAI BYOK.
A FlexInference usa dois tipos de chaves: uma chave de API FlexInference para esta API e chaves de provedor BYOK para provedores de modelo.
| Chave | Formato | Quem identifica | Onde reside |
| :----------------------------- | :-------------- | :------------------------------- | :------------------------------------------------------------------------------------------ |
| **Chave de API FlexInference** | `flex_live_...` | Você, para a FlexInference | Enviada como cabeçalho `Authorization` em cada requisição |
| **Chave OpenAI (BYOK)** | `sk-...` | Você, para a OpenAI | Armazenada criptografada no painel; nunca enviada por você em uma requisição |
| **Chave Gemini (BYOK)** | `AIza...` | Você, para o Google | Armazenada criptografada no painel; nunca enviada por você em uma requisição |
| **Chave Anthropic (BYOK)** | `sk-ant-...` | Você, para a Anthropic | Armazenada criptografada no painel; nunca enviada por você em uma requisição |
| **Chave Vertex (BYOK)** | `AQ....` | Você, para o Google Cloud Vertex | Armazenada criptografada no painel; nunca enviada por você em uma requisição |
| **Chave Bedrock (BYOK)** | `ABSK...` | Você, para o AWS Bedrock | Armazenada criptografada com sua região no painel; nunca enviada por você em uma requisição |
## Chave de API FlexInference
Crie uma chave no [painel](https://www.flexinference.com/dashboard). O painel a exibe apenas uma vez; armazene-a como um segredo. Envie-a como um token de portador em `Authorization`:
```bash theme={null}
curl https://api.flexinference.com/v1/responses \
-H "Authorization: Bearer flex_live_..." \
-H "Content-Type: application/json" \
-d '{ "model": "gpt-5-nano", "input": "ping", "start_within": "default" }'
```
Toda requisição deve incluir `start_within`, que define o tempo máximo que a requisição pode esperar para iniciar. `default` usa o nível padrão. Uma duração permite que o planejador de superfície tente primeiro um nível flex mais barato e, em seguida, escale para o nível padrão se o flex não puder iniciar antes do prazo. Consulte [Roteamento por Prazo](/pt/deadline-routing) para a lista completa de valores.
Uma chave malformada, revogada ou desconhecida retorna `401 invalid_api_key`. Toda chave FlexInference possui um checksum, então erros de digitação óbvios são rejeitados antes de qualquer chamada ao provedor. A revogação é verificada antes do roteamento. Se você encontrar este erro, verifique se copiou a chave inteira, se ela começa com `flex_live_` e se você não a revogou no painel. Crie uma nova chave se não tiver certeza de que ela ainda é válida.
Trate as chaves `flex_live_` como segredos. Não as comite nem as inclua em
código do lado do cliente. Se uma chave vazar, revogue-a no painel e crie uma
nova.
## Suas chaves de provedor (BYOK)
A FlexInference não revende inferência. Adicione suas chaves de provedor uma vez no painel: OpenAI (`sk-...`) para modelos GPT, Gemini (`AIza...`) para modelos Gemini, Anthropic (`sk-ant-...`) para modelos Claude, ou qualquer combinação dos três. Para rotas de nuvem, adicione uma chave Vertex express (`AQ.` prefixo) ou uma chave Bedrock bearer (`ABSK` prefixo) com sua região. O provedor fatura sua conta diretamente.
O modelo e o array opcional `provider` selecionam a chave do provedor. Por padrão, o nome do modelo a seleciona: um modelo `gemini-*` usa sua chave Gemini, um modelo `claude-*` usa sua chave Anthropic, e todo o resto usa sua chave OpenAI. Quando você fixa uma rota com `provider`, cada rota na cadeia usa a chave dessa rota: uma rota `google` usa sua chave Gemini, uma rota `anthropic` usa sua chave Anthropic, e uma rota `openai` usa sua chave OpenAI. As rotas de nuvem `vertex` e `bedrock` usam suas próprias chaves: uma rota `vertex` usa sua chave Vertex express (prefixo `AQ.`) e uma rota `bedrock` usa sua chave Bedrock bearer (prefixo `ABSK`) e região. Consulte [roteamento de provedor](/pt/models).
Cada chave de provedor é armazenada criptografada em repouso com uma vinculação por organização. A FlexInference nunca a registra, a retorna ou pede para você enviá-la por requisição.
Se a requisição precisar de uma chave que não está configurada, você receberá `400 no_byok_key` (OpenAI), `400 no_gemini_key` (Gemini), `400 no_anthropic_key` (Anthropic), `400 no_vertex_key` (Vertex) ou `400 no_bedrock_key` (Bedrock). Adicione a chave no painel e tente novamente. Se uma chave armazenada existir, mas não puder ser descriptografada, a requisição falhará como `500 internal_error`, e não como um erro de chave ausente.
Cada rota que você nomeia em uma cadeia `provider` precisa de sua chave, não apenas a rota primária. Uma chave ausente é um erro de configuração, e não uma falha transitória, portanto, é rejeitada antes de qualquer chamada upstream e nunca passa para a próxima rota na cadeia: `["bedrock","anthropic"]` sem uma chave Bedrock retorna `400 no_bedrock_key` mesmo quando sua chave Anthropic está presente. Consulte [roteamento de provedor](/pt/models).
A chave Bedrock que você adiciona aqui é sua chave de **inferência** (prefixo
`ABSK`). Ela não é a mesma que a configuração de conta AWS que os quatro
modelos Claude mais recentes na rota `bedrock` exigem: um opt-in único de
retenção de dados `provider_data_share` e um acordo de modelo, executado uma
vez com as credenciais AWS de um administrador, e não esta chave de
inferência. Até que isso seja feito, esses modelos retornam
`403 bedrock_model_access_denied`. Consulte [a configuração dos modelos mais
recentes](/pt/models).
Como a cobrança é feita em sua própria conta de provedor, seus limites de
taxa, cotas e controles de gastos existentes ainda se aplicam. Isso vale
independentemente de a requisição ir para OpenAI, Gemini ou Anthropic.