OpenAI: Text Embedding 3 Large (batch)
Text Embedding 3 Large Batch indsender grupper af tekst-embedding-anmodninger som én Ailoot-batch. Spor hvert element via custom_id, og hent den oprindelige operations fuldstændige resultater.
Om modellen
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
Text Embedding 3 Large Batch bruger /v1/batches med det nøjagtige model-ID openai/text-embedding-3-large:batch. Sæt endpoint til /v1/embeddings, og angiv requests; hvert element indeholder custom_id og en body med input som en tekststreng eller et array af strenge. Hold identifikatorerne stabile, så din applikation kan knytte resultaterne til en opdatering af søgeindekset.
Batchen er asynkron. Gem det oprindeligt returnerede operations-ID, og brug GET /v1/batches/{operation_id} til at følge den samme operation med den samme kalder. Et færdigt resultatsæt kan indeholde response eller error for hvert custom_id, så undersøg elementernes udfald såvel som den samlede status.
Gem alle færdige resultater som JSONL, og bevar hvert custom_id samt hele dets response eller error. Knyt vellykkede vektorer til de indsendte dokument-ID’er, før du opdaterer indekset. Hold den oprindelige operation og elementregistreringerne samlet, så et ufuldstændigt eller mislykket element kan undersøges uden at miste allerede returnerede resultater.
Ailoot Ultra · Batch POST /v1/batches openai/text-embedding-3-large:batch
openai/text-embedding-3-large:batch
openai/text-embedding-3-large:batchStart
Text Embedding 3 Large Batch indsender grupper af tekst-embedding-anmodninger som én Ailoot-batch. Spor hvert element via custom_id, og hent den oprindelige operations fuldstændige resultater.
- Accepterede input
- Tekst
- Resultater
- embedding
Tilgængelig i Ailoot · input og metoder
Ailoot Ultra · Batch POST /v1/batches
- Inputtyper
text- Outputtyper
embedding
| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser openai/text-embedding-3-large:batch Betingelser: Brug præcis denne routingvælger for Ailoot. | Standard— |
Feltendpoint | Typestring | KravPåkrævet | Værdier og grænser /v1/embeddings Betingelser: | Standard— |
Feltrequests | Typearray | KravPåkrævet | Værdier og grænser Betingelser: | Standard— |
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, endpoint, requests |
Parameteroptional | Kontrakt |
Parametermaterial_types | Kontrakttext |
Parameterconditions | KontraktBrug præcis denne routingvælger for Ailoot. |
Livscyklus: asynchronous
GET /v1/batches/{operation_id} · Den faktiske oprindelige værdi af response.id; samme kaldende part, nøgle og gruppe.
Priser
Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.
- Hurtig tilstand
- Ikke angivet Når hurtig tilstand er valgt
- flex-tilstand
- Ikke angivet Når flex-tilstanden er valgt
- Maksimal ræsonneringsindsats
- Ikke angivet Når default-justeringen anvendes ved maksimal ræsonneringsindsats
- Priser for eksplicit caching
- Ikke aktiveret Når der anmodes om eksplicit caching
Ailoot-takster
Priser efter konfiguration
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Takstplan | Konteksttokens, mere end | Konteksttokens, op til og med | Beløb |
|---|---|---|---|---|
| KonfigurationGrundpriser for tokens | TakstplanGrundtakst | Konteksttokens, mere end— | Konteksttokens, op til og medIngen øvre grænse | Beløb Input · Inputtokens $0.00013 / 1K tokens Output · Outputtokens $0 / 1K tokens Input · Cachelæsning — / 1K tokens Input · Cacheskrivning — / 1K tokens Input · Cacheskrivning, 1 time — / 1K tokens |
| KonfigurationAnmodningslængde · niveau 1 | Takstplan— | Konteksttokens, mere end0 | Konteksttokens, op til og medIngen øvre grænse | Beløb Input · Inputtokens $0.00013 / 1K tokens Output · Outputtokens $0 / 1K tokens Input · Cachelæsning — / 1K tokens Input · Cacheskrivning — / 1K tokens Input · Cacheskrivning, 1 time — / 1K tokens |
Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
Eksempelanmodninger
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
Hent og gem resultater
Ailoot Ultra · Batch
GET /v1/batches/{operation_id}
Behold alle færdige resultater
Gem hvert fuldstændigt returneret svar, hver fil og hver indholdsdel.
Bevar den oprindelige status, hver custom_id og det fuldstændige svar eller den fuldstændige fejl. Gem alle afsluttede results[] som JSONL; der udledes ingen sti til upload eller download via Files.
Hvis det oprindelige svar skal kontrolleres
Bevar det oprindelige operations-ID, og læs kun denne oprindelige batch. En timeout, fejl eller ukendt tilstand giver ikke tilladelse til endnu en oprettelse.
Svarfelter
| Felt | Type |
|---|---|
Feltresults[] | Typearray |
Feltresults[].custom_id | Typestring |
Feltresults[].response | Typeobject |
Feltresults[].error | Typeobject |
Fejl og næste trin
| Svar | Betingelse | Næste trin |
|---|---|---|
Svar400 · invalid_request_error | BetingelseEt påkrævet felt, en modelvælger, en type eller en inputrepræsentation er ugyldig. | Næste trinUndersøg de returnerede valideringsoplysninger, før du forbereder en separat anmodning. |
Svar | BetingelseDen oprindelige anmodning eller resultatet er ukendt eller skal kontrolleres. | Næste trinBevar de oprindelige identifikatorer og headere; læs kun understøttede status- eller biblioteksposter. Indsend ikke oprettelsesanmodningen igen. |
Aliaser
Modelaliaser
Ailoot Ultra openai/text-embedding-3-large:batch
Aliaser for metodestier
Brug metodestierne vist ovenfor.
Relaterede kalder-ID’er
FAQ · OpenAI: Text Embedding 3 Large (batch)
- Hvilke input og resultater er tilgængelige?
POST /v1/batches·openai/text-embedding-3-large:batch:text→embedding- Hvilke felter bruger anmodningen?
POST /v1/batches·openai/text-embedding-3-large:batch:model,endpoint,requests