Embeddings

Convierte texto en vectores para búsqueda semántica, agrupación, deduplicación y generación aumentada por recuperación (RAG). El endpoint tiene el mismo formato que POST /embeddings de OpenAI, así que client.embeddings.create(...) funciona sin cambios.

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

Petición

Ejemplo

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));

Respuesta

{
  "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 coincide con la posición de la entrada en tu array input.

Elegir un modelo

Lista los modelos de embeddings con sus precios, sin necesidad de clave de API:

curl https://api14.com/api/v1/embeddings/models
# o, con categorías y nuestros precios:
curl "https://api14.com/api/v1/models?category=embeddings"

Los vectores de modelos distintos no son comparables. Guarda el id del modelo junto a cada vector y vuelve a calcular los embeddings de tu corpus cuando cambies de modelo.

Precios

Los embeddings se facturan por token de entrada al precio indicado del modelo, mostrado como "$ / 1M tokens". El coste de cada petición se devuelve en usage.cost (USD) y se descuenta de tu saldo. Consulta Precios y facturación.

Consejos

• Agrupa las entradas: una petición con 100 cadenas es más rápida y cuenta como una sola petición para tu límite de tasa.
• Mantén cada entrada por debajo de la longitud de contexto del modelo; el texto más largo se rechaza en el proveedor.
• Normaliza los vectores (la mayoría de los modelos ya devuelven longitud unitaria) y usa la similitud del coseno.

Errores

Lista completa: Errores.