OpenAI: Text Embedding Ada 002 (batch)
Text Embedding Ada 002 Batch dient groepen verzoeken voor tekstembeddings in als één Ailoot-batch. Volg elk item met custom_id en haal de volledige resultaten van de oorspronkelijke bewerking op.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Text Embedding Ada 002 Batch gebruikt /v1/batches met de exacte model-ID openai/text-embedding-ada-002:batch. Stel endpoint in op /v1/embeddings en lever requests aan; elk item bevat custom_id en een body met input als tekstuele tekenreeks of array van tekenreeksen. Houd de identificaties stabiel zodat je applicatie de resultaten kan koppelen aan een verzameling nieuwe of herziene passages.
De batch is asynchroon. Bewaar de oorspronkelijk geretourneerde bewerkings-ID en gebruik GET /v1/batches/{operation_id} om dezelfde bewerking met dezelfde aanroeper te volgen. Een voltooide resultatenset kan voor elke custom_id een response of error bevatten, dus controleer zowel de uitkomsten per item als de algemene status.
Sla alle voltooide resultaten op als JSONL met behoud van elke custom_id en de volledige response of error. Koppel geslaagde vectoren aan de ingediende document-ID’s voordat je de index bijwerkt. Houd de oorspronkelijke bewerking en itemrecords bij elkaar zodat een onvolledig of mislukt item kan worden onderzocht zonder de reeds geretourneerde resultaten te verliezen.
Ailoot Ultra · Batch POST /v1/batches openai/text-embedding-ada-002:batch
openai/text-embedding-ada-002:batch
openai/text-embedding-ada-002:batchAan de slag
Text Embedding Ada 002 Batch dient groepen verzoeken voor tekstembeddings in als één Ailoot-batch. Volg elk item met custom_id en haal de volledige resultaten van de oorspronkelijke bewerking op.
- Toegestane invoer
- Tekst
- Resultaten
- embedding
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Batch POST /v1/batches
- Invoertypen
text- Uitvoertypen
embedding
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten openai/text-embedding-ada-002:batch Voorwaarden: Gebruik exact deze Ailoot-routeringsselector. | Standaard— |
Veldendpoint | Typestring | VereisteVereist | Waarden en limieten /v1/embeddings Voorwaarden: | Standaard— |
Veldrequests | Typearray | VereisteVereist | Waarden en limieten Voorwaarden: | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, endpoint, requests |
Parameteroptional | Contract |
Parametermaterial_types | Contracttext |
Parameterconditions | ContractGebruik exact deze Ailoot-routeringsselector. |
Levenscyclus: asynchronous
GET /v1/batches/{operation_id} · De daadwerkelijke oorspronkelijke response.id, met dezelfde aanroeper, sleutel en groep.
Tarieven
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij maximale redeneerinspanning de default-aanpassing wordt gebruikt
- Tarieven voor expliciete caching
- Niet ingeschakeld Wanneer expliciete caching wordt aangevraagd
Ailoot-tarieven
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Contexttokens, meer dan | Contexttokens, tot en met | Kosten |
|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Contexttokens, meer dan— | Contexttokens, tot en metGeen bovengrens | Kosten Invoer · Invoertokens $0.0001 / 1K tokens Uitvoer · Uitvoertokens $0 / 1K tokens Invoer · Cache lezen — / 1K tokens Invoer · Cache schrijven — / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
| ConfiguratieNiveau 1 voor aanvraaglengte | Tariefstaffel— | Contexttokens, meer dan0 | Contexttokens, tot en metGeen bovengrens | Kosten Invoer · Invoertokens $0.0001 / 1K tokens Uitvoer · Uitvoertokens $0 / 1K tokens Invoer · Cache lezen — / 1K tokens Invoer · Cache schrijven — / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
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
Resultaten ophalen en opslaan
Ailoot Ultra · Batch
GET /v1/batches/{operation_id}
Alle voltooide resultaten bewaren
Bewaar elk volledig teruggegeven antwoord, bestand en inhoudsonderdeel.
Bewaar de oorspronkelijke status, elke custom_id en de volledige respons of fout. Sla alle voltooide results[] op als JSONL; hieruit wordt geen upload- of downloadroute via Files afgeleid.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de oorspronkelijke bewerkings-ID en lees alleen die oorspronkelijke batch. Een time-out, fout of onbekende status geeft geen toestemming voor een nieuw aanmaakverzoek.
Antwoordvelden
| Veld | Type |
|---|---|
Veldresults[] | Typearray |
Veldresults[].custom_id | Typestring |
Veldresults[].response | Typeobject |
Veldresults[].error | Typeobject |
Fouten en vervolgstappen
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeEen verplicht veld, modelselector, type of invoerrepresentatie is ongeldig. | Volgende stapBekijk de geretourneerde validatiedetails voordat u een afzonderlijk verzoek voorbereidt. |
Antwoord | VoorwaardeHet oorspronkelijke verzoek of resultaat is onbekend of moet worden gecontroleerd. | Volgende stapBewaar de oorspronkelijke identificatoren en headers; lees alleen ondersteunde statusgegevens of bibliotheekrecords. Dien het aanmaakverzoek niet opnieuw in. |
Aliasnamen
Modelaliasnamen
Ailoot Ultra openai/text-embedding-ada-002:batch
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · OpenAI: Text Embedding Ada 002 (batch)
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/batches·openai/text-embedding-ada-002:batch:text→embedding- Welke velden gebruikt het verzoek?
POST /v1/batches·openai/text-embedding-ada-002:batch:model,endpoint,requests