Edição em Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# Guia da API do Mistral Large 4: primeira solicitação e custo em tokens

> Como chamar o Mistral Large 4 em Public Preview, ler a resposta e calcular um exemplo de custo por tokens com as tarifas oficiais.

By BIG CHANGE Editorial

Published: 2026-10-06T17:46:01.996Z
Updated: 2026-10-06T17:46:01.996Z
Canonical: https://bigchange.ai/blog/mistral-large-4-api-guide

![An unbranded desktop monitor displays model: mistral-large-4, choices[0].message.content and usage above a keyboard and a separate calculator.](https://bigchange.ai/api/media/file/mistral-large-4-api-guide-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE. The field names reflect Mistral's documentation; the image does not depict a screenshot, live API response, measured usage or test.

A Mistral abriu o Public Preview do Large 4 em 6 de outubro de 2026. Desenvolvedores podem chamar a API hospedada com o ID do modelo `mistral-large-4`. O cartão do modelo o descreve como de pesos abertos, enquanto a atualização da empresa prevê o lançamento completo para o fim de outubro. Não verificamos se há pesos para baixar nesta prévia. Este guia segue a documentação da Mistral; a BIG CHANGE não enviou uma solicitação à API nem mediu a saída do modelo.

## A grande mudança

- **O que mudou:** O novo carro-chefe da Mistral está disponível para desenvolvedores em uma prévia paga da API. O contexto documentado de 1 milhão de tokens e o codificador visual ampliam os tipos de material que um aplicativo pode enviar, embora este passo a passo use apenas texto.
- **Por que importa:** Uma equipe pode avaliar o Large 4 hoje pela interface de chat hospedada. As tarifas publicadas permitem calcular antes o custo variável de um teste pequeno. A qualidade da saída e a latência ainda precisam ser medidas no aplicativo da própria equipe.
- **O que acompanhar:** A Mistral diz que o lançamento completo está previsto para o fim deste mês. Equipes interessadas em hospedar o modelo por conta própria precisarão verificar se haverá pesos para baixar e em quais condições. O Public Preview pode receber atualizações silenciosas e não tem um caminho garantido para disponibilidade geral; a decisão de integração também depende da tolerância a esse ciclo de vida.

## Envie uma solicitação de texto

O [guia de início rápido da API](https://docs.mistral.ai/resources/cookbooks/quickstart) da Mistral recomenda criar uma conta Studio, ativar pagamentos para habilitar chaves de API e usar uma chave no endpoint de chat. Não menciona compra mínima. Armazene a chave como `MISTRAL_API_KEY` no ambiente. O [cartão do modelo](https://docs.mistral.ai/models/mistral-large-4-0) identifica a prévia como `mistral-large-4`; o exemplo antigo do guia de início rápido `mistral-large-latest` usa outro alias. A [política de ciclo de vida](https://docs.mistral.ai/inference/model-lifecycle) da Mistral diz que modelos Public Preview não recebem aliases `-latest` .

A solicitação abaixo usa o [endpoint documentado de chat completions](https://docs.mistral.ai/api). Sua tarefa é extrair dois fatos do cartão do modelo. Troque o prompt por material do aplicativo após verificar precisão e permissões.

```bash
curl https://api.mistral.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -d '{
    "model": "mistral-large-4",
    "messages": [
      {
        "role": "user",
        "content": "Extract the model name and context size from this text: Mistral Large 4. Context: 1M tokens. Answer in one sentence."
      }
    ]
  }'
```

O endpoint recebe uma string `model` e um array `messages` . A única mensagem tem o papel `user` e conteúdo textual. Para uma conclusão de chat comum bem-sucedida, a Mistral documenta resposta com `choices`; o texto gerado fica em `choices[0].message.content`. A resposta também inclui `model` e `usage`. Espere uma resposta que identifique o Mistral Large 4 e seu contexto de 1 milhão de tokens, mas a redação exata é gerada e não foi conferida pela BIG CHANGE. Veja o `usage` retornado para obter a contagem real de tokens; não trate as palavras visíveis do prompt como tokens.

O cartão lista saídas estruturadas, chamadas de função, perguntas e respostas sobre documentos, chat completions, processamento em lote, agentes e ferramentas integradas. Descreve um codificador visual, mas esta solicitação de texto não estabelece o formato do payload de imagem nem testa compreensão visual. Consulte a documentação do recurso antes de adicionar arquivos, imagens ou ferramentas a um aplicativo.

## Estime o custo variável

Segundo o [cartão do modelo de 6 de outubro](https://docs.mistral.ai/models/mistral-large-4-0), a entrada padrão custa **US$ 0,68 por milhão de tokens**, a entrada em cache **US$ 0,07 por milhão** e a saída **US$ 2,09 por milhão** . Para uma solicitação ilustrativa com 1.000 tokens de entrada sem cache e 200 de saída, a cobrança por tokens é `(1,000 × $0.68 + 200 × $2.09) ÷ 1,000,000 = $0.001098`. Esses valores são hipóteses de cálculo, não uma execução medida da solicitação acima. Os termos do plano e outras cobranças ficam fora do exemplo.

O contexto de 1 milhão de tokens é o limite combinado para entrada e saída. As [limitações conhecidas](https://docs.mistral.ai/resources/known-limitations) da Mistral dizem que uma solicitação longa demais retorna `400 Bad Request`. A plataforma também aplica limites de taxa por organização, variáveis por plano e modelo, e retorna `429 Too Many Requests` quando excedidos. Confira modelos e limites disponíveis antes de construir com base na prévia.

A [política de ciclo de vida](https://docs.mistral.ai/inference/model-lifecycle) da Mistral define Public Preview como uma versão quase final, sujeita a atualizações silenciosas. Não garante disponibilidade geral e prevê aviso de descontinuação com um mês de antecedência. Mantenha explícito o ID do modelo na integração, registre modelo e uso de tokens retornados em cada solicitação e refaça as verificações do aplicativo quando a prévia mudar. São precauções baseadas nos termos publicados, não resultados de testes da BIG CHANGE.

## Fontes e leituras adicionais

- [Cartão do modelo Mistral Large 4](https://docs.mistral.ai/models/mistral-large-4-0), datado de 6 de outubro de 2026. Lista o ID `mistral-large-4`, o status Public Preview Open v26.10, contexto de 1 milhão de tokens, recursos e preços atuais.
- [Atualização corporativa da Mistral](https://gc.linkedin.com/company/mistralai), de 6 de outubro de 2026, diz que o modelo já está disponível em prévia e que o lançamento completo está previsto para o fim do mês. O [anúncio de lançamento](https://mistral.ai/news/mistral-large-4/) não estava disponível na ferramenta de busca. Não verificamos arquivo de pesos para baixar nem data exata de publicação.
- [Guia de início rápido da API](https://docs.mistral.ai/resources/cookbooks/quickstart) e [referência do endpoint de chat](https://docs.mistral.ai/api) explicam ativação de pagamentos para chaves, campos da solicitação e estrutura da resposta. O código acima adapta o exemplo geral de chat ao ID do Large 4.
- [Política de ciclo de vida do modelo](https://docs.mistral.ai/inference/model-lifecycle) e [limitações conhecidas](https://docs.mistral.ai/resources/known-limitations) explicam atualizações da prévia, aviso de descontinuação, erros de contexto e limites de taxa.

## Sources

- [Cartão do modelo Mistral Large 4](https://docs.mistral.ai/models/mistral-large-4-0) — Fonte primária sobre Public Preview Open v26.10, ID do modelo, contexto, recursos listados e preços.
- [Guia de início rápido da API da Mistral](https://docs.mistral.ai/resources/cookbooks/quickstart) — Fonte primária sobre conta, ativação de pagamentos e início rápido geral do chat.
- [Referência da API chat completions da Mistral](https://docs.mistral.ai/api) — Fonte primária para a solicitação documentada e os campos de resposta.
- [Ciclo de vida dos modelos da Mistral](https://docs.mistral.ai/inference/model-lifecycle) — Fonte primária sobre atualização, alias e descontinuação do Public Preview.
- [Limitações conhecidas da Mistral](https://docs.mistral.ai/resources/known-limitations) — Fonte primária sobre erros de janela de contexto e limites de taxa.
- [Atualização da Mistral AI](https://gc.linkedin.com/company/mistralai) — A atualização datada afirma que a prévia está disponível e que o lançamento completo é esperado para o fim de outubro; não confirma a data de pesos para baixar.