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

# AI Gateway

> Uma camada de roteamento independente para tráfego de LLMs em produção. Acesse mais de 500 modelos por um único endpoint compatível com OpenAI, com fallbacks e acompanhamento de uso.

O AI Gateway é uma camada de roteamento independente para tráfego de LLMs em produção. Envie solicitações por um único endpoint compatível com OpenAI para acessar mais de 500 modelos de diversos provedores, com fallbacks, novas tentativas, balanceamento de carga e acompanhamento de uso integrados.

## Início rápido

Conclua a primeira solicitação em poucos minutos.

### 1. Crie uma conta

[Cadastre-se](https://router.toqan.ai/eu/auth/signup), abra o workspace e selecione **AI Gateway** na barra lateral. O workspace é a conta da sua organização; as configurações compartilhadas ficam em **Settings > Organization**, e ele contém um ou mais projetos, que agrupam recursos e definem o escopo das chaves de API.

### 2. Conecte um provedor

Use os Créditos do **Toqan Router** ou adicione uma chave de provedor em **BYOK**. Para adicionar uma chave, abra **BYOK**, escolha [OpenAI](/docs/pt-BR/ai-studio/integrations/providers/openai.md), selecione Configure e cole a chave. Consulte a [Visão geral dos provedores](/docs/pt-BR/ai-gateway/providers-overview.md).

### 3. Habilite o modelo

Abra a página **Models** (**Model List** na barra lateral do **AI Gateway**), encontre `openai/gpt-5.4` e ative o **Status** para habilitá-lo. Consulte [Como usar o roteador](/docs/pt-BR/ai-gateway/using-the-router.md).

### 4. Configure o Toqan Router

Abra **Settings > Organization > API Keys** e selecione Create API key. Escolha o **Project** ao qual a chave pertence: as solicitações feitas com a chave ficam restritas a esse projeto. Para este guia, mantenha **Permissions** em **All**, pois uma chave **Read only** ou **Restricted** sem acesso de escrita a **Responses** retorna 403 na solicitação abaixo. Consulte [Chaves de API](/docs/pt-BR/ai-gateway/configuration/api-keys.md) para conhecer as outras opções de permissão. Crie a chave e copie-a.

### 5. Execute uma solicitação

Defina a chave no terminal e envie uma solicitação ao endpoint Responses. `$TOQAN_API_KEY` contém a chave da etapa anterior, usada como token bearer.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
export TOQAN_API_KEY="your-api-key"

curl -X POST https://router.toqan.ai/eu/v3/router/responses \
  -H "Authorization: Bearer $TOQAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.4",
    "input": "Hello, world!"
  }'
```

Implantações auto-hospedadas e on-premise disponibilizam `/v3/router` no próprio hostname. Consulte [URLs base](/docs/pt-BR/reference/base-urls.md).

### 6. Inspecione a solicitação

Abra Traces para verificar a resposta, a latência, o uso de tokens e o custo.

## Próximos passos

> [card] [Fallbacks e novas tentativas](/docs/pt-BR/ai-gateway/features/retries.md)
>
> Mantenha as solicitações fluindo quando um provedor falhar.

> [card] [Modelos compatíveis](/docs/pt-BR/ai-gateway/supported-models.md)
>
> Explore o catálogo de modelos e os recursos dos provedores.

> [card] [Migre para o Toqan Router](/docs/pt-BR/ai-gateway/get-started/migrate.md)
>
> Migre uma aplicação existente do SDK da OpenAI, do OpenRouter ou do LiteLLM.

> [card] [Perguntas frequentes sobre modelos](/docs/pt-BR/ai-gateway/model-faq.md)
>
> Respostas a dúvidas comuns sobre modelos e seus recursos.

> [card] [Model Fusion](/docs/pt-BR/ai-gateway/model-fusion.md)
>
> Responda a uma solicitação com um painel de modelos e um juiz, sob um único ID de modelo.


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