model

OpenAI: Text Embedding 3 Large

Markdown · JSON

OpenAI: Text Embedding 3 Large

Model embedding teks generasi ketiga OpenAI yang lebih besar mengembalikan vektor 3.072 dimensi secara bawaan, dengan kendali produsen untuk representasi lebih pendek. Gunakan untuk temu kembali semantik, perbandingan multibahasa, dan alur konten terkait atau klasifikasi.

Tentang model

Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.

text-embedding-3-large adalah model embedding teks generasi ketiga OpenAI yang lebih besar untuk tugas bahasa Inggris dan non-Inggris. Model memetakan materi tertulis menjadi vektor numerik, mengembalikan 3.072 komponen secara bawaan. Vektor merepresentasikan hubungan dalam konten yang diberikan; proses temu kembali atau klasifikasi menggunakannya untuk memilih materi atau membuat keputusan lain.

Model generasi ketiga dilatih untuk mendukung representasi lebih pendek melalui kendali dimensions produsen. Pembuat memberikan 1.024 dimensi sebagai contoh ketika penyimpanan vektor membutuhkan ukuran tersebut. Vektor yang lebih pendek mengurangi data untuk disimpan dan dibandingkan, sementara perubahan representasi dapat memengaruhi kualitas temu kembali. Pilih ukuran berdasarkan kebutuhan aplikasi dan gunakan pilihan yang sama untuk korpus serta kuerinya.

Contoh alur pencarian dokumen membagi materi sumber menjadi bagian bermakna, mempertahankan pengenalnya, dan memperoleh vektor untuk setiap bagian. Pertanyaan dibuat embedding-nya dengan model dan dimensi yang sama, lalu dibandingkan dengan vektor bagian. Aplikasi menyediakan filter, memilih hasil berperingkat, dan menampilkan rujukan sumber. Model pembangkitan teks berikutnya dapat menyusun jawaban dari materi yang ditemukan; hasil model embedding tetap berupa data numerik.

Aplikasi lain yang didokumentasikan meliputi pencarian kode atau teks, pengelompokan rekaman serupa, rekomendasi konten terkait, klasifikasi, deteksi anomali, dan pengukuran keragaman koleksi. Untuk rekomendasi, jelaskan objek menggunakan istilah yang relevan dengan hubungannya. Untuk klasifikasi, bandingkan dengan representasi kategori atau gunakan vektor sebagai fitur pengklasifikasi. Tetapkan aturan yang mengubah kemiripan menjadi hasil yang dibutuhkan produk.

OpenAI mencantumkan masukan maksimum 8.192 token per teks. API embedding menerima string atau teks yang ditokenisasi, mendukung beberapa masukan, dan menolak string kosong. API juga menerapkan batas agregat 300.000 token untuk satu permintaan. Dokumen panjang harus dibagi dengan mempertahankan batas bermakna dan konteksnya, serta menjaga setiap vektor terhubung dengan bagian sumber.

Produsen mendokumentasikan vektor float sebagai keluaran bawaan dan base64 sebagai pengodean alternatif. Panduan menyarankan kemiripan kosinus dan menyatakan bahwa embedding OpenAI dinormalisasi ke panjang satu, sehingga hasil kali titik dapat menghitung kemiripan kosinus dan jarak Euclidean memberikan peringkat setara. Jika vektor generasi ketiga dipendekkan secara manual setelah dibuat, pembuat menginstruksikan aplikasi untuk menormalisasi kembali vektor yang dipendekkan; penggunaan kendali dimensions adalah cara yang disarankan.

Siapkan representasi teks yang konsisten dan catat model, dimensi, serta pengenal sumber. Artefak akhir yang berguna adalah himpunan bagian berperingkat, item terkait, atau rekaman berkelompok dengan aturan pemilihan yang eksplisit. Nilai apakah hasil menjawab kueri dan pertahankan bukti sumber untuk tahap berikutnya, bukan memperlakukan kemiripan vektor sebagai verifikasi klaim faktual rekaman.

