Mistral: Mistral Medium 3.1 (batch)

Mistral Medium 3.1 je model na prácu s textom a obrázkami určený na konverzačné odpovede, otázky k dokumentom a štruktúrovanú extrakciu. Kontext 128k uvádzaný výrobcom a uvedené funkcie volania funkcií, predikovaného výstupu a prefixov podporujú vysvetlenia založené na zdrojoch a cielené postupy úprav.

Ailoot Ultra · Dávkové spracovanie POST /v1/batches mistralai/mistral-medium-3.1:batch

O modeli

Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.

Mistral Medium 3.1 je multimodálna edícia Mistral AI na porozumenie textu a vizuálnym materiálom. Výrobca opisuje túto revíziu ako zlepšenie tónu a výkonu v rámci radu Medium 3. Prijíma text a obrázky a vytvára text: vysvetlenie, odpoveď k dokumentu, štruktúrovaný záznam alebo navrhované volanie funkcie. Pevný identifikátor výrobcu pre túto edíciu je mistral-medium-2508.

Kontext a konkrétna edícia

Stránka modelu dokumentuje kontextové okno 128k. Používajte ho na spoločné zachovanie súvisiacich zdrojových pasáží, obrazových dôkazov, konverzácie a úlohy používateľa. Pred dodaním veľkej zbierky určite úlohy dokumentov a otázku, na ktorú treba odpovedať. Dlhý kontext môže podporiť cielené porovnanie, pričom konečným artefaktom zostane krátka tabuľka alebo upravená časť.

Medium 3.1 si zachováva vlastnú špecifikáciu. Kontext 256k, hustú architektúru 128B a konfigurovateľné režimy hybridného uvažovania opísané pre Medium 3.5 nemožno pripisovať tejto položke. Stránka 3.1 neposkytuje počet parametrov ani samostatný údaj o maximálnej dĺžke odpovede, ktorý by bolo možné bezpečne nahradiť hodnotou z neskoršieho modelu.

Štruktúrovaný výstup a funkcie

Výrobca medzi funkciami tejto edície uvádza štruktúrované výstupy, volanie funkcií a predikované výstupy. Pri úlohe štruktúrovanej extrakcie definujte povinné polia, očakávané typy a spracovanie informácií chýbajúcich v zdroji. Záznam môže obsahovať identifikátor dokumentu, extrahované tvrdenie, jeho zdrojové umiestnenie a zostávajúcu otázku. Žiadajte samotný záznam, keď ho bude spracúvať program, alebo držte vysvetľujúci text oddelene, keď musí niekto preskúmať interpretáciu.

Spoločná dokumentácia Mistral k štruktúrovanému výstupu odlišuje režim JSON od vlastnej schémy. Režim JSON vyžaduje výslovný pokyn o požadovanom formáte JSON, zatiaľ čo vlastná cesta definuje konkrétnejšiu štruktúru. Ide o formátovanie textového výsledku, nie novú modalitu obsahu alebo externú akciu.

Pri funkciách aplikácia definuje dostupnú operáciu a argumenty, model vyberie vhodné volanie a pripraví hodnoty a aplikácia ho vykoná. Jeho výsledok sa potom stane informáciou pre ďalšiu odpoveď. Dokumentový asistent môže vyhľadaním získať chýbajúce referenčné údaje, ale iba ak okolitá aplikácia toto vyhľadávanie poskytuje a vráti jeho skutočný výsledok. Navrhované volanie a vrátené údaje zachovajte vzájomne prepojené.

Predikované úpravy a prefixy odpovedí

Predikované výstupy sú užitočné, keď je väčšina požadovaného výsledku už známa, napríklad dokument alebo súbor kódu potrebuje obmedzenú úpravu. Poskytnite existujúci obsah a presne opíšte zmenu vrátane toho, čo musí zostať nezmenené. Požiadavka môže aktualizovať terminológiu jednej časti alebo nahradiť jeden implementačný detail pri zachovaní zvyšku dokumentu. Predikcia obsahuje očakávaný výstupný obsah, nie dokončenú zmenu použitú na súbor.

