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

# Modelos e pacotes

> Qual modelo pertence a qual pacote, como escolher, como verificar

## Dois pacotes, dois modelos

| Pacote | Nome do modelo no seu app | Use para |
| - | - | - |
| **GPT** | `gpt-5.6-sol` | Programação, refatoração, depuração, raciocínio de múltiplas etapas, documentos longos. O pacote padrão, mais barato por token |
| **GPT Astra** | `gpt-astra` | A geração mais recente, mais forte que `sol`, preço mais alto por token. Para os trabalhos mais difíceis |
| **Claude** | `claude-opus-5`, `claude-opus-5-5`, `claude-fable-5-1`, `claude-fable-5`, `claude-sonnet-5`, `claude-sonnet-4-6`, `claude-haiku-4-5` | Claude Code, o SDK da Anthropic ou qualquer app compatível com OpenAI. Créditos por modelo: Opus ≈ 1/token, Fable ≈ 2, Sonnet/Haiku mais baratos |

O modelo segue o pacote: **uma chave GPT só pode chamar `gpt-5.6-sol`, uma chave Astra só pode chamar `gpt-astra`**. Chamar entre pacotes retorna "No available channel for model ...". Para usar ambos, compre dois códigos e configure uma chave por app.

<Warning>
  Os nomes dos modelos devem corresponder **exatamente**, diferenciando maiúsculas de minúsculas. `gpt-5.6-Sol`, `gpt5.6-sol`, `GPT-astra` estão todos errados. Copie da tabela.
</Warning>

## Capacidades compartilhadas

* **Chat Completions** e **Responses API**, com streaming, chamadas de ferramentas e modo JSON.
* **Visão**: envie capturas de tela de erros, gráficos, imagens com texto. Ver [cURL / Python](/pt/setup/api).
* **Raciocínio**: ambos são modelos de raciocínio. Você pode definir `reasoning_effort` (`low`, `medium`, `high`) na requisição; se não fizer isso, o gateway usa um nível alto para qualidade consistente. Os tokens de raciocínio são reportados em `usage.completion_tokens_details.reasoning_tokens` e contam contra o limite como tokens de saída.

## Como escolher

<Tabs>
  <Tab title="Programação">
    `gpt-5.6-sol` lida com a maioria do trabalho de programação. Para tarefas muito difíceis, raciocínio profundo ou contexto muito longo, `gpt-astra`.
  </Tab>

  <Tab title="Tradução, resumos, chat">
    `gpt-5.6-sol`. O trabalho mecânico não precisa do modelo caro; para economizar mais, adicione `"reasoning_effort": "low"` ao chamar a partir do código.
  </Tab>

  <Tab title="Agentes de longa duração (Codex, Cline)">
    Os agentes reenviam todo o contexto a cada turno, então os tokens acabam rápido. `gpt-5.6-sol` é a escolha equilibrada; mude para `gpt-astra` apenas para tarefas que `sol` não consegue concluir.
  </Tab>
</Tabs>

## Listar os modelos que sua chave pode chamar

```bash theme={null}
curl https://gpt.teamsoclo.site/v1/models \
  -H "Authorization: Bearer sk-xxx"
```

O resultado lista exatamente os modelos que esta chave tem permissão para usar. O que não estiver listado não pode ser chamado com ela.

## Limite e taxa

* O limite é cobrado pelos tokens realmente usados (entrada + saída + raciocínio), exatamente o `usage` retornado.
* Cada chave tem um limite de requisições por minuto definido pelo seu pacote; ultrapassá-lo retorna `429`, aguarde o próximo minuto. Adicione um atraso entre chamadas em scripts em lote.
* Limite restante, data de expiração e modelos permitidos: [gpt.teamsoclo.site/check](https://gpt.teamsoclo.site/check).


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