Mistral: Ministral 3 8B 2512 (batch)
Ministral 3 8B Instruct 2512 – daugiakalbis teksto ir vaizdų instrukcijų modelis su 8,4 mlrd. parametrų kalbos komponentu ir 0,4 mlrd. parametrų regos koduotuvu. Jis palaiko gamintojo nurodytą 256 tūkst. žetonų kontekstą, sistemines instrukcijas, JSON ir savąjį funkcijų kvietimą asistentų bei dokumentų darbo procesams.
Apie modelį
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Ministral 3 8B Instruct 2512 – vidutinio dydžio pagal instrukcijas suderintas Mistral AI šeimos Ministral 3 modelis. Išleistas kontrolinis taškas papildomai mokytas pokalbio ir instrukcijų užduotims FP8 tikslumu. Jis sujungia kalbos komponentą su regos koduotuvu, priima tekstą bei vaizdus ir grąžina tekstą, o ne vaizdo ar garso artefaktą.
Architektūra ir pagrindinės savybės
Gamintojas nurodo 8,4 mlrd. parametrų kalbos modelį ir 0,4 mlrd. parametrų regos koduotuvą. Jo konteksto langas apibūdinamas kaip 256 tūkst. žetonų, o paskelbtose naudojimo pastabose naudojamas numatytasis sukonfigūruotas ilgis 262 144. Tai aprašo šią 8B dydžio versiją; mažesnis 3B ir didesnis 14B šeimos nariai išlaiko savus komponentų dydžius bei konfigūracijas.
Rega išplečia modelio įvestį už rašytinio pokalbio ribų. Dokumento vaizdą galima susieti su klausimu apie pasirinktą lauką, pastraipą ar matomą ryšį. Ekrano kopiją galima susieti su naudotojo tikslu ir prašymu nustatyti aktualų valdiklį. Kai atsakymas priklauso nuo vaizdinės detalės, prašykite kiekvieną išvadą pagrindžiančio stebėjimo ir išsaugokite iškarpai interpretuoti reikalingas antraštes, žymas bei vienetus.
Kortelėje aprašomas daugiakalbis darbas dešimtimis kalbų, įskaitant anglų, prancūzų, ispanų, vokiečių, italų, portugalų, olandų, kinų, japonų, korėjiečių ir arabų. Taip pat nurodomas sisteminių instrukcijų laikymasis, savasis funkcijų kvietimas ir JSON išvestis. Aiškiai apibrėžkite galutinę kalbą, vaidmenį ir išvesties reikalavimus, užuot palikę modeliui numatyti reikiamą artefaktą iš didelės įvesties.
Dokumentų, pokalbio ir agentų užduotys
Gamintojo naudojimo atvejai apima pokalbių sąsajas, kasdienius asistentus, vaizdų ir dokumentų aprašymą, vertimą, turinio generavimą bei specializuotus agentus. Dokumento asistentui pateikite puslapį ir nurodykite grąžintiną informaciją. Išgavimo užklausa gali įvardyti laukų žymas, laukiamus tipus ir trūkstamų reikšmių tvarkymą. Naudingame atsakyme gali būti dokumento identifikatorius, išgauta reikšmė ir trumpas su matomu šaltiniu susietas paaiškinimas.
Tęstiniam pokalbiui išsaugokite aktualų ankstesnį atsakymą ir užduokite tikslinį papildomą klausimą. Naudotojas pirmiausia gali paprašyti dokumento santraukos, o tada paklausti, kuris teiginys pagrindžia vieną išvadą. Tai keičia reikiamą išvestį iš bendros apžvalgos į su šaltiniu susietą paaiškinimą, išsaugant pradinę medžiagą ir dialogo tikslą.
Daugiakalbiam redagavimui pateikite originalią ištrauką, numatytą skaitytoją ir terminų sąrašą. Prašykite pataisytos versijos, išsaugančios pavadinimus, sąlygas bei vienetus, o po jos – trumpo pakeitimų paaiškinimo, jei naudinga. Turinio generavimui nurodykite auditoriją ir faktus, kurie turi pasirodyti, prieš prašydami trumpo juodraščio ar alternatyvios formuluotės.
Agento užduotyje programa pateikia įrankius ir jų parametrus. Modelis gali parinkti funkciją ir paruošti argumentus, o programa ją vykdo ir grąžina rezultatą. Kortelės funkcijos pavyzdys sujungia klausimą apie vaizdą su skaičiavimo įrankiu. Įrankio rezultatą laikykite atskirai nuo siūlomo kvietimo, kad vėlesnis rašytinis atsakymas naudotų operacijos faktiškai grąžintą informaciją.
Rekomenduojamas paruošimas ir nustatymai
Gamintojas rekomenduoja sisteminę instrukciją, aprašančią aplinką, naudojimo atvejį ir įrankių naudojimą. Įrankių rinkinys turi būti aiškiai apibrėžtas ir apribotas užduočiai būtinu minimumu. Nedidelis paieškos procesas gali pateikti dabartiniam klausimui aktualias funkcijas su aiškiai įvardytais privalomais argumentais, užuot pateikęs didelį nesusijusių operacijų rinkinį.
Kasdieniam ir gamybiniam naudojimui kortelė rekomenduoja mažesnę nei 0.1 temperatūrą, o didesnes temperatūras – kūrybiniam tyrinėjimui. Tai laikykite instrukcijų darbo proceso rekomendacija, o ne atskiru samprotavimo režimo valdikliu. Šeima turi atskirus Base, Instruct ir Reasoning kontrolinius taškus; šis įrašas yra Instruct 2512 versija, o ne atskira tokio pat dydžio Reasoning laida.
Vaizdams gamintojas rekomenduoja proporcijas, artimas 1:1, ir vengti itin siaurų ar plačių įvesčių. Prireikus apkirpkite, išsaugodami klausimui reikalingas žymas ir kontekstą. Jei puslapyje yra kelios nesusijusios sritys, nurodykite nagrinėtiną dalį ir grąžintiną rezultatą. Įskaitomas, tikslingas vaizdas naudingesnis nei prašymas modeliui spėti, kuri maža detalė plačiame puslapyje svarbi.
Konteksto ir versijos ribos
Tekstą, vaizdus, pokalbį ir pageidaujamą atsakymą planuokite pagal sukonfigūruotą kontekstą. Naudojimo pastabose aiškiai leidžiama mažinti sukonfigūruotą modelio ilgį, kai reikia mažiau konteksto, todėl visas langas nėra instrukcija kiekvieną užklausą užpildyti visa prieinama medžiaga. Kortelės 512 žetonų generavimo pavyzdys yra tik pavyzdinis nustatymas, o skaityti šaltiniai nenustato atskiro griežto didžiausio atsakymo ilgio.
FP8 Instruct kontrolinis taškas, iš anksto apmokyta Base laida ir Reasoning laida yra atskiros versijos. Gamintojas taip pat aprašo specializavimą ir papildomą derinimą kaip naudojimo atvejus. Ruošdami pokalbį, išsaugokite įvardytą kontrolinį tašką bei jo žetonizatorių ir atskirkite teksto generavimą nuo prieigos prie repozitorijos, funkcijų vykdymo ar kitų aplinkinės programos teikiamų veiksmų.
Ailoot Ultra · Paketinis apdorojimas POST /v1/batches mistralai/ministral-8b-2512:batch
mistralai/ministral-8b-2512:batch
mistralai/ministral-8b-2512:batchPradžia
Ministral 3 8B Instruct 2512 – daugiakalbis teksto ir vaizdų instrukcijų modelis su 8,4 mlrd. parametrų kalbos komponentu ir 0,4 mlrd. parametrų regos koduotuvu. Jis palaiko gamintojo nurodytą 256 tūkst. žetonų kontekstą, sistemines instrukcijas, JSON ir savąjį funkcijų kvietimą asistentų bei dokumentų darbo procesams.
- 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 |
|---|---|---|---|---|
Laukasendpoint | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos /v1/chat/completions | Numatyta— |
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos mistralai/ministral-8b-2512:batch | Numatyta— |
Laukasrequests | Tipasbatch_item[] | ReikalavimasPrivaloma | Reikšmės ir ribos Mažiausias elementų skaičius: 1 | Numatyta— |
Laukasrequests[].custom_id | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos | Numatyta— |
Laukasrequests[].body.messages | Tipasmessage[] | ReikalavimasPrivaloma | Reikšmės ir ribos | Numatyta— |
Laukascompletion_window | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 24h | Numatyta— |
Laukasprovider | Tipasobject|null | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasrequests[].body.model | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos mistralai/ministral-8b-2512:batch, mistralai/ministral-8b-2512 | Numatyta— |
Laukasprovider.only | Tipasstring[] | ReikalavimasNeprivaloma | Reikšmės ir ribos mistral | Numatyta— |
Laukasprovider.allow_fallbacks | Tipasboolean|null | ReikalavimasNeprivaloma | Reikšmės ir ribos false, null | Numatyta— |
Metodo parametrai ir gyvavimo ciklas
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijaendpoint, model, requests |
Parametrasmaterial_types | Specifikacijatext |
Parametrasrepresentation | Specifikacijatiesiogiai įterptas requests[] masyvas; kiekvienas elementas turi custom_id ir body laukus |
Parametrasrequest_endpoint_profile | Specifikacija/v1/chat/completions |
Parametrasfile_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. |
Parametrasserialization_order | Specifikacijaendpoint, model, provider (jei pateiktas), completion_window (jei pateiktas), requests pateikite paskiausiai |
Parametrasoptional_controls | Specifikacijaprovider.only, provider.allow_fallbacks, completion_window |
Parametrasschema_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.00015 / 1K tokenų Išvestis · Išvesties tokenai $0.00015 / 1K tokenų Įvestis · Talpyklos skaitymas $0.000015 / 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.00015 / 1K tokenų Išvestis · Išvesties tokenai $0.00015 / 1K tokenų Įvestis · Talpyklos skaitymas $0.000015 / 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
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.
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ą
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 |
|---|---|
Laukasresults[].custom_id | Tipasstring |
Laukasresults[].response.body.choices[].message.content | Tipasstring|null |
Laukasresults[].error | Tipasobject|null |
Laukasusage | Tipasobject|null |
Laukasid | Tipasstring |
Laukasmodel | Tipasstring |
Laukasendpoint | Tipasstring |
Laukasstatus | Tipasstring |
Laukasrequest_counts | Tipasobject |
Laukasresults[].id | Tipasstring |
Laukasresults[].response.status_code | Tipasinteger |
Laukasresults[].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/ministral-8b-2512:batch
Metodų kelių pseudonimai
Naudokite aukščiau nurodytus metodų kelius.
Susiję ID iškvietimui
FAQ · Mistral: Ministral 3 8B 2512 (batch)
- Kokios įvestys ir rezultatai prieinami?
POST /v1/batches·mistralai/ministral-8b-2512:batch:text→text- Kokius laukus naudoja užklausa?
POST /v1/batches·mistralai/ministral-8b-2512:batch:endpoint,model,requests,completion_window,provider- Kokie apribojimai taikomi?
POST /v1/batches·mistralai/ministral-8b-2512:batch:requests.min_items:1