Mistral: Mistral Medium 3.1 (batch)

Mistral Medium 3.1 – teksto ir vaizdų modelis pokalbio atsakymams, klausimams apie dokumentus ir struktūruotam duomenų išgavimui. Gamintojo nurodytas 128 tūkst. žetonų kontekstas ir išvardytos funkcijų kvietimo, numatomos išvesties bei prefikso funkcijos palaiko šaltiniais grįstus paaiškinimus ir tikslinio redagavimo procesus.

Ailoot Ultra · Paketinis apdorojimas POST /v1/batches mistralai/mistral-medium-3.1:batch

Apie modelį

Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.

Mistral Medium 3.1 – multimodalinė Mistral AI versija tekstui ir vaizdams suprasti. Gamintojas aprašo šią versiją kaip gerinančią toną bei veikimą Medium 3 linijoje. Ji priima tekstą bei vaizdus ir generuoja tekstą: paaiškinimą, atsakymą apie dokumentą, struktūruotą įrašą ar siūlomą funkcijos kvietimą. Gamintojo fiksuotas šios versijos identifikatorius – mistral-medium-2508.

Kontekstas ir konkreti versija

Modelio puslapyje dokumentuotas 128 tūkst. žetonų konteksto langas. Jame laikykite kartu susijusias šaltinių ištraukas, vaizdinius įrodymus, pokalbį ir naudotojo užduotį. Prieš pateikdami didelį rinkinį, įvardykite dokumentų vaidmenis ir klausimą, į kurį reikia atsakyti. Ilgas kontekstas gali palaikyti tikslinį palyginimą, o galutinis artefaktas likti trumpa lentele ar pataisytu skyriumi.

Medium 3.1 išlaiko savą specifikaciją. Medium 3.5 aprašyti 256 tūkst. žetonų kontekstas, tankioji 128 mlrd. parametrų architektūra ir konfigūruojami hibridinio samprotavimo režimai neturi būti priskiriami šiam įrašui. 3.1 puslapis nepateikia parametrų skaičiaus ar atskiro didžiausio atsakymo ilgio, kuriuos būtų galima saugiai perimti iš vėlesnio modelio.

Struktūruota išvestis ir funkcijos

Gamintojas tarp šios versijos funkcijų nurodo struktūruotas išvestis, funkcijų kvietimą ir numatomas išvestis. Struktūruoto išgavimo užduočiai apibrėžkite privalomus laukus, laukiamus tipus ir šaltinyje nesančios informacijos tvarkymą. Įraše gali būti dokumento identifikatorius, išgautas teiginys, jo šaltinio vieta ir likęs klausimas. Prašykite vien įrašo, kai jį analizuos programa, arba prozos paaiškinimą laikykite atskirai, kai žmogui reikia patikrinti interpretaciją.

Bendra Mistral struktūruotos išvesties dokumentacija skiria JSON režimą nuo pasirinktinės schemos. JSON režimui reikia aiškios instrukcijos apie pageidaujamą JSON formatą, o pasirinktinis kelias apibrėžia konkretesnę struktūrą. Tai tekstinio rezultato formatavimas, o ne naujas turinio modalumas ar išorinis veiksmas.

Funkcijoms programa apibrėžia prieinamą operaciją ir argumentus, modelis parenka tinkamą kvietimą ir paruošia reikšmes, o programa jį vykdo. Tada rezultatas tampa informacija kitam atsakymui. Dokumento asistentas gali naudoti paiešką trūkstamiems atskaitos duomenims gauti, bet tik jei aplinkinė programa suteikia tą paiešką ir grąžina faktinį rezultatą. Siūlomą kvietimą ir grąžintus duomenis laikykite susietus.

Numatomi pakeitimai ir atsakymo prefiksai

Numatomos išvestys naudingos, kai dauguma pageidaujamo rezultato jau žinoma, pavyzdžiui, dokumentui ar kodo failui, kuriam reikia riboto pakeitimo. Pateikite esamą turinį ir tiksliai aprašykite pakeitimą, įskaitant tai, kas turi likti nepakeista. Užklausa gali atnaujinti vieno skyriaus terminiją ar pakeisti vieną įgyvendinimo detalę, išsaugant likusį dokumentą. Numatymas apima laukiamą išvesties turinį, o ne jau įvykdytą failo pakeitimą.

