OpenAI: Text Embedding 3 Large (batch)
Text Embedding 3 Large Batch odesílá skupiny požadavků na textové embeddingy jako jednu dávku Ailoot. Každou položku sledujte podle custom_id a načtěte úplné výsledky původní operace.
O modelu
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
Text Embedding 3 Large Batch používá /v1/batches s přesným ID modelu openai/text-embedding-3-large:batch. Nastavte pole endpoint na /v1/embeddings a vyplňte requests; každá položka obsahuje custom_id a objekt body s polem input, jehož hodnotou je textový řetězec nebo pole řetězců. Identifikátory udržujte stabilní, aby aplikace mohla přiřadit výsledky k obnově vyhledávacího indexu.
Dávka je asynchronní. Uchovejte původní vrácené ID operace a pomocí GET /v1/batches/{operation_id} sledujte tutéž operaci pod stejnou identitou volajícího. Dokončená sada výsledků může pro každou hodnotu custom_id obsahovat odpověď (response) nebo chybu (error), proto prozkoumejte výsledky jednotlivých položek i celkový stav.
Všechny dokončené výsledky uložte jako JSONL a zachovejte každou hodnotu custom_id i úplný obsah příslušné odpovědi (response) nebo chyby (error). Před aktualizací indexu přiřaďte úspěšně získané vektory k odeslaným ID dokumentů. Původní operaci a záznamy položek uchovávejte společně, aby bylo možné prošetřit neúplnou nebo neúspěšnou položku bez ztráty již vrácených výsledků.
Ailoot Ultra · Batch POST /v1/batches openai/text-embedding-3-large:batch
openai/text-embedding-3-large:batch
openai/text-embedding-3-large:batchÚvod
Text Embedding 3 Large Batch odesílá skupiny požadavků na textové embeddingy jako jednu dávku Ailoot. Každou položku sledujte podle custom_id a načtěte úplné výsledky původní operace.
- Přijímané vstupy
- Text
- Výsledky
- embedding
Dostupné v Ailoot · vstupy a metody
Ailoot Ultra · Batch POST /v1/batches
- Vstup
text- Výstup
embedding
| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity openai/text-embedding-3-large:batch Podmínky: Použijte přesně tento směrovací selektor Ailoot. | Výchozí— |
Poleendpoint | Typstring | PožadavekPovinné | Hodnoty a limity /v1/embeddings Podmínky: | Výchozí— |
Polerequests | Typarray | PožadavekPovinné | Hodnoty a limity Podmínky: | Výchozí— |
Parametry a životní cyklus metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, endpoint, requests |
Parametroptional | Kontrakt |
Parametrmaterial_types | Kontrakttext |
Parametrconditions | KontraktPoužijte přesně tento směrovací selektor Ailoot. |
Životní cyklus: asynchronous
GET /v1/batches/{operation_id} · Skutečné původní response.id, stejný volající, klíč a skupina.
Tarify
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
- Rychlý režim
- Neuvedeno Při výběru rychlého režimu
- Režim flex
- Neuvedeno Při výběru režimu flex
- Maximální intenzita uvažování
- Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)
- Ceny explicitní mezipaměti
- Není zapnuto Při požadavku na explicitní mezipaměť
Sazby Ailoot
Ceny podle konfigurace
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Tabulka sazeb | Tokeny kontextu, více než | Tokeny kontextu, do uvedené hodnoty včetně | Poplatek |
|---|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Tokeny kontextu, více než— | Tokeny kontextu, do uvedené hodnoty včetněBez horní meze | Poplatek Vstup · Vstupní tokeny $0.00013 / 1K tokenů Výstup · Výstupní tokeny $0 / 1K tokenů Vstup · Čtení z mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina — / 1K tokenů |
| KonfiguracePásmo délky požadavku 1 | Tabulka sazeb— | Tokeny kontextu, více než0 | Tokeny kontextu, do uvedené hodnoty včetněBez horní meze | Poplatek Vstup · Vstupní tokeny $0.00013 / 1K tokenů Výstup · Výstupní tokeny $0 / 1K tokenů Vstup · Čtení z mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina — / 1K tokenů |
Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
Příklady požadavků
Ailoot Ultra · Batch
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"endpoint": "/v1/embeddings", "model": "openai/text-embedding-3-large:batch", "requests": [{"custom_id": "embedding-1", "body": {"input": "The quick brown fox jumps over the lazy dog"}}]}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
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 @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_BATCH'
import json,os,subprocess
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path("result.json").read_text()); operation=r["id"]
subprocess.run(["curl","--fail-with-body","--silent","--show-error","https://api.ailoot.ai/v1/batches/"+quote(operation,safe=""),"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
s=json.loads(Path("status.json").read_text())
if s.get("status")=="completed": Path("results.jsonl").write_text("".join(json.dumps(x,ensure_ascii=False)+"\n" for x in s.get("results",[])))
# Repeat only this same original GET while pending; never repeat creation.
PY_BATCH
Přijímání a ukládání výsledků
Ailoot Ultra · Batch
GET /v1/batches/{operation_id}
Uchovejte všechny dokončené výsledky
Uchovejte každou úplnou vrácenou odpověď, soubor i část obsahu.
Zachovejte původní stav, každý custom_id a úplnou odpověď nebo chybu. Uložte všechny dokončené results[] ve formátu JSONL; žádná cesta pro nahrávání či stahování přes Files se nepředpokládá.
Pokud je nutné ověřit původní odpověď
Zachovejte původní ID operace a čtěte pouze tuto původní dávku. Vypršení časového limitu, chyba ani neznámý stav neopravňují k dalšímu vytvoření.
Pole odpovědi
| Pole | Typ |
|---|---|
Poleresults[] | Typarray |
Poleresults[].custom_id | Typstring |
Poleresults[].response | Typobject |
Poleresults[].error | Typobject |
Chyby a další kroky
| Odpověď | Podmínka | Další krok |
|---|---|---|
Odpověď400 · invalid_request_error | PodmínkaPovinné pole, selektor modelu, typ nebo podoba vstupu jsou neplatné. | Další krokPřed přípravou samostatného požadavku si prohlédněte vrácené podrobnosti validace. |
Odpověď | PodmínkaPůvodní požadavek nebo výsledek je neznámý nebo vyžaduje kontrolu. | Další krokZachovejte původní identifikátory a hlavičky; čtěte pouze podporované záznamy o stavu nebo záznamy knihovny. Požadavek na vytvoření znovu neodesílejte. |
Aliasy
Aliasy modelu
Ailoot Ultra openai/text-embedding-3-large:batch
Aliasy cest metod
Použijte cesty metod uvedené výše.
Související ID modelů
FAQ · OpenAI: Text Embedding 3 Large (batch)
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/batches·openai/text-embedding-3-large:batch:text→embedding- Jaká pole požadavek používá?
POST /v1/batches·openai/text-embedding-3-large:batch:model,endpoint,requests