Mistral: Mistral Medium 3.1 (batch)

Mistral Medium 3.1 é um modelo de texto e imagem para respostas de conversa, perguntas documentais e extração estruturada. O contexto de 128k indicado pelo fabricante e as funcionalidades enumeradas de chamadas de funções, saídas previstas e prefixos apoiam explicações baseadas em fontes e fluxos de edição dirigida.

Ailoot Ultra · Processamento em lote POST /v1/batches mistralai/mistral-medium-3.1:batch

Sobre o modelo

Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo.

Mistral Medium 3.1 é uma edição multimodal da Mistral AI para compreensão textual e visual. O fabricante descreve esta revisão como uma melhoria do tom e do desempenho dentro da linha Medium 3. Aceita texto e imagens e produz texto: uma explicação, resposta documental, registo estruturado ou proposta de chamada de função. O identificador fixo do fabricante para esta edição é mistral-medium-2508.

Contexto e edição específica

A página do modelo documenta uma janela de contexto de 128k. Use-a para conservar juntos os trechos de origem relacionados, os elementos de prova em imagem, a conversa e a tarefa do utilizador. Identifique os papéis dos documentos e a pergunta a responder antes de fornecer uma coleção extensa. Um contexto longo pode apoiar uma comparação focada enquanto o artefacto final continua a ser uma tabela curta ou uma secção revista.

Medium 3.1 mantém a sua própria especificação. O contexto de 256k, a arquitetura densa de 128 mil milhões de parâmetros e os modos configuráveis de raciocínio híbrido descritos para Medium 3.5 não devem ser atribuídos a esta entrada. A página do 3.1 não fornece uma contagem de parâmetros nem um valor separado de extensão máxima de resposta que se possa substituir com segurança pelo do modelo posterior.

Saída estruturada e funções

O fabricante enumera saídas estruturadas, chamadas de funções e saídas previstas entre as funcionalidades desta edição. Para uma tarefa de extração estruturada, defina campos obrigatórios, tipos esperados e tratamento de informação ausente da fonte. Um registo pode conter o identificador do documento, a afirmação extraída, a localização de origem e a questão que permanece. Peça apenas o registo quando um programa o for analisar ou mantenha uma explicação em prosa separada quando alguém tiver de inspecionar a interpretação.

A documentação comum de saída estruturada da Mistral distingue o modo JSON de um esquema personalizado. O modo JSON exige uma instrução explícita sobre o formato JSON pretendido, enquanto a via personalizada define uma estrutura mais específica. Trata-se de formatação do resultado textual, não de uma nova modalidade de conteúdo nem de uma ação externa.

Para funções, a aplicação define a operação e os argumentos disponíveis, o modelo seleciona uma chamada adequada e prepara os valores, e a aplicação executa-a. O resultado passa então a ser informação para a resposta seguinte. Um assistente documental pode usar uma consulta para obter dados de referência em falta, mas apenas se a aplicação envolvente fornecer essa consulta e devolver o resultado efetivo. Mantenha associados a chamada proposta e os dados devolvidos.

Edições previstas e prefixos de resposta

As saídas previstas são úteis quando a maior parte do resultado pretendido já é conhecida, como um documento ou ficheiro de código que precise de uma edição limitada. Forneça o conteúdo existente e descreva a alteração com precisão, incluindo o que deve permanecer inalterado. Um pedido pode atualizar a terminologia de uma secção ou substituir um detalhe de implementação preservando o resto do documento. A previsão contém conteúdo de saída esperado, não uma alteração concluída e aplicada a um ficheiro.

A página do modelo enumera também continuação por prefixo de resposta. Na documentação de conversa do fabricante, um prefixo fornece um início conhecido para a resposta do assistente, após o qual a geração continua. Um início conhecido e um corpo previsto resolvem problemas de preparação diferentes. O processamento em lote e as interfaces de agente ou conversa são igualmente funcionalidades de fluxo de trabalho, não edições separadas de imagem, áudio ou raciocínio do Medium 3.1.

Perguntas documentais e visuais

O fluxo documentado de perguntas sobre documentos combina texto, estrutura e formatação preparados por OCR com análise pelo modelo de linguagem. Pergunte pela condição, trecho ou relação específicos exigidos pela tarefa. Uma comparação pode identificar os documentos de origem e pedir afirmações comuns, conflitos e pormenores por resolver, conservando a localização da fonte junto de cada conclusão.

