# Autenticação

Todas as solicitações Tripo API devem incluir um API Key no cabeçalho da solicitação HTTP para autenticação.

## Método de autenticação

Adicione o campo `Authorization` ao cabeçalho da solicitação, com o valor `Bearer {api_key}`:

```
Authorization: Bearer {api_key}
```

## Obtenha um API Key

1. Faça login no [Console Tripo](https://platform.tripo3d.ai)
2. Abra a página "API Keys"
3. Clique em "Criar chave" para gerar um novo API Key
4. Copie e armazene-o com segurança. É mostrado apenas uma vez após a criação

## Exemplos de solicitação

### curl

```bash
curl -X GET https://openapi.tripo3d.ai/v3/account/balance \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Python

```python
import requests

headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.get(
    "https://openapi.tripo3d.ai/v3/account/balance",
    headers=headers
)
print(response.json())
```

### JavaScript

```javascript
const response = await fetch("https://openapi.tripo3d.ai/v3/account/balance", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
});

const data = await response.json();
console.log(data);
```

## Recomendações de segurança

- **Armazene API Keys em variáveis de ambiente**. Não os codifique no código-fonte
- **Não envie API Keys para repositórios de código**. Adicionar arquivos `.env` a `.gitignore`
- **Não use API Keys diretamente em aplicativos frontend**. Solicitações de proxy por meio do seu serviço backend
- **Gire as chaves regularmente**. Se você suspeitar de um vazamento, exclua a chave do console imediatamente e crie uma nova

```bash
# Recommended: read the API Key from an environment variable
export TRIPO_API_KEY="your_api_key_here"
```

```python
import os

api_key = os.environ["TRIPO_API_KEY"]
```

```javascript
const apiKey = process.env.TRIPO_API_KEY;
```