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

# Início rápido com LLM

Sunra oferece três endpoints de API para LLM, cada um seguindo um formato diferente. Os três utilizam a mesma autenticação e URL base (`https://api-llm.sunra.ai`), então você pode escolher o formato que melhor se encaixa no seu stack.

Antes de começar, obtenha uma chave de API no seu [painel de controle](https://sunra.ai/dashboard/api-tokens).

## Chat Completions — `/v1/chat/completions`

O endpoint de [Chat Completions](/pt/llm/chat) segue o formato de **OpenAI Chat Completions**. Ele aceita uma lista de mensagens com roles (`system`, `user`, `assistant`) e retorna uma resposta gerada.

Use este endpoint quando quiser compatibilidade direta com os SDKs e ferramentas da OpenAI.

**Principais recursos:** streaming, chamadas de função, visão (imagens, áudio, vídeo, arquivos), raciocínio, saídas estruturadas (JSON schema / gramática), logprobs.

```bash theme={null}
curl -X POST https://api-llm.sunra.ai/v1/chat/completions \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [
      { "role": "system", "content": "You are a helpful assistant." },
      { "role": "user", "content": "What is the capital of France?" }
    ]
  }'
```

## Anthropic Messages — `/v1/messages`

O endpoint de [Anthropic Messages](/pt/llm/messages) segue o formato da **API Anthropic Messages**. Ele usa roles de mensagem `user` / `assistant` com blocos de conteúdo enriquecido e um parâmetro `system` separado.

Use este endpoint quando quiser acesso nativo aos modelos Anthropic Claude e recursos como pensamento estendido, cache de prompts, citações e ferramentas integradas (busca web, execução de código).

**Principais recursos:** streaming, pensamento estendido, cache de prompts, uso de ferramentas (personalizadas + integradas), entrada de PDF/documentos, citações, saídas estruturadas.

```bash theme={null}
curl -X POST https://api-llm.sunra.ai/v1/messages \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello, how are you?" }
    ]
  }'
```

## Responses — `/v1/responses`

O endpoint de [Responses](/pt/llm/responses) segue o formato da **API OpenAI Responses**. Ele aceita itens de entrada flexíveis (mensagens, chamadas de função, raciocínio) e retorna itens de saída estruturados.

Use este endpoint quando precisar dos recursos mais recentes da OpenAI Responses, como busca web integrada, busca de arquivos, interpretador de código, uso de computador, integração de ferramentas MCP ou geração de imagens.

**Principais recursos:** streaming, chamadas de função, busca web, busca de arquivos, interpretador de código, uso de computador, ferramentas MCP, geração de imagens, raciocínio, saídas estruturadas.

```bash theme={null}
curl -X POST https://api-llm.sunra.ai/v1/responses \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "input": [
      { "type": "message", "role": "user", "content": "Hello, how are you?" }
    ]
  }'
```

## Como escolher o endpoint certo

|                            | Chat Completions                  | Anthropic Messages                | Responses                                                                     |
| -------------------------- | --------------------------------- | --------------------------------- | ----------------------------------------------------------------------------- |
| **Formato**                | OpenAI Chat                       | Anthropic Messages                | OpenAI Responses                                                              |
| **Ideal para**             | Compatibilidade com SDK da OpenAI | Recursos nativos do Claude        | Recursos mais recentes da OpenAI                                              |
| **Streaming**              | SSE                               | SSE                               | SSE                                                                           |
| **Chamadas de função**     | Sim                               | Sim (personalizadas + integradas) | Sim                                                                           |
| **Raciocínio**             | Sim                               | Pensamento estendido              | Sim                                                                           |
| **Saída estruturada**      | JSON schema, gramática            | JSON schema                       | JSON schema                                                                   |
| **Ferramentas integradas** | —                                 | Busca web, execução de código     | Busca web, busca de arquivos, interpretador de código, uso de computador, MCP |

Os três endpoints compartilham a mesma autenticação — basta passar sua chave de API como token Bearer no cabeçalho `Authorization`.