Ailoot Ultra · Embedding POST /v1/embeddings openai/text-embedding-3-large

openai/text-embedding-3-large

OpenAI /openai/text-embedding-3-large
ID model
  • openai/text-embedding-3-large
  • text-embedding-3-large

Mulai

Model embedding teks generasi ketiga OpenAI yang lebih besar mengembalikan vektor 3.072 dimensi secara bawaan, dengan kendali produsen untuk representasi lebih pendek. Gunakan untuk temu kembali semantik, perbandingan multibahasa, dan alur konten terkait atau klasifikasi.

Masukan yang diterima
Teks · token_ids
Hasil
embedding

Tersedia di Ailoot · masukan & metode

Ailoot Ultra · Embedding POST /v1/embeddings
Masukan
text, token_ids
Keluaran
embedding
Konteks
8.192 tokens
Format keluaran
json
KolomJenisPersyaratanNilai & batasanBawaan
KolommodelJenisstringPersyaratanWajibNilai & batasan
openai/text-embedding-3-large
Bawaan—
KolominputJenisstring|string[]|integer[]|integer[][]PersyaratanWajibNilai & batasan
Item minimum: 1
Kondisi: Batch homogen yang tidak kosong. ID token berupa bilangan bulat nonnegatif.
Anggaran masukan: Maksimum: 8.192 · Satuan teks: byte UTF8 · Satuan token: elemen array token
Bawaan—
Kolomencoding_formatJenisstringPersyaratanOpsionalNilai & batasan
float
Bawaanfloat
KolomdimensionsJenisintegerPersyaratanTidak didukungNilai & batasan
Minimum: 1
Bawaan—
KolomuserJenisjson_valuePersyaratanOpsionalNilai & batasan
Kondisi: Sumber mengizinkan kolom metadata JSON ini; makna tepatnya pada layanan hulu bergantung pada model.
Bawaan—
Kolomsession_idJenisjson_valuePersyaratanOpsionalNilai & batasan
Kondisi: Sumber mengizinkan kolom metadata JSON ini; makna tepatnya pada layanan hulu bergantung pada model.
Bawaan—
KolomtraceJenisjson_valuePersyaratanOpsionalNilai & batasan
Kondisi: Sumber mengizinkan kolom metadata JSON ini; makna tepatnya pada layanan hulu bergantung pada model.
Bawaan—
KolomproviderJenisobjectPersyaratanOpsionalNilai & batasan
Kondisi: provider.options ditolak
Bawaan—
Kombinasi bahan masukan

text_to_embedding

Parameter metode dan siklus hidup
ParameterKontrak
Parametercontent_typeKontrakapplication/json
ParameterrequiredKontrakmodel, input
Parameterinput_shapesKontrakstring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[]
Parameterencoding_formatKontrakfloat
Parameterdimensions_overrideKontrakfalse
Parametermax_input_budget_unitsKontrak8192
Parametermultimodal_objectsKontrakfalse
Parametermaterial_typesKontraktext, token_ids

Siklus hidup: synchronous_json

Pertahankan index dan dimensi setiap vektor.

Nama model multimodal tidak mengizinkan objek gambar pada jalur persis ini.

Paket

Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.

Mode Fast
Tarif standar Saat mode fast dipilih
Mode Flex
Tarif standar Saat mode flex dipilih
Upaya penalaran maksimum
Tarif standar Saat upaya penalaran maksimum menggunakan penyesuaian default

Tarif Ailoot

Harga menurut konfigurasi

KonfigurasiJadwal tarifBiaya
KonfigurasiTarif dasar tokenJadwal tarifTarif dasarBiaya
Masukan · Token masukan $0.00026 / 1K token
Keluaran · Token keluaran $0 / 1K token
Masukan · Pembacaan cache — / 1K token
Masukan · Penulisan cache — / 1K token
Masukan · Penulisan cache, 1 jam — / 1K token

Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →

Contoh permintaan

