OpenAI: o4 Mini (batch)
Az OpenAI o4-mini kompakt következtető modell, amely a hatékony kódolásra és vizuális feladatokra összpontosít. Szöveget és képeket fogad, szöveget ad vissza, valamint strukturált válaszokat és eszközöket támogat egy behatárolt műszaki probléma megoldásához vagy a kapott anyagból hasznos következtetés levonásához.
A modellről
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
Az o4-mini az OpenAI o-sorozatának kompakt következtető modellje, amelyet kódolási és vizuális feladatok gyors, hatékony megoldására optimalizáltak. Szöveget és képeket fogad, és szöveget állít elő. Hasznos szerepe egy meghatározott műszaki probléma kezelése, amely válaszadás előtt elemzést igényel: kódhiba megértése, diagram értelmezése, a kapott anyagban szereplő tények összekapcsolása vagy egy későbbi lépés által felhasználható strukturált eredmény előállítása.
Kódoláshoz adja meg a modellnek a releváns függvényt vagy fájlokat, az elvárt viselkedést, valamint a hibát kiváltó pontos bemenetet vagy hibaüzenetet. Tartalmazza a nyelv és környezet eredményt befolyásoló részleteit. Egy célzott kérés kérheti a valószínű okot, a javasolt minimális javítást és annak magyarázatát, hogyan kezeli a változás a megfigyelt viselkedést. Határozza meg a módosítás határait, például a nyilvános interfész vagy a meglévő adatok jelentésének megőrzését, hogy az eredmény a tényleges feladat alapján ellenőrizhető legyen.
Vizuális problémához adjon olvasható képernyőképet, diagramot vagy grafikont, és nevezze meg a megválaszolandó kérdést. A lényeges címkék, tengelyek és mértékegységek maradjanak láthatók. Például azt kérheti, hogy a modell magyarázza el, mit támaszt alá egy grafikon, nevezze meg a felhasznált megfigyeléseket, és különítse el a látható értéket a következtetéstől. Dokumentumfeladatnál címkézze a forrásanyagot, és határozza meg a válaszban szükséges mezőket vagy kapcsolatokat. A kompakt modellnek is hasznára válik a teljes probléma-információ és a pontos kimeneti kérés.
Az OpenAI 200 000 tokenes kontextusablakot, legfeljebb 100 000 tokenes kimenetet és 2024. június 1-jei tudáshatárt ad meg. A következtetési tokenek a kontextus- és kimeneti kapacitást is fogyasztják, ezért hagyjon helyet az elemzésnek és a végső válasznak, ne töltse ki a teljes keretet bemenettel. A kontextus- vagy kimeneti korlát elérése hiányos választ eredményezhet, mielőtt bármilyen látható válasz megjelenne. A rövid végső válasz is igényelhet belső következtetést; látható hossza önmagában nem írja le a teljes tokenkeretet.
Az o4-mini konkrét modelloldala Chat Completions, Responses, Batch és finomhangolási interfészeket sorol fel. Dokumentált funkciói közé tartozik a folyamatos válaszadás, a Structured Outputs, a függvényhívás, a fájlfeltöltés, a képbemenet, a fájlkeresés, a bemenet gyorsítótárazása és a finomhangolás. Az eszközkészlet webes és fájlkeresést, kódértelmezést és MCP-kapcsolatokat sorol fel. Az alkalmazás eszközének adjon világos célt és bemeneti specifikációt, adja vissza a tényleges eredményt, majd kérje a modellt, hogy ezt használja a következő döntéshez. A kért függvényhívás cselekvési javaslat, míg a strukturált végső válasz a feladat által létrehozott információt rendezi.
Az OpenAI o-sorozathoz adott utasítási útmutatója egyszerű, közvetlen célt javasol, kifejezett megkötésekkel és a forrásanyagot világosan elhatároló jelölésekkel. Hagyja, hogy a modell belsőleg végiggondolja a problémát; a szükséges végső magyarázatot, bizonyítékot vagy számítást kérje, ne a rejtett gondolatmenet átiratát. Először világos feladatleírással próbálkozzon, majd akkor adjon példákat, ha egy előírt formátum vagy kategóriahatár még nem egyértelmű. A példa ugyanazokat a szabályokat mutassa be, mint a valós feladat, beleértve a hiányzó információ megjelenítését is.
Azokhoz az alkalmazásokhoz, amelyek a következtetési folyamat opcionális magyarázatát igénylik, az OpenAI következtetési útmutatója kifejezetten dokumentál részletes következtetési összefoglalókat az o4-mini számára. Az összefoglalót kérni kell, és különbözik a nyers belső következtetési tokenektől, amelyek nem hozzáférhetők. A végső válasznak továbbra is tartalmaznia kell a felhasználó által kért eredményt: például javasolt kódmódosítást, grafikonértelmezést a releváns megfigyelésekkel vagy a kapott anyaghoz kötött kinyert mezőket. Adjon meg friss tényeket, amikor számítanak, a fontos állításokat ellenőrizze a forrásuk alapján, és behatárolt feladattal, illetve befejezési kritériummal tartsa célirányosan a munkafolyamatot.
Ailoot Ultra · Kötegelt feldolgozás POST /v1/batches openai/o4-mini:batch
openai/o4-mini:batchKezdő lépések
Az OpenAI o4-mini kompakt következtető modell, amely a hatékony kódolásra és vizuális feladatokra összpontosít. Szöveget és képeket fogad, szöveget ad vissza, valamint strukturált válaszokat és eszközöket támogat egy behatárolt műszaki probléma megoldásához vagy a kapott anyagból hasznos következtetés levonásához.
- Elfogadott bemenetek
- Szöveg
- Eredmények
- Szöveg
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Kötegelt feldolgozás POST /v1/batches
- Bemenet
text- Kimenet
text- Kimeneti formátum
- Beágyazott results[].response.body JSON-adatok
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőendpoint | Típusstring | KövetelményKötelező | Értékek és korlátok /v1/chat/completions | Alapértelmezett— |
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok openai/o4-mini:batch | Alapértelmezett— |
Mezőrequests | Típusbatch_item[] | KövetelményKötelező | Értékek és korlátok Minimális elemszám: 1 | Alapértelmezett— |
Mezőrequests[].custom_id | Típusstring | KövetelményKötelező | Értékek és korlátok | Alapértelmezett— |
Mezőrequests[].body.messages | Típusmessage[] | KövetelményKötelező | Értékek és korlátok | Alapértelmezett— |
Mezőcompletion_window | Típusstring | KövetelményOpcionális | Értékek és korlátok 24h | Alapértelmezett— |
Mezőprovider | Típusobject|null | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőrequests[].body.model | Típusstring | KövetelményOpcionális | Értékek és korlátok openai/o4-mini:batch, openai/o4-mini | Alapértelmezett— |
Mezőprovider.only | Típusstring[] | KövetelményOpcionális | Értékek és korlátok openai | Alapértelmezett— |
Mezőprovider.allow_fallbacks | Típusboolean|null | KövetelményOpcionális | Értékek és korlátok false, null | Alapértelmezett— |
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésendpoint, model, requests |
Paramétermaterial_types | Szerződéstext |
Paraméterrepresentation | SzerződésA kérésbe ágyazott requests[]; minden elemhez custom_id és body tartozik |
Paraméterrequest_endpoint_profile | Szerződés/v1/chat/completions |
Paraméterfile_material | SzerződésA hívó helyben beolvashatja a tényleges UTF-8 JSONL-adatokat a requests[] tömbbe. A kérés nem használ feltöltési célt, input_file_id mezőt vagy fájlhivatkozást. Hiányzó vagy üres ügyfélanyag esetén az előkészítés még a POST előtt leáll. |
Paraméterserialization_order | Szerződésendpoint, model, provider (ha meg van adva), completion_window (ha meg van adva), requests utoljára |
Paraméteroptional_controls | Szerződésprovider.only, provider.allow_fallbacks, completion_window |
Paraméterschema_scope | SzerződésText Chat Completions-kéréstörzsek a dokumentált, kérésbe ágyazott Batch-borítékban. |
Életciklus: asynchronous
GET /v1/batches/{operation_id} · Az eredeti létrehozási válasz tényleges response.id értéke; ugyanaz a felhasználó/kulcs/csoport
Díjcsomagok
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
- Gyors mód
- Nincs megadva Ha a gyors mód van kiválasztva
- Flex mód
- Nincs megadva Ha a flex mód van kiválasztva
- Maximális gondolkodási ráfordítás
- Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik
- Explicit gyorsítótárazás díjai
- Nincs engedélyezve Ha explicit gyorsítótárazást kérnek
Ailoot-díjak
Árak beállításonként
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Kontextustokenek, több mint | Kontextustokenek, legfeljebb | Díj |
|---|---|---|---|---|
| BeállításTokenenkénti alapárak | DíjtáblázatAlapdíj | Kontextustokenek, több mint— | Kontextustokenek, legfeljebbNincs felső korlát | Díj Bemenet · Bemeneti tokenek $0.0011 / 1K token Kimenet · Kimeneti tokenek $0.0044 / 1K token Bemenet · Gyorsítótár olvasása $0.000275 / 1K token Bemenet · Írás a gyorsítótárba — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra — / 1K token |
| BeállításA kéréshossz szerinti 1. ársáv | Díjtáblázat— | Kontextustokenek, több mint0 | Kontextustokenek, legfeljebbNincs felső korlát | Díj Bemenet · Bemeneti tokenek $0.0011 / 1K token Kimenet · Kimeneti tokenek $0.0044 / 1K token Bemenet · Gyorsítótár olvasása $0.000275 / 1K token Bemenet · Írás a gyorsítótárba — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra — / 1K token |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
Példakérések
Ailoot Ultra · Kötegelt feldolgozás
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":"openai/o4-mini: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 ['openai/o4-mini:batch', 'openai/o4-mini']: raise ValueError("body.model must be an exact documented caller or wire ID")
return {"endpoint":"/v1/chat/completions", "model":"openai/o4-mini: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.
Eredmények fogadása és mentése
Ailoot Ultra · Kötegelt feldolgozás
Beágyazott results[].response.body JSON-adatok
GET /v1/batches/{operation_id}
Feladatállapot ellenőrzése
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
Őrizzen meg minden elkészült eredményt
Őrizzen meg minden teljes visszaadott választ, fájlt és tartalomrészt.
Őrizze meg a teljes eredeti állapot-JSON-t, minden eredményt/custom_id értéket, valamint a teljes válasz- vagy hibatörzset. A befejezett results[] elemeket szűrés nélkül mentse JSONL-ként.
Ha az eredeti választ ellenőrizni kell
Őrizze meg az eredeti műveletazonosítót. A 503 result_pending_check válasz X-Should-Retry:false fejlécet tartalmaz; soha ne küldje be újra az ismeretlen kimenetelű eredeti köteget.
Válaszmezők
| Mező | Típus |
|---|---|
Mezőresults[].custom_id | Típusstring |
Mezőresults[].response.body.choices[].message.content | Típusstring|null |
Mezőresults[].error | Típusobject|null |
Mezőusage | Típusobject|null |
Mezőid | Típusstring |
Mezőmodel | Típusstring |
Mezőendpoint | Típusstring |
Mezőstatus | Típusstring |
Mezőrequest_counts | Típusobject |
Mezőresults[].id | Típusstring |
Mezőresults[].response.status_code | Típusinteger |
Mezőresults[].response.request_id | Típusstring |
Hibák és következő lépések
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételÉrvénytelen a dokumentált, kérésbe ágyazott boríték, ismétlődő kulcsok vagy az elemek azonosságával kapcsolatos hiba található benne, vagy ütközés van a beállított modellképességekkel. | Következő lépésBármilyen új beküldés előtt javítsa ki a megjelölt mezőket. |
Válasz401 · authentication_error | FeltételÉrvénytelen API-kulcs. | Következő lépésHasználja az engedélyezett Ailoot-kulcsot. |
Válasz403 · permission_error | FeltételA Batch-csoport nem érhető el. | Következő lépésEllenőrizze a kulcs/csoport jogosultságát. |
Válasz422 · invalid_request_error | FeltételA Batch az egyenlegből számol el; az előfizetés terhére indított létrehozási kérés elutasításra kerül. | Következő lépésHasználja az engedélyezett, egyenlegből elszámoló csoportot. |
Válasz422 · price_unavailable | FeltételA Batch-bemenethez nem készíthető árajánlat. | Következő lépésŐrizze meg a választ; használja az API-család dokumentált bemenetét. |
Válasz402 · billing_error | FeltételA Batch költségfedezeti foglalása nem érhető el. | Következő lépésAz új kérés előtt rendezze a befogadási feltételeket. |
Válasz503 · price_unavailable | FeltételA Batch-módszer ára vagy natív díjtételei nem érhetők el. | Következő lépésŐrizze meg a választ; ne helyettesítse az árakat más árakkal. |
Válasz503 · api_error | FeltételA pontos szolgáltatói útvonal nem érhető el. | Következő lépésŐrizze meg a választ az útvonal javításához. |
Válasz503 · result_pending_check | FeltételAz eredeti eredmény ellenőrzést igényel; X-Should-Retry:false. | Következő lépésŐrizze meg az eredeti operation_id/id értéket, és kérdezze le az állapotát; soha ne ismételje meg az eredeti POST kérést. |
Válasz404 · not_found | FeltételA Batch állapotlekérdezési művelete nem létezik, vagy más identitáshoz tartozik. | Következő lépésHasználja az eredeti id pontos értékét és ugyanazt a felhasználót/kulcsot/csoportot. |
Álnevek
Modell álnevei
Ailoot Ultra openai/o4-mini:batch
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · OpenAI: o4 Mini (batch)
- Milyen bemenetek és eredmények érhetők el?
POST /v1/batches·openai/o4-mini:batch:text→text- Mely mezőket használja a kérés?
POST /v1/batches·openai/o4-mini:batch:endpoint,model,requests,completion_window,provider- Milyen korlátok érvényesek?
POST /v1/batches·openai/o4-mini:batch:requests.min_items:1