Kami menggunakan cookie. Cookie dan penyimpanan browser menjaga Anda tetap masuk dan mengingat preferensi Anda. Dengan izin Anda, kami juga mengukur cara situs digunakan. Anda dapat kapan saja. Lihat kebijakan cookie kami.

Embeddings

Endpoint

Embeddings

POST /embeddings mengubah teks menjadi vektor untuk pencarian semantik, clustering, deduplikasi, dan RAG, dengan format yang sama seperti OpenAI.

Coba di playground

Ubah teks menjadi vektor untuk pencarian semantik, clustering, deduplikasi, dan retrieval-augmented generation (RAG). Endpoint ini memiliki bentuk yang sama dengan POST /embeddings milik OpenAI, sehingga client.embeddings.create(...) bekerja tanpa perubahan.

POST https://api14.com/api/v1/embeddings

Request

ParameterTipeWajibDeskripsi
modelstringyaID model embeddings, mis. openai/text-embedding-3-small.
inputstring atau string[]yaTeks yang akan di-embed. Kirim array untuk meng-embed banyak input dalam satu request.
dimensionsintegertidakUkuran vektor keluaran, untuk model yang mendukung pemendekan (mis. text-embedding-3-*).
encoding_formatstringtidakfloat (default) atau base64.
userstringtidakID pengguna akhir Anda sendiri, diteruskan ke upstream.
providerobjecttidakPreferensi routing provider. Lihat Provider routing.

Contoh

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api14.com/api/v1",
  apiKey: process.env.API14_API_KEY,
});

const result = await client.embeddings.create({
  "model": "openai/text-embedding-3-small",
  "input": [
    "The quick brown fox",
    "Lorem ipsum"
  ]
});
console.log(result.data.map((d) => d.embedding.length));

Respons

{
  "object": "list",
  "data": [
    { "object": "embedding", "index": 0, "embedding": [0.0023, -0.0091, 0.0154, "..."] }
  ],
  "model": "openai/text-embedding-3-small",
  "usage": { "prompt_tokens": 8, "total_tokens": 8, "cost": 0.00000016 }
}

data[i].index sesuai dengan posisi input pada array input Anda.

Memilih model

Tampilkan daftar model embeddings beserta harganya, tanpa API key:

curl https://api14.com/api/v1/embeddings/models
# or, with categories and our prices:
curl "https://api14.com/api/v1/models?category=embeddings"

Vektor dari model yang berbeda tidak dapat dibandingkan. Simpan ID model di samping setiap vektor dan embed ulang korpus Anda saat berganti model.

Harga

Embeddings ditagih per token input sesuai harga model yang tercantum, ditampilkan sebagai "$ / 1M token". Biaya tiap request dikembalikan di usage.cost (USD) dan dipotong dari saldo Anda. Lihat Harga dan penagihan.

Tips

  • Kelompokkan input: satu request dengan 100 string lebih cepat dan dihitung sebagai satu request terhadap batas laju Anda.
  • Jaga setiap input tetap di bawah panjang konteks model; teks yang lebih panjang ditolak oleh upstream.
  • Normalisasi vektor (kebanyakan model sudah mengembalikan panjang satuan) dan gunakan cosine similarity.

Error

StatusKodeKapan
400model_required / invalid_jsonmodel tidak ada atau body bukan objek JSON.
401invalid_api_keyKey tidak ada atau tidak valid.
402insufficient_balanceSaldo USD Anda $0.
403model_not_allowedAllowlist model pada key tidak mencakup model ini.
404model_not_foundID model tidak dikenal atau dinonaktifkan.
429rate_limitedBatas request per menit terlampaui.

Daftar lengkap: Error.