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

# Referência da API

> O BetterToken oferece as APIs OpenAI-compatible Chat Completions e Responses, além de Anthropic-compatible Messages. Escolha o formato usado pelo seu cliente.

O BetterToken oferece as APIs OpenAI-compatible Chat Completions e Responses, além de Anthropic-compatible Messages. Escolha o formato usado pelo seu cliente.

## Escolha uma API

| API | POST | Auth |
| - | - | - |
| [Chat Completions](/pt-br/api-reference/chat-completions.md) | `/v1/chat/completions` | `Bearer` |
| [Responses](/pt-br/api-reference/responses.md) | `/v1/responses` | `Bearer` |
| [Messages](/pt-br/api-reference/messages.md) | `/v1/messages` | `x-api-key` |
| [Image generation](/pt-br/api-reference/images-generations.md) | `/v1/images/generations` | `Bearer` |
| [Image editing](/pt-br/api-reference/images-edits.md) | `/v1/images/edits` | `Bearer` |

## Conexão com Chat Completions

| Campo | Valor |
| - | - |
| Base URL | `https://bettertoken.ai/v1` |
| URL completa da requisição | `https://bettertoken.ai/v1/chat/completions` |
| Método | `POST` |
| Autorização | `Bearer YOUR_API_KEY` |
| Modelo | `YOUR_MODEL_ID` |

Copie um Model ID atual do [model plaza](https://bettertoken.ai/pricing) ou da janela **Setup** da API Key no Console.

> [!WARNING]
>
> Quando uma ferramenta solicitar uma **Base URL**, informe `https://bettertoken.ai/v1`. Use `https://bettertoken.ai/v1/chat/completions` somente quando a ferramenta pedir explicitamente a URL completa da requisição.

## Teste rápido

```bash theme={null}
curl "https://bettertoken.ai/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      {
        "role": "user",
        "content": "Hello"
      }
    ]
  }'
```

Uma resposta bem-sucedida contém `choices[0].message.content`.

## Testes interativos e exemplos de SDK

Abra [API Chat Completions da OpenAI](/pt-br/api-reference/chat-completions.md) para:

* Enviar uma requisição pelo Playground
* Consultar os parâmetros da requisição e o esquema da resposta
* Copiar exemplos em curl, Python e JavaScript

> [!NOTE]
>
> Nunca armazene uma API Key real em documentação, capturas de tela ou código público. Substitua `YOUR_API_KEY` e `YOUR_MODEL_ID` pelos seus próprios valores.


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