Modelio puslapyje taip pat nurodytas atsakymo prefikso tęsimas. Gamintojo pokalbio dokumentacijoje prefiksas pateikia žinomą asistento atsakymo pradžią, po kurios generavimas tęsiasi. Žinoma pradžia ir numatomas turinys sprendžia skirtingas paruošimo problemas. Paketinis apdorojimas ir agento ar pokalbio sąsajos taip pat yra darbo proceso funkcijos, o ne atskiros Medium 3.1 vaizdų, garso ar samprotavimo versijos.

Klausimai apie dokumentus ir vaizdus

Nurodytas dokumentų QnA procesas sujungia OCR paruoštą tekstą, struktūrą bei formatavimą su kalbos modelio analize. Klauskite apie konkrečią užduočiai reikalingą sąlygą, ištrauką ar ryšį. Palyginimas gali įvardyti šaltinių dokumentus ir prašyti bendrų teiginių, prieštaravimų bei neišspręstų detalių, išlaikant šaltinio vietą prie kiekvienos išvados.

Gamintojo regos gidas aiškiai apima Medium 3.1. Tiesioginis vaizdinis klausimas gali pateikti įskaitomą diagramą, dokumento vaizdą ar ekrano kopiją ir klausti, kokie matomi įrodymai pagrindžia išvadą. Išsaugokite ašis, vienetus, žymas ir kontekstą aplink iškirptą lauką. Jei pateikiami keli vaizdai, įvardykite jų tvarką bei vaidmenį, užuot palikę modeliui numanyti, kuris yra originalas, pakeitimas ar atskaitos šaltinis.

Pavyzdžiui, susiekite rašytinį proceso reikalavimą su ekrano kopija ir prašykite matomų atitikčių, skirtumų bei klausimų, kuriems reikia daugiau informacijos, lentelės. Kita užduotis gali pateikti dvi dokumento versijas ir prašyti pataisytos ištraukos, kuri išsaugo bendras jų sąlygas bei išsprendžia įvardytą nenuoseklumą. Tai siūlomi dokumentuotų vaizdinių, dokumentų ir redagavimo galimybių taikymai, iš anksto apibrėžus reikiamą rezultatą.

Galutinio artefakto paruošimas

Suteikite asistentui aiškų vaidmenį, naudotiną šaltinių medžiagą ir atsakymo formą. Ilgalaikes atsakymo taisykles atskirkite nuo nagrinėjamo dokumento ir nurodykite galutinę kalbą bei terminiją. Naudingas atsakymas gali atskirti išgautą faktą, jo šaltinį ir interpretaciją, todėl jį lengviau patikrinti nei vieną sujungtą santrauką.

Dokumentuotas rezultatas lieka tekstas. Išoriniai įrankiai, failų pakeitimai ir tolesnis dokumentų apdorojimas priklauso prie pokalbio prijungtai programai. Išsaugokite įvardytą Medium 3.1 versiją ir jos 128 tūkst. žetonų kontekstą bei prašykite paaiškinimo, struktūruoto įrašo ar tikslinio pakeitimo, kurio iš tikrųjų reikia kitam žingsniui.

Ailoot Ultra · Paketinis apdorojimas POST /v1/batches mistralai/mistral-medium-3.1:batch

mistralai/mistral-medium-3.1:batch

Mistral /mistralai/mistral-medium-3.1:batch

Pradžia

Leidžiamos įvestys: Tekstas
Rezultatai: Tekstas

Prieinama Ailoot · įvestys ir metodai

Ailoot Ultra · Paketinis apdorojimas POST /v1/batches

Įvestis: text
Išvestis: text
Išvesties formatas: tiesiogiai įterptas results[].response.body JSON

Laukas	Tipas	Reikalavimas	Reikšmės ir ribos	Numatyta
Laukas`endpoint`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos /v1/chat/completions	Numatyta—
Laukas`model`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos mistralai/mistral-medium-3.1:batch	Numatyta—
Laukas`requests`	Tipas`batch_item[]`	ReikalavimasPrivaloma	Reikšmės ir ribos Mažiausias elementų skaičius: 1	Numatyta—
Laukas`requests[].custom_id`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos	Numatyta—
Laukas`requests[].body.messages`	Tipas`message[]`	ReikalavimasPrivaloma	Reikšmės ir ribos	Numatyta—
Laukas`completion_window`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos 24h	Numatyta—
Laukas`provider`	Tipas`object\|null`	ReikalavimasNeprivaloma	Reikšmės ir ribos	Numatyta—
Laukas`requests[].body.model`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos mistralai/mistral-medium-3.1:batch, mistralai/mistral-medium-3.1	Numatyta—
Laukas`provider.only`	Tipas`string[]`	ReikalavimasNeprivaloma	Reikšmės ir ribos mistral	Numatyta—
Laukas`provider.allow_fallbacks`	Tipas`boolean\|null`	ReikalavimasNeprivaloma	Reikšmės ir ribos false, null	Numatyta—