Ailoot Ultra · Embedding

curlPython SDK
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "openai/text-embedding-3-large", "input": ["First document", "Second document"]}')

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/embeddings \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
for x in r.get("data",[]): print(json.dumps({"index":x.get("index"),"embedding":x.get("embedding")}))
PY_RESULT
from openai import OpenAI
import os

client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.embeddings.create(model='openai/text-embedding-3-large',input=["First document","Second document"])
print(result)
for item in result.data:print(item.index,item.embedding)

Terima dan simpan hasil

Ailoot Ultra · Embedding

json

Simpan semua hasil yang selesai

Simpan setiap respons lengkap, berkas, dan bagian konten yang dikembalikan.

Simpan setiap vektor beserta index masing-masing. Jumlah vektor harus sama dengan jumlah input; dimensinya harus konsisten.

Jika respons asli perlu diperiksa

Endpoint untuk tugas embedding tidak ditambahkan.

Kolom respons
KolomJenis
KolomobjectJenisstring
KolommodelJenisstring
Kolomdata[].indexJenisinteger
Kolomdata[].embeddingJenisfinite float[]
KolomusageJenisobject
Kesalahan dan langkah berikutnya
ResponsKondisiLangkah berikutnya
Respons400 · invalid_request_errorKondisiBidang wajib, representasi materi, atau nilai parameter tidak validLangkah berikutnyaPerbaiki bidang yang ditunjukkan sebelum permintaan pembuatan baru.

Alias

Alias model

Ailoot Ultra openai/text-embedding-3-large, text-embedding-3-large

Alias jalur metode

Gunakan jalur metode yang ditampilkan di atas.

ID pemanggil terkait

openai/text-embedding-3-large, text-embedding-3-large

Ailoot Ultra · Embedding · text-embedding-3-large POST /v1/embeddings text-embedding-3-large

text-embedding-3-large

OpenAI /text-embedding-3-large
ID model
  • openai/text-embedding-3-large
  • text-embedding-3-large

Mulai

Model embedding teks generasi ketiga OpenAI yang lebih besar mengembalikan vektor 3.072 dimensi secara bawaan, dengan kendali produsen untuk representasi lebih pendek. Gunakan untuk temu kembali semantik, perbandingan multibahasa, dan alur konten terkait atau klasifikasi.

Masukan yang diterima
Teks
Hasil
embedding

Tersedia di Ailoot · masukan & metode

Ailoot Ultra · Embedding · text-embedding-3-large POST /v1/embeddings
Masukan
text
Keluaran
embedding
Konteks
8.192 tokens
Format keluaran
json
KolomJenisPersyaratanNilai & batasanBawaan
KolommodelJenisstringPersyaratanWajibNilai & batasan
text-embedding-3-large
Bawaan—
KolominputJenisstring|string[]|integer[]|integer[][]PersyaratanWajibNilai & batasan
Item minimum: 1
Kondisi: Batch homogen yang tidak kosong. ID token berupa bilangan bulat nonnegatif.
Anggaran masukan: Maksimum: 8.192 · Satuan teks: byte UTF8 · Satuan token: elemen array token
Bawaan—
Kolomencoding_formatJenisstringPersyaratanOpsionalNilai & batasan
float
Bawaanfloat
KolomdimensionsJenisintegerPersyaratanTidak didukungNilai & batasan
Minimum: 1
Bawaan—
KolomuserJenisjson_valuePersyaratanOpsionalNilai & batasan
Kondisi: Metadata JSON opsional; semantik upstream yang persis bergantung pada model yang dipilih.
Bawaan—
Kolomsession_idJenisjson_valuePersyaratanOpsionalNilai & batasan
Kondisi: Metadata JSON opsional; semantik upstream yang persis bergantung pada model yang dipilih.
Bawaan—
KolomtraceJenisjson_valuePersyaratanOpsionalNilai & batasan
Kondisi: Metadata JSON opsional; semantik upstream yang persis bergantung pada model yang dipilih.
Bawaan—
KolomproviderJenisobjectPersyaratanOpsionalNilai & batasan
Kondisi: provider.options ditolak
Bawaan—
Kombinasi bahan masukan