O guia de visão do fabricante inclui explicitamente Medium 3.1. Uma pergunta visual direta pode fornecer um gráfico, imagem documental ou captura de ecrã legível e perguntar que elementos de prova visíveis sustentam uma conclusão. Preserve eixos, unidades, etiquetas e o contexto em torno de um campo recortado. Se forem fornecidas várias imagens, identifique a sua ordem e papel, em vez de deixar o modelo inferir qual é o original, a revisão ou a referência.

Por exemplo, associe um requisito de processo escrito a uma captura de ecrã e peça uma tabela de correspondências visíveis, diferenças e perguntas que exigem mais informação. Outra tarefa pode fornecer duas versões de um documento e pedir um trecho revisto que preserve as condições comuns e resolva uma inconsistência identificada. São aplicações propostas das capacidades documentadas de visão, documentos e edição, com o resultado exigido definido previamente.

Preparação do artefacto final

Dê ao assistente um papel claro, o material de origem a usar e o formato da resposta. Mantenha regras duradouras de resposta distintas do documento examinado e indique a língua final e a terminologia. Uma resposta útil pode separar um facto extraído, a sua fonte e uma interpretação, facilitando a inspeção face a um único resumo combinado.

O resultado documentado continua a ser texto. Ferramentas externas, alterações de ficheiros e processamento documental adicional pertencem à aplicação ligada à conversa. Preserve a edição identificada como Medium 3.1 e o contexto de 128k, e peça a explicação, o registo estruturado ou a revisão dirigida de que o próximo passo efetivamente precisa.

Ailoot Ultra · Processamento em lote POST /v1/batches mistralai/mistral-medium-3.1:batch

mistralai/mistral-medium-3.1:batch

Mistral /mistralai/mistral-medium-3.1:batch

Introdução

Entradas aceites: Texto
Resultados: Texto

Disponível no Ailoot · entradas e métodos

Ailoot Ultra · Processamento em lote POST /v1/batches

Entrada: text
Saída: text
Formato de saída: JSON em linha de results[].response.body

Campo	Tipo	Requisito	Valores e limites	Predefinição
Campo`endpoint`	Tipo`string`	RequisitoObrigatório	Valores e limites /v1/chat/completions	Predefinição—
Campo`model`	Tipo`string`	RequisitoObrigatório	Valores e limites mistralai/mistral-medium-3.1:batch	Predefinição—
Campo`requests`	Tipo`batch_item[]`	RequisitoObrigatório	Valores e limites Número mínimo de elementos: 1	Predefinição—
Campo`requests[].custom_id`	Tipo`string`	RequisitoObrigatório	Valores e limites	Predefinição—
Campo`requests[].body.messages`	Tipo`message[]`	RequisitoObrigatório	Valores e limites	Predefinição—
Campo`completion_window`	Tipo`string`	RequisitoOpcional	Valores e limites 24h	Predefinição—
Campo`provider`	Tipo`object\|null`	RequisitoOpcional	Valores e limites	Predefinição—
Campo`requests[].body.model`	Tipo`string`	RequisitoOpcional	Valores e limites mistralai/mistral-medium-3.1:batch, mistralai/mistral-medium-3.1	Predefinição—
Campo`provider.only`	Tipo`string[]`	RequisitoOpcional	Valores e limites mistral	Predefinição—
Campo`provider.allow_fallbacks`	Tipo`boolean\|null`	RequisitoOpcional	Valores e limites false, null	Predefinição—

Parâmetros e ciclo de vida do método

Parâmetro	Contrato
Parâmetro`content_type`	Contratoapplication/json
Parâmetro`required`	Contratoendpoint, model, requests
Parâmetro`material_types`	Contratotext
Parâmetro`representation`	Contratorequests[] em linha; cada item tem custom_id e body
Parâmetro`request_endpoint_profile`	Contrato/v1/chat/completions
Parâmetro`file_material`	ContratoQuem faz a chamada pode ler localmente o conteúdo JSONL UTF-8 efetivo para requests[]. Não é utilizada qualquer finalidade de carregamento, input_file_id ou referência a ficheiro. Se o material do cliente estiver em falta ou vazio, a preparação é interrompida antes do POST.
Parâmetro`serialization_order`	Contratoendpoint, model, provider (se fornecido), completion_window (se fornecido), requests em último lugar
Parâmetro`optional_controls`	Contratoprovider.only, provider.allow_fallbacks, completion_window
Parâmetro`schema_scope`	ContratoCorpos de pedidos de texto de Chat Completions na estrutura de lote em linha documentada.

