Saltar al contenido principal
Use una DGrid Model API Key para las solicitudes a los modelos. Una Management API Key es una credencial administrativa y no sirve para este tutorial. Compruebe que la clave tenga saldo disponible y acceso al modelo seleccionado.
Vercel publica AI SDK Core como el paquete npm ai. Instalará el paquete, importará generateText() y conectará DGrid mediante el proveedor oficial compatible con OpenAI. Consulte la introducción a Vercel AI SDK. Configure su clave de DGrid, la URL base compatible con OpenAI y el ID completo del modelo; después ejecute un script de Node.js para mostrar la respuesta obtenida mediante Vercel AI SDK. Esta guía usa openai/gpt-6-sol. La aplicación se ejecuta localmente y envía la solicitud a DGrid mediante el proveedor compatible con OpenAI de AI SDK.

Cómo se conecta Vercel AI SDK con DGrid

El SDK aparece tanto en la instalación como en el código JavaScript: La solicitud sigue este flujo: Su script → Vercel AI SDK generateText() → proveedor compatible con OpenAI → DGrid → respuesta del modelo Node.js ejecuta el programa, Vercel AI SDK proporciona la interfaz de llamada y DGrid procesa la solicitud. El ejemplo oficial del proveedor compatible también combina generateText() y createOpenAICompatible().

Antes de empezar

  • Un equipo macOS o Windows con acceso a Internet.
  • Node.js 22 o posterior, con npm.
  • Una cuenta de DGrid con saldo y acceso al modelo que desea usar.
El entorno del ejemplo usa Node.js 22.14.0, npm 10.9.2, ai 7.0.148 y @ai-sdk/openai-compatible 3.0.75. Los comandos instalan AI SDK 7 y el proveedor compatible 3. Las capturas son de macOS; se indican las diferencias de comandos para Windows.

Paso 1: instalar Node.js y comprobar el entorno

Si Node.js no está instalado, descargue la versión LTS actual desde la página oficial.
  • macOS: elija el instalador de macOS, ejecute el .pkg descargado y siga los pasos.
  • Windows: elija el instalador de la arquitectura de su equipo, ejecute el .msi descargado y siga los pasos.
Los instaladores estándar incluyen npm. Después abra una nueva ventana de Terminal en macOS o PowerShell en Windows y ejecute:
Ambos comandos deben mostrar una versión. Si Node.js es anterior a 22, actualícelo antes de continuar.

Paso 2: crear una clave API de DGrid

  1. Inicie sesión en DGrid y abra API Keys.
  2. Haga clic en Create New Key, asigne un nombre y cree la clave.
  3. Copie la clave para el paso 5. No muestre la clave completa en capturas ni archivos compartidos.
  4. En la lista de DGrid, compruebe el acceso a openai/gpt-6-sol o copie el ID completo de otro modelo compatible con Chat Completions.
Use el ID completo con el prefijo del proveedor; en este ejemplo, openai/gpt-6-sol.

Paso 3: crear el proyecto e instalar Vercel AI SDK

Ejecute estos comandos en Terminal de macOS o PowerShell de Windows:
Este comando instala Vercel AI SDK Core (ai@7) y su proveedor compatible con OpenAI (@ai-sdk/openai-compatible@3). El siguiente paso importa ambos paquetes para llamar a DGrid. Espere a que npm confirme la instalación y vuelva el indicador del terminal. El tiempo depende de su conexión.
Proyecto de ejemplo y dependencias del SDK instalados en Terminal

Proyecto de ejemplo y dependencias del SDK instalados en Terminal

Paso 4: llamar a DGrid con Vercel AI SDK

En un editor, cree demo.mjs en dgrid-ai-sdk-quickstart, junto a package.json. Pegue el código y guarde como texto sin formato. Compruebe que se llame demo.mjs, no demo.mjs.txt. La extensión .mjs permite a Node.js usar las instrucciones import del ejemplo.
Estos son los principales ajustes de conexión: Si eligió otro modelo en el paso 2, sustituya openai/gpt-6-sol por su ID completo. name: 'dgrid' es una etiqueta local del SDK.

Paso 5: introducir su clave API de DGrid

Siga las instrucciones de su intérprete. Introduzca la clave en el mismo terminal donde ejecutará el script.

Terminal de macOS con Zsh

Ejecute:
En Paste your DGrid API key (hidden):, pegue su clave y pulse Intro. No se mostrará en pantalla.

Windows PowerShell

Ejecute el primer comando, introduzca la clave en el indicador oculto y pulse Intro. Después ejecute los demás comandos para proporcionársela a Node.js:
Los ajustes solo duran durante esta sesión. Defina la clave de nuevo en otro terminal. No la incluya en demo.mjs ni en el control de versiones.

Paso 6: ejecutar el ejemplo

Desde el directorio del proyecto y en el terminal donde introdujo la clave, ejecute:
Espere la respuesta del modelo. Para el prompt del ejemplo, el texto esperado es:
Ejecución del script y recepción de la respuesta mediante DGrid

Ejecución del script y recepción de la respuesta mediante DGrid

Para hacer otra pregunta, modifique prompt en demo.mjs, guarde y ejecute de nuevo node demo.mjs. Cada ejecución crea una solicitud.

Paso 7: consultar la solicitud en DGrid

Busque el modelo y la hora en el historial de DGrid. Una solicitud completada muestra Success.
Historial de DGrid con el modelo elegido y Success; Key Name está difuminado

Historial de DGrid con el modelo elegido y Success; Key Name está difuminado

Key Name está difuminado por privacidad. Los tokens, el uso de caché y los cargos varían según la solicitud.

Solución de problemas

Consulte la guía de AI SDK para Node.js y la documentación del proveedor compatible con OpenAI.

Recursos relacionados