text_to_embedding

Parameter metode dan siklus hidup
ParameterKontrak
Parametercontent_typeKontrakapplication/json
ParameterrequiredKontrakmodel, input
Parameterinput_shapesKontrakstring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[]
Parameterencoding_formatKontrakfloat
Parameterdimensions_overrideKontrakfalse
Parametermax_input_budget_unitsKontrak8192
Parametermultimodal_objectsKontrakfalse
Parametermaterial_typesKontraktext
Parametertext_file_materialKontrakBaca dokumen UTF-8 yang sebenarnya dan masukkan teksnya ke string masukan atau konten pesan yang ditunjukkan.

Siklus hidup: synchronous_json

Kirim ID model yang persis dan bidang wajib.

Simpan setiap item yang dikembalikan beserta pengenal aslinya.

Paket

Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.

Mode Fast
Tarif standar Saat mode fast dipilih
Mode Flex
Tarif standar Saat mode flex dipilih
Upaya penalaran maksimum
Tarif standar Saat upaya penalaran maksimum menggunakan penyesuaian default

Tarif Ailoot

Harga menurut konfigurasi

KonfigurasiJadwal tarifBiaya
KonfigurasiTarif dasar tokenJadwal tarifTarif dasarBiaya
Masukan · Token masukan $0.00026 / 1K token
Keluaran · Token keluaran $0 / 1K token
Masukan · Pembacaan cache — / 1K token
Masukan · Penulisan cache — / 1K token
Masukan · Penulisan cache, 1 jam — / 1K token

Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →

Contoh permintaan

Ailoot Ultra · Embedding · text-embedding-3-large

Isi permintaan JSON minimal yang lengkapcurl · gunakan dokumen UTF-8 AndaPython · simpan hasil secara lengkap
{
  "model": "text-embedding-3-large",
  "input": [
    "First document",
    "Second document"
  ],
  "encoding_format": "float"
}
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"
export AILOOT_TEXT_FILE
python3 - <<'PY_REQUEST'
import json, os
from pathlib import Path

source_file = Path(os.environ['AILOOT_TEXT_FILE'])
if not source_file.is_file():
    raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')
text = source_file.read_text(encoding='utf-8')
if not text.strip():
    raise SystemExit('Choose a document containing text')