Ciclo de vida: asynchronous

GET /v1/batches/{operation_id} · response.id efetivo da resposta original de criação; mesmo utilizador/chave/grupo

Tarifários

As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado.

Modo rápido: Não especificado Quando o modo rápido está selecionado
Modo flex: Não especificado Quando o modo flex está selecionado
Esforço máximo de raciocínio: Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default)
Preços da cache explícita: Não ativado Quando é pedida cache explícita

Tarifas Ailoot

Preços por configuração

Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.

Configuração	Tabela de tarifas	Tokens de contexto, mais de	Tokens de contexto, até ao limite inclusive	Custo
ConfiguraçãoTarifas base dos tokens	Tabela de tarifasTarifa base	Tokens de contexto, mais de—	Tokens de contexto, até ao limite inclusiveSem limite superior	Custo Entrada · Tokens de entrada $0.0004 / 1K tokens Saída · Tokens de saída $0.002 / 1K tokens Entrada · Leitura da cache $0.00004 / 1K tokens Entrada · Escrita na cache — / 1K tokens Entrada · Escrita na cache, 1 hora — / 1K tokens
ConfiguraçãoEscalão 1 por comprimento do pedido	Tabela de tarifas—	Tokens de contexto, mais de0	Tokens de contexto, até ao limite inclusiveSem limite superior	Custo Entrada · Tokens de entrada $0.0004 / 1K tokens Saída · Tokens de saída $0.002 / 1K tokens Entrada · Leitura da cache $0.00004 / 1K tokens Entrada · Escrita na cache — / 1K tokens Entrada · Escrita na cache, 1 hora — / 1K tokens

O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. Como funcionam a reserva e a liquidação →

Exemplos de pedidos

Ailoot Ultra · Processamento em lote

curl · dados de teste preservadosPython HTTP · JSONL real do clientePython · guarde cada resultado concluído

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json
from pathlib import Path
body=json.loads('{"endpoint":"/v1/chat/completions","model":"mistralai/mistral-medium-3.1:batch","requests":[{"custom_id":"req-0001","body":{"messages":[{"role":"user","content":"Hello!"}],"max_tokens":16}}]}')
Path("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8")
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json

import json, os
from pathlib import Path
from urllib.request import Request, urlopen

def prepare_requests(customer_path):
    path = Path(customer_path)
    if not path.is_file(): raise ValueError("Customer JSONL file is missing")
    items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]
    if not items: raise ValueError("Customer JSONL contains no requests")
    ids = set()
    for item in items:
        if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body")
        cid = item["custom_id"]
        if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique")
        ids.add(cid)
        if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages")
        supplied_model = item["body"].get("model")
        if supplied_model is not None and supplied_model not in ['mistralai/mistral-medium-3.1:batch', 'mistralai/mistral-medium-3.1']: raise ValueError("body.model must be an exact documented caller or wire ID")
    return {"endpoint":"/v1/chat/completions", "model":"mistralai/mistral-medium-3.1:batch", "requests":items}

if __name__ == "__main__":
    material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "")
    if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file")
    body = prepare_requests(material)
    key = os.environ.get("AILOOT_API_KEY", "")
    if not key: raise SystemExit("Set AILOOT_API_KEY")
    request = Request("https://api.ailoot.ai/v1/batches", data=json.dumps(body, ensure_ascii=False).encode("utf-8"), headers={"Authorization":"Bearer " + key, "Content-Type":"application/json"}, method="POST")
    with urlopen(request) as response:
        raw = response.read()
        Path("batch-create-response.json").write_bytes(raw)
        print(raw.decode("utf-8"))

import json
from pathlib import Path
raw = Path("batch-status-response.json").read_bytes()
response = json.loads(raw)
if response.get("status") != "completed":
    raise SystemExit("Keep the original operation; read its status without resubmitting")
results = response.get("results")
if not isinstance(results, list) or not results:
    raise SystemExit("Preserve the original response; completed results are missing")
Path("batch-results.jsonl").write_text("".join(json.dumps(item, ensure_ascii=False) + "\n" for item in results), encoding="utf-8")
# Preserve batch-status-response.json with aggregate usage and every result/error.

