Edição Markdown

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

# Guia da API Mistral Large 4: primeiro pedido e custo em tokens

> Como chamar o Mistral Large 4 em Public Preview, ler a resposta e calcular o custo de exemplo segundo preços 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. Os programadores podem chamar a API alojada com o ID do modelo `mistral-large-4`. O cartão descreve-o como modelo de pesos abertos; a actualização da empresa prevê o lançamento completo para mais tarde em Outubro. Não verificámos pesos descarregáveis para esta pré-visualização. Este guia segue os documentos da Mistral; a BIG CHANGE não enviou pedidos à API nem mediu resultados.

## A grande mudança

- **O que mudou:** O novo modelo principal da Mistral está disponível através de uma pré-visualização paga da API. O contexto documentado de 1 milhão de tokens e o codificador visual alargam os materiais que uma aplicação pode enviar, embora este percurso use apenas texto.
- **Porque importa:** Uma equipa pode avaliar hoje o Large 4 pela interface de chat alojada. Os preços publicados permitem antecipar o custo variável de um pequeno teste. A qualidade e a latência ainda têm de ser medidas na aplicação da equipa.
- **O que acompanhar:** A Mistral prevê o lançamento completo para mais tarde neste mês. Equipas interessadas em alojamento próprio terão de verificar se haverá pesos para descarregar e em que condições. O Public Preview pode receber actualizações silenciosas e não tem passagem garantida à disponibilidade geral; a decisão depende também da tolerância a este ciclo de vida.

## Enviar um pedido 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, activar pagamentos para disponibilizar chaves API e usar uma chave no endpoint de chat. Não indica compra mínima. Guarde a chave no ambiente como `MISTRAL_API_KEY` . O [cartão do modelo](https://docs.mistral.ai/models/mistral-large-4-0) identifica a pré-visualização como `mistral-large-4`; o guia mais antigo `mistral-large-latest` dá como exemplo outro alias. Segundo a Mistral, a [política do ciclo de vida](https://docs.mistral.ai/inference/model-lifecycle) não atribui aos modelos Public Preview aliases com o sufixo `-latest`.

O pedido abaixo usa o [endpoint documentado de chat completions](https://docs.mistral.ai/api) . A tarefa é retirar dois factos do texto do cartão do modelo. Troque o prompt por material da sua aplicação depois de verificar a exactidão e as 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 `model` string e uma `messages` matriz. A única mensagem tem o papel `user` e conteúdo de texto. Uma conclusão normal bem-sucedida contém `choices`; o texto gerado está em `choices[0].message.content`. A resposta também inclui `model` e `usage`. É de esperar que identifique Mistral Large 4 e o contexto de 1 milhão de tokens; a formulação exacta é gerada e não foi verificada pela BIG CHANGE. Consulte os `usage` devolvidos para obter as contagens reais, sem tratar as palavras visíveis como tokens.

O cartão lista resultados estruturados, chamadas de funções, perguntas e respostas sobre documentos, chat completions, processamento em lote, agentes e ferramentas incorporadas. Descreve um codificador visual, mas o pedido textual não estabelece um formato de imagem nem testa compreensão visual. Consulte a documentação relevante antes de adicionar ficheiros, imagens ou ferramentas à aplicação.

## Estimar o custo variável

Segundo o [cartão de 6 de Outubro](https://docs.mistral.ai/models/mistral-large-4-0) , a entrada normal custa **0,68 USD por milhão de tokens** , a entrada em cache **0,07 USD por milhão** e a saída **2,09 USD por milhão** . Num exemplo com 1 000 tokens de entrada sem cache e 200 de saída, a cobrança é `(1,000 × $0.68 + 200 × $2.09) ÷ 1,000,000 = $0.001098`. São pressupostos de cálculo, não medição do pedido acima. O plano da conta e outros encargos não estão incluídos.

O contexto de 1 milhão de tokens é a capacidade conjunta máxima de entrada e saída. As [limitações conhecidas](https://docs.mistral.ai/resources/known-limitations) dizem que um pedido excessivamente longo devolve `400 Bad Request`. A plataforma aplica limites de velocidade por organização, variáveis por plano e modelo, e devolve `429 Too Many Requests` quando ultrapassados. Verifique os modelos e limites da conta antes de depender da pré-visualização.

A [política do ciclo de vida](https://docs.mistral.ai/inference/model-lifecycle) define Public Preview como quase final, mas sujeito a actualizaçõ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, registe o modelo e uso de tokens devolvidos em cada pedido e repita as verificações da aplicação quando a pré-visualização 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. Indica o ID `mistral-large-4`, estado Public Preview Open v26.10, contexto de 1 milhão de tokens, funcionalidades e preços actuais.
- [Actualização da empresa Mistral](https://gc.linkedin.com/company/mistralai), de 6 de Outubro de 2026, diz que o modelo está disponível para pré-visualização e o lançamento completo está previsto para mais tarde no mês. O [anúncio de lançamento](https://mistral.ai/news/mistral-large-4/) não estava disponível na ferramenta de pesquisa. Não verificámos ficheiro de pesos descarregável nem data exacta 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 a activação de pagamentos para chaves API, os campos do pedido e a estrutura da resposta. O código adapta o exemplo geral ao ID Large 4.
- [Política do ciclo de vida do modelo](https://docs.mistral.ai/inference/model-lifecycle) e [limitações conhecidas](https://docs.mistral.ai/resources/known-limitations) explicam actualizações, aviso de descontinuação, erros de contexto e limites de velocidade.

## Sources

- [Cartão do modelo Mistral Large 4](https://docs.mistral.ai/models/mistral-large-4-0) — Fonte primária para Public Preview Open v26.10, ID, contexto, funcionalidades e preços.
- [Guia de início rápido da API Mistral](https://docs.mistral.ai/resources/cookbooks/quickstart) — Fonte primária sobre conta, activação de pagamentos e guia geral de chat.
- [Referência da API chat completions Mistral](https://docs.mistral.ai/api) — Fonte primária para o pedido documentado e os campos da resposta.
- [Ciclo de vida dos modelos Mistral](https://docs.mistral.ai/inference/model-lifecycle) — Fonte primária para condições de actualização, alias e descontinuação.
- [Limitações conhecidas da Mistral](https://docs.mistral.ai/resources/known-limitations) — Fonte primária para erros de janela de contexto e limites de velocidade.
- [Actualização Mistral AI](https://gc.linkedin.com/company/mistralai) — A actualização datada diz que a pré-visualização está disponível e o lançamento completo está previsto para mais tarde em Outubro; não confirma a data dos pesos descarregáveis.