Metodo parametrai ir gyvavimo ciklas

Parametras	Specifikacija
Parametras`content_type`	Specifikacijaapplication/json
Parametras`required`	Specifikacijaendpoint, model, requests
Parametras`material_types`	Specifikacijatext
Parametras`representation`	Specifikacijatiesiogiai įterptas requests[] masyvas; kiekvienas elementas turi custom_id ir body laukus
Parametras`request_endpoint_profile`	Specifikacija/v1/chat/completions
Parametras`file_material`	SpecifikacijaKlientas gali vietoje perskaityti faktinį UTF-8 JSONL turinį į requests[] masyvą. Įkėlimo purpose, input_file_id ar failo nuoroda nenaudojami. Jei kliento medžiagos nėra arba ji tuščia, parengimas sustabdomas prieš POST.
Parametras`serialization_order`	Specifikacijaendpoint, model, provider (jei pateiktas), completion_window (jei pateiktas), requests pateikite paskiausiai
Parametras`optional_controls`	Specifikacijaprovider.only, provider.allow_fallbacks, completion_window
Parametras`schema_scope`	SpecifikacijaTekstinių Chat Completions užklausų turiniai dokumentuotoje Batch paketo struktūroje, pateikiamoje pačioje užklausoje.

Gyvavimo ciklas: asynchronous

GET /v1/batches/{operation_id} · faktinė pradinės kūrimo užklausos atsakymo response.id reikšmė; tas pats naudotojas, raktas ir grupė

Planai

Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.

Spartusis režimas: Nenurodyta Pasirinkus spartųjį režimą
Flex režimas: Nenurodyta Pasirinkus flex režimą
Didžiausios samprotavimo pastangos: Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)
Išreikštinio podėlio kainodara: Neįjungta Kai prašoma išreikštinio podėlio

Ailoot įkainiai

Kainos pagal konfigūraciją

Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.

Konfigūracija	Įkainių lentelė	Konteksto tokenų daugiau nei	Konteksto tokenų iki imtinai	Mokestis
KonfigūracijaBaziniai žetonų įkainiai	Įkainių lentelėBazinis įkainis	Konteksto tokenų daugiau nei—	Konteksto tokenų iki imtinaiBe viršutinės ribos	Mokestis Įvestis · Įvesties tokenai $0.0004 / 1K tokenų Išvestis · Išvesties tokenai $0.002 / 1K tokenų Įvestis · Talpyklos skaitymas $0.00004 / 1K tokenų Įvestis · Rašymas į talpyklą — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val — / 1K tokenų
KonfigūracijaUžklausos ilgio pakopa 1	Įkainių lentelė—	Konteksto tokenų daugiau nei0	Konteksto tokenų iki imtinaiBe viršutinės ribos	Mokestis Įvestis · Įvesties tokenai $0.0004 / 1K tokenų Išvestis · Išvesties tokenai $0.002 / 1K tokenų Įvestis · Talpyklos skaitymas $0.00004 / 1K tokenų Įvestis · Rašymas į talpyklą — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val — / 1K tokenų

Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →

Užklausų pavyzdžiai

Ailoot Ultra · Paketinis apdorojimas

curl · išsaugotas testinių duomenų rinkinysPython HTTP · tikri kliento JSONL duomenysPython · išsaugokite kiekvieną užbaigtą rezultatą

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.

Gauti ir išsaugoti rezultatus

Ailoot Ultra · Paketinis apdorojimas

tiesiogiai įterptas results[].response.body JSON

GET /v1/batches/{operation_id}

Tikrinti užduoties būseną

curl · pirminės operacijos būsena

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

Išsaugoti visus baigtus rezultatus

Išsaugokite kiekvieną visą grąžintą atsakymą, failą ir turinio dalį.

Išsaugokite visą pradinės būsenos JSON, kiekvieną rezultatą ir custom_id bei visą atsakymo arba klaidos turinį. Užbaigtus results[] išsaugokite JSONL formatu nieko nefiltruodami.