Receber e guardar os resultados

Ailoot Ultra · Processamento em lote

JSON em linha de results[].response.body

GET /v1/batches/{operation_id}

Verificar o estado da tarefa

curl · estado da operação original

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
BATCH_OPERATION_ID="$(python3 - <<'PY_ID'
import json
from pathlib import Path
from urllib.parse import quote
response = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8"))
operation = response.get("id")
if not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit")
print(quote(operation, safe=""))
PY_ID
)"
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json

Guardar todos os resultados concluídos

Guarde cada resposta, ficheiro e parte de conteúdo devolvidos na íntegra.

Conserve o JSON completo do estado original, todos os resultados/custom_id e o corpo completo da resposta ou do erro. Guarde os results[] concluídos em formato JSONL, sem filtrar.

Se for necessário verificar a resposta original

Preserve o ID original da operação. A resposta 503 result_pending_check inclui X-Should-Retry:false; nunca volte a enviar um lote original de estado desconhecido.

Campos da resposta

Campo	Tipo
Campo`results[].custom_id`	Tipostring
Campo`results[].response.body.choices[].message.content`	Tipostring\|null
Campo`results[].error`	Tipoobject\|null
Campo`usage`	Tipoobject\|null
Campo`id`	Tipostring
Campo`model`	Tipostring
Campo`endpoint`	Tipostring
Campo`status`	Tipostring
Campo`request_counts`	Tipoobject
Campo`results[].id`	Tipostring
Campo`results[].response.status_code`	Tipointeger
Campo`results[].response.request_id`	Tipostring

Erros e passos seguintes

Resposta	Condição	Passo seguinte
Resposta400 · `invalid_request_error`	CondiçãoEstrutura em linha documentada inválida, chaves duplicadas, identidade do item inválida ou conflito com as capacidades configuradas do modelo.	Passo seguinteCorrija os campos indicados antes de qualquer novo envio.
Resposta401 · `authentication_error`	CondiçãoChave de API inválida.	Passo seguinteUse a chave Ailoot autorizada.
Resposta403 · `permission_error`	CondiçãoGrupo de processamento em lote indisponível.	Passo seguinteVerifique os direitos de acesso da chave/do grupo.
Resposta422 · `invalid_request_error`	CondiçãoO processamento em lote usa faturação por débito do saldo; a criação com subscrição é rejeitada.	Passo seguinteUse o grupo autorizado com faturação por débito do saldo.
Resposta422 · `price_unavailable`	CondiçãoNão é possível calcular uma estimativa de preço para os dados de entrada do lote.	Passo seguinteConserve a resposta; use os dados de entrada documentados para a família.
Resposta402 · `billing_error`	CondiçãoReserva para processamento em lote indisponível.	Passo seguinteResolva a questão da admissão antes de um novo pedido.
Resposta503 · `price_unavailable`	CondiçãoPreço do método de processamento em lote/tarifas nativas indisponíveis.	Passo seguinteConserve a resposta; não substitua os preços.
Resposta503 · `api_error`	CondiçãoA rota exata do fornecedor está indisponível.	Passo seguinteConserve a resposta para corrigir a rota.
Resposta503 · `result_pending_check`	CondiçãoO resultado original requer verificação; X-Should-Retry:false.	Passo seguinteGuarde o operation_id/id original e consulte o respetivo estado; nunca repita o POST original.
Resposta404 · `not_found`	CondiçãoA operação de consulta do estado do lote não existe ou pertence a outra identidade.	Passo seguinteUse o id original exato e o mesmo utilizador/chave/grupo.

Aliases

Aliases do modelo

Ailoot Ultra mistralai/mistral-medium-3.1:batch

Aliases dos caminhos dos métodos

Use os caminhos dos métodos indicados acima.

IDs de chamada relacionados

mistralai/mistral-medium-3.1:batch

FAQ · Mistral: Mistral Medium 3.1 (batch)

Que entradas e resultados estão disponíveis?: POST /v1/batches · mistralai/mistral-medium-3.1:batch: text → text
Que campos utiliza o pedido?: POST /v1/batches · mistralai/mistral-medium-3.1:batch: endpoint, model, requests, completion_window, provider
Que limites se aplicam?: POST /v1/batches · mistralai/mistral-medium-3.1:batch: requests.min_items: 1

Mistral: Mistral Medium 3.1 (batch)