Stránka modelu uvádza aj pokračovanie prefixu odpovede. V chatovej dokumentácii výrobcu prefix poskytuje známy začiatok odpovede asistenta, po ktorom pokračuje generovanie. Známy začiatok a predikované telo riešia odlišné problémy prípravy. Dávkovanie a rozhrania agenta či konverzácie sú rovnako funkciami postupu, nie samostatnými obrazovými, zvukovými alebo uvažovacími edíciami Medium 3.1.

Otázky k dokumentom a vizuálnym materiálom

Uvedený postup document-QnA spája text, štruktúru a formátovanie pripravené pomocou OCR s analýzou jazykovým modelom. Pýtajte sa na konkrétnu podmienku, pasáž alebo vzťah požadovaný úlohou. Porovnanie môže identifikovať zdrojové dokumenty a žiadať spoločné tvrdenia, konflikty a nevyriešené podrobnosti so zachovaním zdrojového umiestnenia pri každom zistení.

Vizuálna príručka výrobcu výslovne zahŕňa Medium 3.1. Priama vizuálna otázka môže dodať čitateľný graf, obrázok dokumentu alebo snímku obrazovky a pýtať sa, aké viditeľné dôkazy podporujú záver. Zachovajte osi, jednotky, označenia a kontext okolo orezaného poľa. Ak dodávate viacero obrázkov, určite ich poradie a úlohu namiesto ponechania modelu, aby odhadoval, ktorý je originál, revízia alebo referencia.

Napríklad spojte písomnú procesnú požiadavku so snímkou obrazovky a žiadajte tabuľku viditeľných zhôd, rozdielov a otázok vyžadujúcich ďalšie informácie. Iná úloha môže dodať dve verzie dokumentu a žiadať upravenú pasáž, ktorá zachová ich spoločné podmienky a vyrieši pomenovaný nesúlad. Ide o navrhované použitia zdokumentovaných vizuálnych, dokumentových a editačných schopností s vopred definovaným požadovaným výsledkom.

Príprava konečného artefaktu

Dajte asistentovi jasnú rolu, zdrojový materiál na použitie a podobu odpovede. Trvalé pravidlá odpovede odlíšte od skúmaného dokumentu a uveďte cieľový jazyk a terminológiu. Užitočná odpoveď môže oddeliť extrahovaný fakt, jeho zdroj a interpretáciu, vďaka čomu sa ľahšie preskúma než jeden zlúčený súhrn.

Zdokumentovaný výsledok zostáva textový. Externé nástroje, zmeny súborov a ďalšie spracovanie dokumentov patria aplikácii pripojenej ku konverzácii. Zachovajte pomenovanú edíciu Medium 3.1 a jej kontext 128k a žiadajte vysvetlenie, štruktúrovaný záznam alebo cielenú revíziu, ktoré ďalší krok skutočne potrebuje.

Ailoot Ultra · Dávkové spracovanie POST /v1/batches mistralai/mistral-medium-3.1:batch

mistralai/mistral-medium-3.1:batch

Mistral /mistralai/mistral-medium-3.1:batch

Úvod

Povolené vstupy: Text
Výsledky: Text

Dostupné v Ailoot · vstupy a metódy

Ailoot Ultra · Dávkové spracovanie POST /v1/batches

Vstup: text
Výstup: text
Výstupný formát: JSON priamo vložený v results[].response.body

