> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-d2fddb8a.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Gerando uma chave de API

> Crie uma chave de API Venice a partir do painel, armazene o bearer token com segurança e verifique se ela funciona com uma primeira requisição autenticada a chat completions.

As requisições à API Venice são autenticadas com chaves de API do tipo Bearer. Este guia mostra como criar uma chave a partir do painel da Venice, armazená-la com segurança e verificar se ela está funcionando.

<Note>
  Se você está construindo um agente autônomo que precisa criar sua própria chave com uma carteira, use o guia [Criação de chave de API por agente autônomo](/guides/getting-started/generating-api-key-agent) em vez deste.
</Note>

## Antes de começar

* Faça login na sua conta Venice.
* Certifique-se de que a conta tenha um saldo disponível antes de chamar endpoints pagos. Você pode criar uma chave antes de adicionar fundos à conta, mas as requisições aos modelos não terão sucesso até que a conta possa consumir DIEM, créditos incluídos ou USD.

<Steps>
  <Step title="Abra as configurações da API">
    Acesse [https://venice.ai/settings/api](https://venice.ai/settings/api). Você também pode abrir essa página pelo app da Venice selecionando **API** nas configurações.

    O painel de configurações da API mostra seus saldos, o seu tier de API, o uso e as chaves de API existentes.
  </Step>

  <Step title="Inicie uma nova chave">
    Selecione **Generate New API Key** (Gerar nova chave de API) e configure a chave:

    * **Description:** Use um nome curto que identifique o aplicativo, o ambiente ou a integração que usará essa chave.
    * **API Key Type:** Use **Inference Only** para requisições normais aos modelos. Use **Admin** apenas quando a chave precisar gerenciar chaves de API de forma programática.
    * **Expires at:** Opcionalmente, defina uma data de expiração. Se você deixar em branco, a chave não expira automaticamente.
    * **Epoch Consumption Limits:** Opcionalmente, limite quanto de DIEM ou USD essa chave pode gastar durante uma época de 24 horas. Se você deixar em branco, a chave poderá usar o saldo disponível da conta, sujeito aos limites da sua conta.
  </Step>

  <Step title="Gere e copie a chave">
    Clique em **Generate**. A Venice exibirá a chave de API completa uma única vez.

    <Warning>
      Copie a chave imediatamente e armazene-a em um local seguro. Depois que você fechar a caixa de diálogo, a Venice mostrará apenas metadados de identificação, como a descrição da chave e os últimos caracteres. Se você perder o valor secreto, exclua a chave e crie uma nova.
    </Warning>

    Adicione a chave ao seu ambiente local ou gerenciador de segredos:

    ```bash theme={null}
    export VENICE_API_KEY="your-api-key-here"
    ```
  </Step>

  <Step title="Verifique a chave">
    Faça uma requisição de baixo risco para confirmar que a autenticação está funcionando:

    ```bash theme={null}
    curl --request GET \
      --url https://api.venice.ai/api/v1/models \
      --header "Authorization: Bearer $VENICE_API_KEY"
    ```

    Uma resposta bem-sucedida retorna os modelos disponíveis. Se você receber um erro de autenticação, confirme se a chave foi copiada por completo e se o cabeçalho `Authorization` está formatado como `Bearer <api-key>`.
  </Step>
</Steps>

## Boas práticas

* Crie chaves separadas para desenvolvimento, staging e produção.
* Prefira chaves **Inference Only** para aplicações que apenas chamam endpoints de modelos.
* Mantenha chaves **Admin** raras, com escopo restrito e armazenadas apenas em ambientes confiáveis do lado do servidor.
* Nunca faça commit de chaves de API no controle de versão nem as exponha em código do lado do cliente.
* Defina datas de expiração e limites de consumo para chaves usadas em ambientes temporários, compartilhados ou de maior risco.
* Exclua chaves não utilizadas e faça a rotação de qualquer chave que possa ter sido exposta.

## Gerenciamento programático de chaves

Chaves Admin podem gerenciar chaves de API por meio dos endpoints da referência da API:

<CardGroup cols={2}>
  <Card title="Criar chave de API" icon="plus" href="/api-reference/endpoint/api_keys/create">
    Crie uma nova chave de API no estilo do painel a partir de uma chave admin existente.
  </Card>

  <Card title="Listar chaves de API" icon="list" href="/api-reference/endpoint/api_keys/list">
    Visualize as chaves ativas e seus metadados.
  </Card>

  <Card title="Atualizar chave de API" icon="pen-to-square" href="/api-reference/endpoint/api_keys/update">
    Atualize a descrição, a data de expiração ou os limites de consumo de uma chave.
  </Card>

  <Card title="Excluir chave de API" icon="trash" href="/api-reference/endpoint/api_keys/delete">
    Revogue uma chave que não é mais necessária.
  </Card>
</CardGroup>