> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doglytdc.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Gateway

> Gerencie acesso à API de IA com chaves restritas, créditos pagos e registros recentes.

## Resumo

O AI Gateway oferece acesso a modelos por API e gerenciamento de chaves.
O painel reúne visão geral, modelos, chaves, uso, cobrança e documentação.
As chamadas utilizam créditos pagos.

O saldo total da conta não deve ser confundido com o saldo elegível para o Gateway.
Créditos de outras origens não substituem automaticamente créditos pagos.

## Para quem é

* Quem integra modelos de IA a uma aplicação.
* Quem precisa separar acesso por chave.
* Quem quer limitar modelos e origens permitidos.
* Quem precisa inspecionar chamadas recentes e créditos cobrados.

## Como abrir

Use **Painel › AI Gateway**, com `?tab=ai-gateway`.
As subseções usam entradas como `?tab=ai-gateway:overview`.
O painel preserva a seção selecionada na navegação interna.

> [!NOTE]
>
> A tela possui controle de acesso para Premium e Business.
> A disponibilidade do painel não elimina a necessidade de créditos pagos para as chamadas.

## Telas e recursos

![Captura de tela: AI Gateway](https://mintcdn.com/dogly-tdc/qOnot79kPtISSKbW/images/doglytdc/ai-gateway.png?fit=max\&auto=format\&n=qOnot79kPtISSKbW\&q=85\&s=93b86d1ca22bb7e39065dc5927a2b497)

AI Gateway no DoglyTdc

### Visão geral

A visão geral apresenta indicadores de acesso e consumo.
Confira o saldo de créditos pagos antes de iniciar uma integração.
Não use apenas o saldo total como previsão de capacidade.

### Modelos

O catálogo mostra modelos disponíveis no Gateway.
Use o identificador apresentado na documentação da própria interface.
Uma chave pode restringir quais modelos sua integração consegue solicitar.

### Chaves

Cada chave possui nome, estado e escopo.
A criação permite configurar modelos, origens, teto mensal e requisições por minuto.
A credencial completa é exibida apenas uma vez.

**1. Defina o uso**

Crie uma chave para a integração desejada.
Escolha um nome que permita reconhecer sua finalidade.

**2. Restrinja o acesso**

Selecione modelos e origens permitidos.
Configure limites adequados ao uso esperado.

**3. Guarde a credencial**

Copie a credencial no momento da criação.
Armazene-a de forma segura, fora de conteúdo público.

**4. Teste e acompanhe**

Faça uma chamada com o modelo permitido.
Confira estado, latência e cobrança na seção de uso.

### Restrições por chave

A lista de modelos limita o escopo daquela chave.
A lista de origens controla os domínios autorizados.
A interface também permite configurações amplas, como todos os modelos ou qualquer origem.

O teto mensal é expresso em créditos.
O limite de frequência é expresso em requisições por minuto.
Sem limite configurado não significa saldo infinito.

### Estado da chave

Uma chave pode ser desativada e reativada.
Revogar é uma ação diferente de apenas desativar.
As chamadas identificam chaves revogadas e desativadas com erros diferentes.

**1. Identifique a chave**

Confira nome, prefixo e informações visíveis no painel.
Evite alterar outra integração por engano.

**2. Escolha a ação**

Desative para interromper o uso da chave.
Use revogação quando precisar invalidar a credencial.

**3. Confira a integração**

Verifique se a aplicação passou a usar uma chave válida.
Não continue repetindo chamadas com uma chave revogada.

### Uso

A tela carrega até 100 registros recentes.
Novos registros recebidos também mantêm a lista limitada aos 100 mais recentes.
Essa lista não é um arquivo completo de todo o histórico.

Os registros incluem modelo, origem, estado, latência e créditos cobrados.
Use esses dados para investigar falhas e consumo recente.
Não conclua que não houve uso antigo só porque ele não aparece nessa lista.

### Cobrança e documentação

A área de cobrança diferencia créditos pagos de outros créditos.
A documentação inclui exemplos de integração e códigos de erro.
Consulte os exemplos exibidos na interface para o ambiente em uso.

## Créditos e limites

* O Gateway utiliza créditos pagos.
* O saldo de outros créditos aparece separado.
* Cada chave pode ter teto mensal de créditos.
* Cada chave pode ter limite de chamadas por minuto.
* Restrições de modelos e origens continuam válidas mesmo com saldo.
* A lista de uso mostra até 100 registros recentes.

## Permissões

O painel verifica o acesso ao recurso conforme o plano.
As chamadas precisam de uma chave válida, ativa e não revogada.
A chave ainda precisa permitir o modelo e a origem solicitados.
Não publique a credencial em exemplos ou repositórios abertos.

## Erros comuns

| Mensagem | O que significa | O que fazer |
| - | - | - |
| 401 invalid\_api\_key | A chave não é válida. | Confira a credencial configurada. |
| 401 key\_revoked | A chave foi revogada. | Use uma nova chave válida. |
| 403 key\_disabled | A chave está desativada. | Reative a chave no painel, se apropriado. |
| 403 origin\_not\_allowed | A origem não está autorizada. | Confira os domínios permitidos. |
| 403 model\_not\_allowed | O modelo está fora do escopo. | Escolha um modelo permitido. |
| 402 insufficient\_paid\_credits | Faltam créditos pagos. | Confira o saldo pago na área de cobrança. |

## Perguntas frequentes

> [accordion] Todo crédito da conta serve para o Gateway?
>
> Não. O Gateway utiliza créditos pagos e os distingue dos demais créditos.

> [accordion] Posso recuperar a credencial completa depois?
>
> A tela informa que ela é exibida apenas uma vez. Guarde-a com segurança na criação.

> [accordion] A seção de uso contém todo o histórico?
>
> Não. Ela apresenta até 100 registros recentes.

## Relacionado

> [card] [Créditos e planos](https://docs.doglytdc.dev/pt-BR/doglytdc/getting-started/credits-and-plans.md)

> [card] [Scripts](https://docs.doglytdc.dev/pt-BR/scripts/introduction.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.