Pole	Typ	Požiadavka	Hodnoty a limity	Predvolené
Pole`endpoint`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity /v1/chat/completions	Predvolené—
Pole`model`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity mistralai/mistral-medium-3.1:batch	Predvolené—
Pole`requests`	Typ`batch_item[]`	PožiadavkaPovinné	Hodnoty a limity Minimálny počet položiek: 1	Predvolené—
Pole`requests[].custom_id`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity	Predvolené—
Pole`requests[].body.messages`	Typ`message[]`	PožiadavkaPovinné	Hodnoty a limity	Predvolené—
Pole`completion_window`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity 24h	Predvolené—
Pole`provider`	Typ`object\|null`	PožiadavkaVoliteľné	Hodnoty a limity	Predvolené—
Pole`requests[].body.model`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity mistralai/mistral-medium-3.1:batch, mistralai/mistral-medium-3.1	Predvolené—
Pole`provider.only`	Typ`string[]`	PožiadavkaVoliteľné	Hodnoty a limity mistral	Predvolené—
Pole`provider.allow_fallbacks`	Typ`boolean\|null`	PožiadavkaVoliteľné	Hodnoty a limity false, null	Predvolené—

Parametre a životný cyklus metódy

Parameter	Špecifikácia
Parameter`content_type`	Špecifikáciaapplication/json
Parameter`required`	Špecifikáciaendpoint, model, requests
Parameter`material_types`	Špecifikáciatext
Parameter`representation`	Špecifikáciapriamo vložené requests[]; každá položka obsahuje custom_id a body
Parameter`request_endpoint_profile`	Špecifikácia/v1/chat/completions
Parameter`file_material`	ŠpecifikáciaVolajúci môže lokálne načítať skutočný súbor UTF-8 JSONL do requests[]. Nepoužíva sa účel nahrávania, input_file_id ani odkaz na súbor. Chýbajúce alebo prázdne podklady zákazníka zastavia prípravu pred POST.
Parameter`serialization_order`	Špecifikáciaendpoint, model, provider (ak je zadaný), completion_window (ak je zadaný), requests na konci
Parameter`optional_controls`	Špecifikáciaprovider.only, provider.allow_fallbacks, completion_window
Parameter`schema_scope`	ŠpecifikáciaTelá textových požiadaviek Chat Completions v zdokumentovanom obale dávky s priamo vloženými požiadavkami.

Životný cyklus: asynchronous

GET /v1/batches/{operation_id} · skutočná hodnota response.id z pôvodnej odpovede na vytvorenie; rovnaký používateľ/kľúč/skupina

Cenník

Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.

Rýchly režim: Neuvedené Keď je zvolený rýchly režim
Režim Flex: Neuvedené Keď je zvolený režim flex
Maximálna úroveň uvažovania: Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Ceny explicitnej cache: Nie je zapnuté Keď sa požaduje explicitná cache

Sadzby Ailoot

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

Konfigurácia	Sadzobník	Počet tokenov kontextu väčší než	Tokeny kontextu, najviac (vrátane hranice)	Poplatok
KonfiguráciaZákladné sadzby za tokeny	SadzobníkZákladná sadzba	Počet tokenov kontextu väčší než—	Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranice	Poplatok Vstup · Vstupné tokeny $0.0004 / 1K tokenov Výstup · Výstupné tokeny $0.002 / 1K tokenov Vstup · Čítanie cache $0.00004 / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov
KonfiguráciaPásmo dĺžky požiadavky 1	Sadzobník—	Počet tokenov kontextu väčší než0	Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranice	Poplatok Vstup · Vstupné tokeny $0.0004 / 1K tokenov Výstup · Výstupné tokeny $0.002 / 1K tokenov Vstup · Čítanie cache $0.00004 / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov

Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →

Príklady požiadaviek

Ailoot Ultra · Dávkové spracovanie

curl · uložená vzorová požiadavkaPython HTTP · skutočné údaje zákazníka vo formáte JSONLPython · uložte každý hotový výsledok

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.

Prijať a uložiť výsledky

Ailoot Ultra · Dávkové spracovanie

JSON priamo vložený v results[].response.body

GET /v1/batches/{operation_id}

Skontrolovať stav úlohy

curl · stav pôvodnej operácie

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

Uchovať všetky dokončené výsledky

Uložte každú úplnú vrátenú odpoveď, súbor a časť obsahu.

Uchovajte úplný pôvodný stav vo formáte JSON, každý výsledok/custom_id a úplné telo odpovede alebo chyby. Dokončené results[] uložte ako JSONL bez filtrovania.

