Migra tus aplicaciones para usar la API de incrustación y reranking de Atlas

La API de incrustación y reclasificación está disponible Vista previa. La función y la documentación correspondiente pueden cambiar en cualquier momento durante el período de vista previa.

Si ya eres usuario de Voyage IA, completa los siguientes pasos para migrar tu aplicación para usar la API de Embedimiento y Reordenamiento de Atlas.

Procedimiento

Regístrese para obtener una cuenta Atlas gratuita o inicie sesión.

Si eres nuevo en Atlas, se crea una organización y un proyecto para ti.

Para obtener más información, consulte Crear una cuenta Atlas.

Cree una clave API de modelo para su proyecto.

En su proyecto Atlas, seleccione AI Models desde la barra de navegación.
Haga clic en Create model API key.
Asigna un nombre a la clave API y luego haz clic en Create.

Para confirmar que su clave API es válida, puede realizar una solicitud de prueba a la API de incrustación y reclasificación:

curl \
  --request POST 'https://ai.mongodb.com/v1/embeddings' \
  --header "Authorization: Bearer $VOYAGE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "input": "Sample text",
    "model": "voyage-4-lite",
    "input_type": "document"
  }'

Para obtener más información sobre cómo crear y administrar claves API, consulte Claves API del modelo.

Reemplace su clave API de Voyage existente con la clave API del modelo.

Por ejemplo, si configura su clave API como una variable de entorno, actualice el valor:

VOYAGE_API_KEY="<your-new-model-api-key>"

Si pasa la clave API directamente en su código, actualice el valor donde inicializa el cliente o realiza solicitudes API.

Nota

Si configura su clave API como una variable de entorno, puede ejecutar el siguiente comando para verificar que la variable esté configurada:

echo $VOYAGE_API_KEY

Reemplace los puntos finales de API explícitos con los puntos finales de API de incrustación y reclasificación.

Si su aplicación especifica explícitamente los puntos finales de API, actualícela para utilizar los puntos finales de API de inserción y reclasificación equivalentes:

Punto final antiguo	Nuevo punto final
`https://api.voyageai.com/v1/embeddings`	`https://ai.mongodb.com/v1/embeddings`
`https://api.voyageai.com/v1/rerank`	`https://ai.mongodb.com/v1/rerank`
`https://api.voyageai.com/v1/multimodalembeddings`	`https://ai.mongodb.com/v1/multimodalembeddings`
`https://api.voyageai.com/v1/contextualizedembeddings`	`https://ai.mongodb.com/v1/contextualizedembeddings`

Nota

Si utilizas el cliente de Python voyageai (versión 0.3.7 o posterior), el cliente enruta automáticamente las solicitudes al endpoint correcto según el formato de la clave de API. No se requieren cambios en el endpoint si utilizas el cliente sin establecer explícitamente el parámetro base_url.

Para obtener más información, consulte Cliente Python.

Verifique que su aplicación funcione con la nueva clave API.

Pruebe su aplicación para asegurarse de que genere correctamente incrustaciones y realice operaciones de reclasificación mediante la API de incrustación y reclasificación.

Borra tu antigua clave API de Voyage IA.

Después de confirmar que su aplicación funciona con la clave API del modelo, elimine su clave API anterior de la plataforma Voyage AI para evitar el acceso no autorizado.