payload = {'model': 'text-embedding-3-large', 'input': ['First document', 'Second document'], 'encoding_format': 'float'}
payload['input'] = [text]
Path('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/embeddings \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path

result = json.loads(Path('result.json').read_text(encoding='utf-8'))
print(json.dumps(result, ensure_ascii=False, indent=2))
for vector in result.get('data', []):
    print('Vector', vector.get('index'), json.dumps(vector.get('embedding')))
PY_RESULT
import json, os
from pathlib import Path

source_file = Path(os.environ['AILOOT_TEXT_FILE'])
if not source_file.is_file():
    raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')
text = source_file.read_text(encoding='utf-8')
if not text.strip():
    raise SystemExit('Choose a document containing text')
payload = {'model': 'text-embedding-3-large', 'input': ['First document', 'Second document'], 'encoding_format': 'float'}
payload['input'] = [text]
from urllib.request import Request, urlopen
from urllib.error import HTTPError

api_key = os.environ['AILOOT_API_KEY']
if not api_key.strip():
    raise SystemExit('Set AILOOT_API_KEY before making a request')
headers = {'Authorization': 'Bearer PLACEHOLDER_KEY', 'Content-Type': 'application/json'}
headers['Authorization'] = 'Bearer ' + api_key
request = Request('https://api.ailoot.ai/v1/embeddings', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')
try:
    with urlopen(request, timeout=120) as response:
        raw = response.read()
        Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')
except HTTPError as error:
    Path('result.json').write_bytes(error.read())
    Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')
    raise
Path('result.json').write_bytes(raw)
import json
from pathlib import Path

result = json.loads(Path('result.json').read_text(encoding='utf-8'))
print(json.dumps(result, ensure_ascii=False, indent=2))
for vector in result.get('data', []):
    print('Vector', vector.get('index'), json.dumps(vector.get('embedding')))

Terima dan simpan hasil

Ailoot Ultra · Embedding · text-embedding-3-large

json

Simpan semua hasil yang selesai

Simpan setiap respons lengkap, berkas, dan bagian konten yang dikembalikan.

Simpan setiap vektor bernilai berhingga beserta indeks aslinya. Pertahankan seluruh dimensi dan objek penggunaan secara utuh.

Jika respons asli perlu diperiksa

Endpoint untuk tugas embedding tidak ditambahkan.

Kolom respons
KolomJenis
KolomobjectJenisstring
KolommodelJenisstring
Kolomdata[].indexJenisinteger
Kolomdata[].embeddingJenisfinite float[]
KolomusageJenisobject
Kesalahan dan langkah berikutnya
ResponsKondisiLangkah berikutnya
Respons400 · invalid_request_errorKondisiBidang wajib, representasi materi, atau nilai parameter tidak validLangkah berikutnyaPerbaiki bidang yang ditunjukkan sebelum permintaan pembuatan baru.

Alias

Alias model

Ailoot Ultra openai/text-embedding-3-large, text-embedding-3-large

Alias jalur metode

Gunakan jalur metode yang ditampilkan di atas.

ID pemanggil terkait

openai/text-embedding-3-large, text-embedding-3-large

FAQ · OpenAI: Text Embedding 3 Large
Input dan hasil apa yang tersedia?

POST /v1/embeddings · openai/text-embedding-3-large: text, token_ids → embedding

POST /v1/embeddings · text-embedding-3-large: text → embedding

Kolom apa yang digunakan permintaan?

POST /v1/embeddings · openai/text-embedding-3-large: model, input, encoding_format, provider

POST /v1/embeddings · text-embedding-3-large: model, input, encoding_format, provider

Batasan apa yang berlaku?

POST /v1/embeddings · openai/text-embedding-3-large: ctx: 8192; input.budget.maximum: 8192 (byte UTF8); input.min_items: 1

POST /v1/embeddings · text-embedding-3-large: ctx: 8192; input.budget.maximum: 8192 (byte UTF8); input.min_items: 1

Rincian selengkapnya

Hubungkan Ailoot ke Claude Code, OpenCode, Hermes, atau aplikasi Anda.

Perusahaan dan portofolio proyeknya

Perusahaan dan portofolio proyeknya: jutaan pelanggan; penjualan miliaran setiap bulan.

Beli token dengan diskon.

Diskon langganan untuk pekerjaan rutin. Kode promo — hingga 50% untuk pembelian token.

Langganan
Pilih paket dengan diskon untuk permintaan rutin Anda.
Kode promo hingga 50%
Masukkan kode saat membeli. Harga dihitung ulang sesuai promosi aktif.
Biaya dalam riwayat
Model, token, dan jumlah tagihan disimpan untuk setiap permintaan.

Pilih langganan · Lihat harga model

Hubungkan API ke produk yang Anda jual.

SaaS, aplikasi, dan bot — sesuai penawaran dan perjanjian lisensi Ailoot. Untuk penjualan kembali, mintalah lisensi reseller.

Aplikasi komersial
Integrasikan pembuatan teks, gambar, video, dan suara dalam fitur berbayar layanan Anda.
Lisensi reseller
Kirim deskripsi proyek dan skema akses. Mintalah ketentuan penggunaan dan penjualan kembali secara tertulis.
Dokumen di situs
Penawaran, perjanjian lisensi, dan kebijakan pemrosesan data tersedia sebelum koneksi.

Minta lisensi reseller · Penawaran dan perjanjian lisensi