ShareAI Platform Docs

Crear embeddings de texto

Genera embeddings de texto con ShareAI para búsqueda semántica, recuperación y similitud, con formatos de entrada compatibles y requisitos de modelos.

Ver como Markdown
En esta página
POST https://api.shareai.now/api/v1/embeddings

Convierte uno o más textos en vectores de incrustación.

URL base
https://api.shareai.now
Autenticación
Clave API Bearer o token de acceso OAuth aprobado

Elige un modelo de incrustación habilitado en ShareAI y permitido por tu credencial. Los modelos de chat no pueden sustituirse por modelos de incrustación. La disponibilidad del modelo y las opciones compatibles dependen del proveedor configurado.

Envía una solicitud#

cURL

curl --fail-with-body --request POST \
  "https://api.shareai.now/api/v1/embeddings" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_EMBEDDING_MODEL",
  "input": [
    "How do I connect a device?",
    "Where can I read my usage?"
  ],
  "encoding_format": "float"
}'

Campos de solicitud#

CampoValor
modelUn ID de modelo de incrustación habilitado.
inputUna cadena no vacía o un array de hasta 128 cadenas no vacías.
encoding_formatfloat or base64.
dimensionsEntero opcional de 1 a 65536; el modelo seleccionado debe soportarlo.

Lee los vectores#

Leer el data array y usa el resultado de cada index para hacer coincidir su incrustación con la entrada. Mantén el mismo modelo y dimensiones al incrustar tus documentos y consultas de búsqueda. El resultado también incluye usage.

Lote dentro de los límites#

El texto de entrada combinado está limitado a 256 KiB. Las respuestas son síncronas y están limitadas a 2 MiB, por lo que los vectores o lotes grandes pueden exceder el límite de respuesta. Reduce el tamaño del lote o utiliza dimensiones más pequeñas compatibles. No se aceptan arrays de ID de tokens.

Autenticación y disponibilidad#

Un token de acceso OAuth aprobado puede reemplazar la clave API. Las solicitudes financiadas por cuenta requieren surcharge y un plan aceptado. Las restricciones de modelo y proveedor aún se aplican. Si el modelo no está habilitado para incrustaciones, elige un modelo de incrustación disponible; cambiar la credencial no puede habilitar un modelo.

Uso#

Las incrustaciones consumen tokens de entrada. Verifica los precios del modelo antes de ejecutar un lote grande y utiliza Uso de la consola para revisar la actividad. Maneja errores de validación, autorización y disponibilidad antes de reintentar.

Última actualización septiembre 15, 2026

Documentación de la plataforma ShareAI
Toda la documentación

Buscar por título o contenido.

Preguntar sobre esta página

Elige un asistente para explorar esta página. También puedes copiar la página y pegarla en tu conversación.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI