Mistral: Ministral 3 8B 2512 (batch)
Ministral 3 8B Instruct 2512 je viacjazyčný model na plnenie pokynov s textovým a obrazovým vstupom, jazykovou zložkou s 8,4 miliardy parametrov a vizuálnym enkodérom s 0,4 miliardy parametrov. Podporuje kontext 256k uvádzaný výrobcom, systémové pokyny, JSON a natívne volanie funkcií pre asistentov a dokumentové postupy.
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.
Ministral 3 8B Instruct 2512 je stredne veľký model rodiny Ministral 3 od Mistral AI doladený na plnenie pokynov. Vydaný kontrolný bod je dotrénovaný na chat a úlohy s pokynmi v presnosti FP8. Spája jazykovú zložku s vizuálnym enkodérom, prijíma text a obrázky a vracia text namiesto obrazového alebo zvukového artefaktu.
Architektúra a hlavné funkcie
Výrobca uvádza jazykový model s 8,4 miliardy parametrov a vizuálny enkodér s 0,4 miliardy parametrov. Jeho kontextové okno je opísané ako 256k a zverejnené poznámky k používaniu používajú predvolenú nastavenú dĺžku 262 144. Tieto údaje opisujú túto edíciu veľkosti 8B; menší člen rodiny 3B a väčší 14B si zachovávajú vlastné veľkosti zložiek a konfigurácie.
Vizuálne schopnosti rozširujú vstup modelu za rámec písomnej konverzácie. Obrázok dokumentu možno spojiť s otázkou o vybranom poli, odseku alebo viditeľnom vzťahu. Snímku obrazovky možno spojiť s cieľom používateľa a požiadavkou na identifikáciu relevantného ovládacieho prvku. Ak odpoveď závisí od vizuálneho detailu, žiadajte pozorovanie podporujúce každý záver a zachovajte nadpisy, označenia a jednotky potrebné na interpretáciu výrezu.
Karta opisuje viacjazyčnú prácu v desiatkach jazykov vrátane angličtiny, francúzštiny, španielčiny, nemčiny, taliančiny, portugalčiny, holandčiny, čínštiny, japončiny, kórejčiny a arabčiny. Identifikuje aj dodržiavanie systémových pokynov, natívne volanie funkcií a výstup JSON. Cieľový jazyk, rolu a požiadavky na výstup definujte výslovne namiesto ponechania modelu, aby zamýšľaný artefakt odhadoval z rozsiahleho vstupu.
Dokumentové, konverzačné a agentové úlohy
Spôsoby použitia výrobcu zahŕňajú chatové rozhrania, každodenných asistentov, opisy obrázkov a dokumentov, preklady, generovanie obsahu a špecializovaných agentov. Pre dokumentového asistenta dodajte stránku a určite informácie, ktoré má vrátiť. Extrakčná požiadavka môže pomenovať označenia polí, očakávané typy a spracovanie chýbajúcich hodnôt. Užitočná odpoveď môže obsahovať identifikátor dokumentu, extrahovanú hodnotu a krátke vysvetlenie naviazané na viditeľný zdroj.
Pri prebiehajúcej konverzácii zachovajte relevantnú predchádzajúcu odpoveď a položte cielenú nadväzujúcu otázku. Používateľ môže najprv žiadať súhrn dokumentu a potom sa opýtať, ktoré tvrdenie podporuje jeden záver. Požadovaný výstup sa tým zmení zo všeobecného prehľadu na vysvetlenie prepojené so zdrojom pri zachovaní pôvodného materiálu a účelu dialógu.
Pri viacjazyčných úpravách dodajte pôvodnú pasáž, zamýšľaného čitateľa a zoznam terminológie. Žiadajte upravenú verziu zachovávajúcu názvy, podmienky a jednotky, po ktorej podľa potreby nasleduje krátke vysvetlenie zmien. Pri generovaní obsahu určite publikum a fakty, ktoré sa majú objaviť, skôr než požiadate o krátky návrh alebo alternatívne znenie.
Pri agentovej úlohe poskytuje nástroje a ich parametre aplikácia. Model môže vybrať funkciu a pripraviť argumenty, zatiaľ čo aplikácia ju vykoná a vráti výsledok. Príklad funkcie na karte spája otázku k obrázku s výpočtovým nástrojom. Výsledok nástroja zachovajte oddelene od navrhovaného volania, aby nasledujúca písomná odpoveď používala informácie, ktoré operácia skutočne vrátila.
Odporúčaná príprava a nastavenia
Výrobca odporúča systémový pokyn opisujúci prostredie, spôsob použitia a spôsob používania nástrojov. Sadu nástrojov udržiavajte jasne definovanú a obmedzenú na minimum potrebné pre úlohu. Malý vyhľadávací postup môže ponúkať funkcie relevantné pre aktuálnu otázku s jasne pomenovanými povinnými argumentmi namiesto veľkej zbierky nesúvisiacich operácií.
Pri každodennom a produkčnom použití karta odporúča teplotu pod 0.1, pričom vyššie teploty sú dostupné na tvorivé skúmanie. Berte to ako odporúčanie pre postup plnenia pokynov, nie ako samostatné riadenie režimu uvažovania. Rodina má odlišné kontrolné body Base, Instruct a Reasoning; táto položka je edícia Instruct 2512, nie samostatné vydanie Reasoning rovnakej veľkosti.
Pri obrázkoch výrobca odporúča pomery strán blízke 1:1 a vyhýbanie sa veľmi úzkym alebo širokým vstupom. Podľa potreby orežte obrázok pri zachovaní označení a kontextu potrebných pre otázku. Ak stránka obsahuje viacero nesúvisiacich oblastí, označte časť na preskúmanie a výsledok, ktorý treba vrátiť. Čitateľný, cielený obrázok je užitočnejší než žiadosť, aby model odhadoval, ktorý malý detail na rozsiahlej stránke je dôležitý.
Hranice kontextu a edície
Text, obrázky, konverzáciu a požadovanú odpoveď plánujte podľa nastaveného kontextu. Poznámky k používaniu výslovne umožňujú znížiť nastavenú dĺžku modelu, ak je potrebný menší kontext, takže celé okno nie je pokynom na naplnenie každej požiadavky všetkými dostupnými materiálmi. Príklad generovania s 512 tokenmi na karte je iba ukážkovým nastavením a prečítané zdroje nestanovujú samostatnú pevnú maximálnu dĺžku odpovede.
Kontrolný bod FP8 Instruct, predtrénované vydanie Base a vydanie Reasoning sú samostatné edície. Výrobca opisuje ako použitia aj špecializáciu a dolaďovanie. Pri príprave konverzácie zachovajte pomenovaný kontrolný bod a jeho tokenizér a odlíšte generovanie textu od prístupu k repozitáru, vykonávania funkcií alebo iných akcií poskytovaných okolitou aplikáciou.
Ailoot Ultra · Dávkové spracovanie POST /v1/batches mistralai/ministral-8b-2512:batch
mistralai/ministral-8b-2512:batch
mistralai/ministral-8b-2512:batchÚvod
Ministral 3 8B Instruct 2512 je viacjazyčný model na plnenie pokynov s textovým a obrazovým vstupom, jazykovou zložkou s 8,4 miliardy parametrov a vizuálnym enkodérom s 0,4 miliardy parametrov. Podporuje kontext 256k uvádzaný výrobcom, systémové pokyny, JSON a natívne volanie funkcií pre asistentov a dokumentové postupy.
- 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é |
|---|---|---|---|---|
Poleendpoint | Typstring | PožiadavkaPovinné | Hodnoty a limity /v1/chat/completions | Predvolené— |
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity mistralai/ministral-8b-2512:batch | Predvolené— |
Polerequests | Typbatch_item[] | PožiadavkaPovinné | Hodnoty a limity Minimálny počet položiek: 1 | Predvolené— |
Polerequests[].custom_id | Typstring | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polerequests[].body.messages | Typmessage[] | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polecompletion_window | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 24h | Predvolené— |
Poleprovider | Typobject|null | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polerequests[].body.model | Typstring | PožiadavkaVoliteľné | Hodnoty a limity mistralai/ministral-8b-2512:batch, mistralai/ministral-8b-2512 | Predvolené— |
Poleprovider.only | Typstring[] | PožiadavkaVoliteľné | Hodnoty a limity mistral | Predvolené— |
Poleprovider.allow_fallbacks | Typboolean|null | PožiadavkaVoliteľné | Hodnoty a limity false, null | Predvolené— |
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciaendpoint, model, requests |
Parametermaterial_types | Špecifikáciatext |
Parameterrepresentation | Špecifikáciapriamo vložené requests[]; každá položka obsahuje custom_id a body |
Parameterrequest_endpoint_profile | Špecifikácia/v1/chat/completions |
Parameterfile_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. |
Parameterserialization_order | Špecifikáciaendpoint, model, provider (ak je zadaný), completion_window (ak je zadaný), requests na konci |
Parameteroptional_controls | Špecifikáciaprovider.only, provider.allow_fallbacks, completion_window |
Parameterschema_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.00015 / 1K tokenov Výstup · Výstupné tokeny $0.00015 / 1K tokenov Vstup · Čítanie cache $0.000015 / 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.00015 / 1K tokenov Výstup · Výstupné tokeny $0.00015 / 1K tokenov Vstup · Čítanie cache $0.000015 / 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
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/ministral-8b-2512: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/ministral-8b-2512:batch', 'mistralai/ministral-8b-2512']: raise ValueError("body.model must be an exact documented caller or wire ID")
return {"endpoint":"/v1/chat/completions", "model":"mistralai/ministral-8b-2512: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
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 |
|---|---|
Poleresults[].custom_id | Typstring |
Poleresults[].response.body.choices[].message.content | Typstring|null |
Poleresults[].error | Typobject|null |
Poleusage | Typobject|null |
Poleid | Typstring |
Polemodel | Typstring |
Poleendpoint | Typstring |
Polestatus | Typstring |
Polerequest_counts | Typobject |
Poleresults[].id | Typstring |
Poleresults[].response.status_code | Typinteger |
Poleresults[].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/ministral-8b-2512:batch
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · Mistral: Ministral 3 8B 2512 (batch)
- Aké vstupy a výsledky sú dostupné?
POST /v1/batches·mistralai/ministral-8b-2512:batch:text→text- Aké polia používa požiadavka?
POST /v1/batches·mistralai/ministral-8b-2512:batch:endpoint,model,requests,completion_window,provider- Aké limity platia?
POST /v1/batches·mistralai/ministral-8b-2512:batch:requests.min_items:1