Jei reikia patikrinti pradinį atsakymą

Išsaugokite pradinį operacijos ID. Atsakyme 503 result_pending_check pateikiama X-Should-Retry:false; niekada pakartotinai neteikite pradinio paketo, kurio baigtis nežinoma.

Atsakymo laukai

Laukas	Tipas
Laukas`results[].custom_id`	Tipasstring
Laukas`results[].response.body.choices[].message.content`	Tipasstring\|null
Laukas`results[].error`	Tipasobject\|null
Laukas`usage`	Tipasobject\|null
Laukas`id`	Tipasstring
Laukas`model`	Tipasstring
Laukas`endpoint`	Tipasstring
Laukas`status`	Tipasstring
Laukas`request_counts`	Tipasobject
Laukas`results[].id`	Tipasstring
Laukas`results[].response.status_code`	Tipasinteger
Laukas`results[].response.request_id`	Tipasstring

Klaidos ir tolesni veiksmai

Atsakymas	Sąlyga	Kitas žingsnis
Atsakymas400 · `invalid_request_error`	SąlygaNeteisinga dokumentuota tiesiogiai įterpto paketo struktūra, pasikartojantys raktai, netinkama elemento tapatybė arba konfliktas su sukonfigūruotomis modelio galimybėmis.	Kitas žingsnisPrieš bet kokį naują pateikimą pataisykite nurodytus laukus.
Atsakymas401 · `authentication_error`	SąlygaNegaliojantis API raktas.	Kitas žingsnisNaudokite leistiną Ailoot raktą.
Atsakymas403 · `permission_error`	SąlygaPaketinio apdorojimo grupė neprieinama.	Kitas žingsnisPatikrinkite rakto ir grupės prieigos teises.
Atsakymas422 · `invalid_request_error`	SąlygaPaketinis apdorojimas apmokamas iš balanso; kūrimo užklausos su prenumeratos apmokėjimu atmetamos.	Kitas žingsnisNaudokite leistiną grupę, kurios užklausos apmokamos iš balanso.
Atsakymas422 · `price_unavailable`	SąlygaNepavyksta apskaičiuoti paketinio apdorojimo įvesties kainos.	Kitas žingsnisIšsaugokite atsakymą; naudokite dokumentuotą šios API šeimos įvestį.
Atsakymas402 · `billing_error`	SąlygaPaketiniam apdorojimui reikalingas rezervas neprieinamas.	Kitas žingsnisPrieš teikdami naują užklausą išspręskite užklausos priėmimo problemą.
Atsakymas503 · `price_unavailable`	SąlygaPaketinio apdorojimo metodo kaina arba savieji sistemos įkainiai neprieinami.	Kitas žingsnisIšsaugokite atsakymą; nekeiskite kainų kitomis.
Atsakymas503 · `api_error`	SąlygaKonkretus tiekėjo maršrutas neprieinamas.	Kitas žingsnisIšsaugokite atsakymą maršrutui pataisyti.
Atsakymas503 · `result_pending_check`	SąlygaPradinį rezultatą reikia patikrinti; X-Should-Retry:false.	Kitas žingsnisIšsaugokite pradinę operation_id/id reikšmę ir tikrinkite operacijos būseną; niekada nekartokite pradinės POST užklausos.
Atsakymas404 · `not_found`	SąlygaPaketinio apdorojimo būsenos operacijos nėra arba ji susieta su kita tapatybe.	Kitas žingsnisNaudokite tikslią pradinę id reikšmę ir tą patį naudotoją, raktą bei grupę.

Pseudonimai

Modelių pseudonimai

Ailoot Ultra mistralai/mistral-medium-3.1:batch

Metodų kelių pseudonimai

Naudokite aukščiau nurodytus metodų kelius.

Susiję ID iškvietimui

mistralai/mistral-medium-3.1:batch

FAQ · Mistral: Mistral Medium 3.1 (batch)

Kokios įvestys ir rezultatai prieinami?: POST /v1/batches · mistralai/mistral-medium-3.1:batch: text → text
Kokius laukus naudoja užklausa?: POST /v1/batches · mistralai/mistral-medium-3.1:batch: endpoint, model, requests, completion_window, provider
Kokie apribojimai taikomi?: POST /v1/batches · mistralai/mistral-medium-3.1:batch: requests.min_items: 1

Mistral: Mistral Medium 3.1 (batch)