Incrustaciones
Utilice respuestas integradas con una solicitud compatible con OpenAI.
Verifique el manejo de solicitudes y respuestas para flujos de trabajo de búsqueda, recuperación, agrupación y recomendación con vectores devueltos mientras mantiene visibles las claves del lado del servidor y su uso.
Última actualización: July 12, 2026. Examples uso safe placeholders y hacer no incluir real clave APIs, secretos, o customer datos.
Primer uso recomendado
Comience con un lote pequeño, almacene vectores con metadatos de origen y luego agregue colas, reintentos y monitoreo de límite de velocidad antes de indexar un corpus grande.
Ruta de instalación
Cuatro pasos desde el texto hasta una forma vectorial devuelta.
Step 1
Autenticar del lado del servidor
Utilice una clave API con incrustaciones: alcance de escritura desde código confiable del lado del servidor.
Sección abiertaStep 2
Enviar entrada de texto
Publique una cadena o una matriz de cadenas en el punto final de incrustaciones compatibles con OpenAI.
Sección abiertaStep 3
Leer vectores con metadatos
Valide la forma vectorial devuelta con el ID de su documento, la fuente y cualquier filtro de búsqueda que su producto necesite.
Sección abiertaStep 4
Monitorear el uso
Realice un seguimiento del recuento de solicitudes, de los tokens de solicitud, del estado de la calificación y de las respuestas 429 antes de realizar grandes trabajos de indexación.
Sección abiertaPunto final
Publique texto en el punto final de incrustaciones.
Utilice el punto final /v1 compatible con OpenAI con una clave del lado del servidor con ámbito. Mantenga el contenido sin procesar fuera de los registros a menos que su política de datos lo permita.
| Artículo | Valor | Notas |
|---|---|---|
| Método | POST | Envíe JSON al punto final de incrustaciones. |
| Punto final | https://unlimitedcodex.com/v1/embeddings | Utilice la misma /v1 base URL para completar el chat y validar la solicitud de imágenes. |
| Autorización | ficha al portador | Utilice una clave API de alcance con incrustaciones: acceso de escritura. |
| tipo de contenido | aplicación/json | El cuerpo de la solicitud debe ser válido JSON. |
Solicitar forma
Envíe una entrada o un lote pequeño.
La solicitud útil más pequeña incluye un modelo y una entrada. Utilice la entrada de matriz cuando su cliente pueda asignar cada índice devuelto a un registro de origen.
| campo | Estado | Notas |
|---|---|---|
| modelo | Recomendado | Pase un valor de modelo de incrustación explícitamente. Utilice el valor del modelo de los detalles de configuración entregados. |
| entrada | Requerido | Envíe una cadena no vacía o una serie de cadenas no vacías. |
| formato_codificación | Opcional | Utilice float para vectores numéricos o base64 cuando su capa de almacenamiento prefiera una carga útil codificada. |
const response = await fetch("https://unlimitedcodex.com/v1/embeddings", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.UCX_API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "ucx-embedding-3-small",
input: [
"Release checklist for a safe API launch.",
"Rate states and usage review before rollout."
],
encoding_format: "float"
})
});
const body = await response.json();
if (!response.ok) {
throw new Error(body.error?.code ?? "embedding_request_failed");
}
const vectors = body.data.map((item) => item.embedding);Forma de respuesta
Almacene el vector y el contexto de origen juntos.
La respuesta incluye un objeto incrustado por entrada más campos de uso para informes y revisión de costos.
| campo | Significado | Notas |
|---|---|---|
| objeto | lista | Identifica la respuesta como una lista de objetos incrustados. |
| datos[].incrustación | número[] o base64 | Coincide con el formato_codificación solicitado. |
| datos[].índice | posición de entrada | Utilice esto para asignar entradas de matriz a registros de origen. |
| uso.prompt_tokens | recuento de tokens de entrada | Cuenta el volumen de texto utilizado para los informes de uso y la revisión del límite de velocidad. |
{
"object": "list",
"id": "embd_example",
"model": "ucx-embedding-3-small",
"data": [
{
"object": "embedding",
"index": 0,
"embedding": [0.1221, -0.7442, 0.0314]
}
],
"usage": {
"prompt_tokens": 18,
"total_tokens": 18
}
}{
"model": "ucx-embedding-3-small",
"input": "Short text to index.",
"encoding_format": "base64"
}Límites y errores
Trate la indexación como un trabajo consciente de las tarifas.
Las cargas de trabajo integradas pueden crecer rápidamente cuando cambia un corpus. Integre el seguimiento del progreso, los reintentos y las verificaciones de tarifas en su proceso de indexación.
El punto final devuelve vectores compatibles con OpenAI para que los equipos puedan confirmar el análisis, los informes de uso y el comportamiento de almacenamiento antes de cargas de trabajo de incorporación más grandes.
Las solicitudes de inserción cuentan como una solicitud más los tokens de aviso.
La entrada de matriz es útil para lotes pequeños, pero los trabajos de indexación grandes deben utilizar su propia cola y retroceso.
El punto final devuelve una respuesta de lista completa; las incrustaciones no se transmiten.
Utilice el manejo 429 de la guía de límite de velocidad antes de indexar un corpus grande.
No envíe secretos, datos regulados ni mensajes de texto de clientes a menos que su acuerdo permita ese uso.
FAQ
Preguntas sobre incrustaciones.
¿Puedo enviar varios mensajes de texto en una solicitud de incorporación?
Sí. El campo de entrada acepta una cadena no vacía o una matriz de cadenas no vacías. La respuesta incluye un índice para cada incrustación devuelta.
¿Qué alcance necesita una clave de incrustación?
Utilice una clave API con incrustaciones: alcance de escritura. Conserve la clave del lado del servidor y envíela como token de portador.
¿Se transmiten las incrustaciones?
No. El punto final de incrustaciones devuelve una respuesta de lista completa con campos de datos y uso.
¿Cómo debo manejar trabajos de indexación grandes?
Divida el trabajo en lotes pequeños, almacene el progreso en su propio sistema, vuelva a intentar fallas transitorias con retroceso y haga una pausa en la presión de velocidad hasta que cambie la capacidad.
Herramientas gratuitas
Validar y estimar cargas de trabajo de incorporación
Valide cargas útiles, estime tokens, modele la presión de cuotas y compare costos antes de indexar los datos de producción.
Validador de solicitudes
Valide las cargas útiles de chat, incrustaciones y imágenes JSON con reglas compatibles con unlimitedcodex OpenAI.
Estimador de tokens
Calcule el volumen de tokens a partir del mensaje o el texto de respuesta antes de la planificación y el lanzamiento de cuotas.
Estimador de cuotas
Convierta MAU y solicite suposiciones en tokens mensuales, solicitudes y advertencias de umbral de cuota.
Calculadora de costos
Calcule el gasto mensual OpenAI y compárelo con paquetes fijos unlimitedcodex semanales o mensuales.
Siguiente paso
Empareje incrustaciones con autenticación, límites de velocidad y manejo de errores.
Antes de indexar contenido orientado al cliente, confirme el alcance clave, las reglas de manejo de datos, el comportamiento del límite de velocidad y la política de reintentos.