Ak treba overiť pôvodnú odpoveď

Uchovajte pôvodné ID operácie. Odpoveď 503 result_pending_check obsahuje X-Should-Retry:false; pôvodnú dávku s neznámym výsledkom nikdy znova neodosielajte.

Polia odpovede

Pole	Typ
Pole`results[].custom_id`	Typstring
Pole`results[].response.body.choices[].message.content`	Typstring\|null
Pole`results[].error`	Typobject\|null
Pole`usage`	Typobject\|null
Pole`id`	Typstring
Pole`model`	Typstring
Pole`endpoint`	Typstring
Pole`status`	Typstring
Pole`request_counts`	Typobject
Pole`results[].id`	Typstring
Pole`results[].response.status_code`	Typinteger
Pole`results[].response.request_id`	Typstring

Chyby a ďalšie kroky

Odpoveď	Podmienka	Ďalší krok
Odpoveď400 · `invalid_request_error`	PodmienkaNeplatný zdokumentovaný obal s priamo vloženými požiadavkami, duplicitné kľúče alebo konflikt identity položky či nastavených schopností modelu.	Ďalší krokPred akýmkoľvek novým odoslaním opravte označené polia.
Odpoveď401 · `authentication_error`	PodmienkaNeplatný kľúč API.	Ďalší krokPoužite kľúč Ailoot, ktorý ste oprávnení používať.
Odpoveď403 · `permission_error`	PodmienkaSkupina pre dávkové spracovanie nie je dostupná.	Ďalší krokSkontrolujte oprávnenie kľúča/skupiny.
Odpoveď422 · `invalid_request_error`	PodmienkaDávkové spracovanie sa účtuje zo zostatku; vytvorenie cez predplatné sa odmieta.	Ďalší krokPoužite skupinu s účtovaním zo zostatku, ktorú ste oprávnení používať.
Odpoveď422 · `price_unavailable`	PodmienkaPre vstup dávky nemožno vypočítať cenovú ponuku.	Ďalší krokUchovajte odpoveď; použite zdokumentovaný vstup pre danú rodinu metód.
Odpoveď402 · `billing_error`	PodmienkaRezerva pre dávkové spracovanie nie je dostupná.	Ďalší krokPred novou požiadavkou vyriešte podmienky prijatia.
Odpoveď503 · `price_unavailable`	PodmienkaCena metódy dávkového spracovania alebo natívne sadzby nie sú dostupné.	Ďalší krokUchovajte odpoveď; nenahrádzajte ceny inými.
Odpoveď503 · `api_error`	PodmienkaPresná trasa k dodávateľovi nie je dostupná.	Ďalší krokUchovajte odpoveď na účely opravy smerovania.
Odpoveď503 · `result_pending_check`	PodmienkaPôvodný výsledok je potrebné skontrolovať; X-Should-Retry:false.	Ďalší krokUchovajte pôvodné operation_id/id a čítajte jeho stav; pôvodný POST nikdy neopakujte.
Odpoveď404 · `not_found`	PodmienkaOperácia na zisťovanie stavu dávky neexistuje alebo patrí inej identite.	Ďalší krokPoužite presné pôvodné id a rovnakého používateľa/kľúč/skupinu.

Aliasy

Aliasy modelov

Ailoot Ultra mistralai/mistral-medium-3.1:batch

Aliasy ciest metód

Použite cesty metód uvedené vyššie.

Súvisiace ID na volanie

mistralai/mistral-medium-3.1:batch

FAQ · Mistral: Mistral Medium 3.1 (batch)

Aké vstupy a výsledky sú dostupné?: POST /v1/batches · mistralai/mistral-medium-3.1:batch: text → text
Aké polia používa požiadavka?: POST /v1/batches · mistralai/mistral-medium-3.1:batch: endpoint, model, requests, completion_window, provider
Aké limity platia?: POST /v1/batches · mistralai/mistral-medium-3.1:batch: requests.min_items: 1

Mistral: Mistral Medium 3.1 (batch)