OpenAI: Text Embedding Ada 002 (batch)
Text Embedding Ada 002 Batch odosiela skupiny požiadaviek na textové embeddingy ako jednu dávku Ailoot. Každú položku sledujte podľa custom_id a načítajte úplné výsledky pôvodnej operácie.
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.
Text Embedding Ada 002 Batch používa /v1/batches s presným ID modelu openai/text-embedding-ada-002:batch. Nastavte endpoint na /v1/embeddings a dodajte requests; každá položka obsahuje custom_id a body s input ako textovým reťazcom alebo poľom reťazcov. Identifikátory ponechajte stabilné, aby aplikácia mohla priradiť výsledky k kolekcii nových alebo upravených pasáží.
Dávka je asynchrónna. Uchovajte pôvodné vrátené ID operácie a použite GET /v1/batches/{operation_id} na sledovanie tej istej operácie tým istým volajúcim. Dokončená sada výsledkov môže pre každé custom_id obsahovať odpoveď alebo chybu, preto preskúmajte výsledky jednotlivých položiek aj celkový stav.
Všetky dokončené výsledky uložte ako JSONL a zachovajte každé custom_id spolu s jeho úplnou odpoveďou alebo chybou. Pred aktualizáciou indexu priraďte úspešné vektory k odoslaným ID dokumentov. Záznamy pôvodnej operácie a položiek ponechajte spolu, aby sa neúplná alebo neúspešná položka dala preskúmať bez straty už vrátených výsledkov.
Ailoot Ultra · Batch POST /v1/batches openai/text-embedding-ada-002:batch
openai/text-embedding-ada-002:batch
openai/text-embedding-ada-002:batchÚvod
Text Embedding Ada 002 Batch odosiela skupiny požiadaviek na textové embeddingy ako jednu dávku Ailoot. Každú položku sledujte podľa custom_id a načítajte úplné výsledky pôvodnej operácie.
- Povolené vstupy
- Text
- Výsledky
- embedding
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Batch POST /v1/batches
- Vstup
text- Výstup
embedding
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity openai/text-embedding-ada-002:batch Podmienky: Použite presne tento smerovací selektor Ailoot. | Predvolené— |
Poleendpoint | Typstring | PožiadavkaPovinné | Hodnoty a limity /v1/embeddings Podmienky: | Predvolené— |
Polerequests | Typarray | PožiadavkaPovinné | Hodnoty a limity Podmienky: | Predvolené— |
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, endpoint, requests |
Parameteroptional | Špecifikácia |
Parametermaterial_types | Špecifikáciatext |
Parameterconditions | ŠpecifikáciaPoužite presne tento smerovací selektor Ailoot. |
Životný cyklus: asynchronous
GET /v1/batches/{operation_id} · Skutočné pôvodné response.id, rovnaký volajúci, kľúč a 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.0001 / 1K tokenov Výstup · Výstupné tokeny $0 / 1K tokenov Vstup · Čítanie cache — / 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.0001 / 1K tokenov Výstup · Výstupné tokeny $0 / 1K tokenov Vstup · Čítanie cache — / 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 · 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-ada-002: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
Prijať a uložiť výsledky
Ailoot Ultra · Batch
GET /v1/batches/{operation_id}
Uchovať všetky dokončené výsledky
Uložte každú úplnú vrátenú odpoveď, súbor a časť obsahu.
Zachovajte pôvodný stav, každý custom_id a úplnú odpoveď alebo chybu. Uložte všetky dokončené results[] vo formáte JSONL; žiadna cesta na nahrávanie či sťahovanie cez Files sa nepredpokladá.
Ak treba overiť pôvodnú odpoveď
Zachovajte pôvodné ID operácie a čítajte iba túto pôvodnú dávku. Vypršanie časového limitu, chyba ani neznámy stav neoprávňujú na ďalšie vytvorenie.
Polia odpovede
| Pole | Typ |
|---|---|
Poleresults[] | Typarray |
Poleresults[].custom_id | Typstring |
Poleresults[].response | Typobject |
Poleresults[].error | Typobject |
Chyby a ďalšie kroky
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaPovinné pole, selektor modelu, typ alebo podoba vstupu sú neplatné. | Ďalší krokPred prípravou samostatnej požiadavky si pozrite vrátené podrobnosti validácie. |
Odpoveď | PodmienkaPôvodná požiadavka alebo výsledok je neznámy alebo vyžaduje kontrolu. | Ďalší krokZachovajte pôvodné identifikátory a hlavičky; čítajte iba podporované záznamy o stave alebo záznamy knižnice. Požiadavku na vytvorenie znova neodosielajte. |
Aliasy
Aliasy modelov
Ailoot Ultra openai/text-embedding-ada-002:batch
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · OpenAI: Text Embedding Ada 002 (batch)
- Aké vstupy a výsledky sú dostupné?
POST /v1/batches·openai/text-embedding-ada-002:batch:text→embedding- Aké polia používa požiadavka?
POST /v1/batches·openai/text-embedding-ada-002:batch:model,endpoint,requests