Nota

Hola, bienvenido a la Comunidad de Entusiastas de Raspberry Pi, Arduino y ESP32 de SunFounder en Facebook. Profundice en Raspberry Pi, Arduino y ESP32 junto a otros entusiastas.

¿Por qué unirte?

  • Soporte de Expertos: Resuelve problemas post-venta y desafíos técnicos con la ayuda de nuestra comunidad y equipo.

  • Aprende y Comparte: Intercambia consejos y tutoriales para mejorar tus habilidades.

  • Vistas Previas Exclusivas: Obtén acceso anticipado a nuevos anuncios de productos y vistas previas.

  • Descuentos Especiales: Disfruta de descuentos exclusivos en nuestros productos más nuevos.

  • Promociones y Sorteos Festivos: Participa en sorteos y promociones de temporada.

👉 ¿Listo para explorar y crear con nosotros? Haz clic en [here] y únete hoy.

5. Conectando a LLMs en Línea

En esta lección, aprenderemos cómo conectar su Pironman 5 Pro MAX (o Raspberry Pi) a diferentes Modelos de Lenguaje de Gran Tamaño (LLM) en línea. Cada proveedor requiere una clave API y ofrece diferentes modelos entre los que puede elegir.

Cubriremos cómo:

  • Crear y guardar sus claves API de forma segura.

  • Elegir un modelo que se adapte a sus necesidades.

  • Ejecutar nuestro código de ejemplo para chatear con los modelos.

Vamos paso a paso para cada proveedor.

OpenAI

OpenAI proporciona modelos potentes como GPT-4o y GPT-4.1 que pueden usarse tanto para tareas de texto como de visión.

Aquí está cómo configurarlo:

Obtener y Guardar su Clave API

  1. Vaya a OpenAI Platform e inicie sesión. En la página API keys, haga clic en Create new secret key.

    ../../_images/llm_openai_create1.png

  2. Complete los detalles (Owner, Name, Project y permisos si es necesario), luego haga clic en Create secret key.

    ../../_images/llm_openai_create_confirm1.png

  3. Una vez creada la clave, cópiela de inmediato — no podrá volver a verla. Si la pierde, deberá generar una nueva.

    ../../_images/llm_openai_copy1.png

  4. En la carpeta de su proyecto (por ejemplo: /), cree un archivo llamado secret.py:

    cd ~/sunfounder-voice-assistant/examples
sudo nano secret.py

  5. Pegue su clave en el archivo de esta manera:

    # secret.py
# Store secrets here. Never commit this file to Git.
OPENAI_API_KEY = "sk-xxx"

Habilitar facturación y verificar modelos

  1. Antes de usar la clave, vaya a la página Billing en su cuenta de OpenAI, agregue sus datos de pago y cargue una pequeña cantidad de crédito.

    ../../_images/llm_openai_billing.png

  2. Luego vaya a la página Limits para verificar qué modelos están disponibles para su cuenta y copie el ID exacto del modelo para usar en su código.

    ../../_images/llm_openai_models.png

Probar con el código de ejemplo

  1. Abra nuestro código de muestra:

    cd ~/sunfounder-voice-assistant/examples
sudo nano llm_openai.py

  2. Reemplace el contenido con el código a continuación, y actualice model="xxx" al modelo que desee (por ejemplo, gpt-4o):

    from sunfounder_voice_assistant.llm import OpenAI
from secret import OPENAI_API_KEY

INSTRUCTIONS = "You are a helpful assistant."
WELCOME = "Hello, I am a helpful assistant. How can I help you?"

llm = OpenAI(
   api_key=OPENAI_API_KEY,
   model="gpt-4o",
)

    Guarde y salga (Ctrl+X, luego Y, luego Enter).

  3. Finalmente, ejecute la prueba:

    sudo python3 llm_openai.py

Gemini

Gemini es la familia de modelos de IA de Google. Es rápido y excelente para tareas de propósito general.

Obtener y Guardar su Clave API

  1. Inicie sesión en Google AI Studio, luego vaya a la página de API Keys.

    ../../_images/llm_gemini_get.png

  2. Haga clic en el botón Create API key en la esquina superior derecha.

    ../../_images/llm_gemini_create.png

  3. Puede crear una clave para un proyecto existente o uno nuevo.

    ../../_images/llm_gemini_choose.png

  4. Copie la clave API generada.

    ../../_images/llm_gemini_copy.png

  5. En la carpeta de su proyecto:

    cd ~/sunfounder-voice-assistant/examples
sudo nano secret.py

  6. Pegue la clave:

     # secret.py
 # Store secrets here. Never commit this file to Git.
GEMINI_API_KEY = "AIxxx"

Verificar modelos disponibles

Vaya a la página oficial Gemini Models, aquí verá la lista de modelos, sus IDs exactos de API y para qué caso de uso está optimizado cada uno.

../../_images/llm_gemini_model.png

Probar con el código de ejemplo

  1. Abra el archivo de prueba:

    cd ~/sunfounder-voice-assistant/examples
sudo nano llm_gemini.py

  2. Reemplace el contenido con el código a continuación, y actualice model="xxx" al modelo que desee (por ejemplo, gemini-2.5-flash):

    from sunfounder_voice_assistant.llm import Gemini
from secret import GEMINI_API_KEY

INSTRUCTIONS = "You are a helpful assistant."
WELCOME = "Hello, I am a helpful assistant. How can I help you?"

llm = Gemini(
   api_key=GEMINI_API_KEY,
   model="gemini-2.5-flash",
)

  3. Guarde y ejecute:

    sudo python3 llm_gemini.py

Qwen

Qwen es una familia de modelos de lenguaje grande y multimodales proporcionados por Alibaba Cloud. Estos modelos soportan generación de texto, razonamiento y comprensión multimodal (como análisis de imágenes).

Obtener una Clave API

Para llamar a los modelos Qwen, necesita una Clave API. La mayoría de los usuarios internacionales deben usar la consola DashScope International (Model Studio). Los usuarios de China continental pueden usar en su lugar la consola Bailian (百炼).

  • Para Usuarios Internacionales

    1. Vaya a la página oficial Get API Key en Alibaba Cloud.

    2. Inicie sesión o cree una cuenta de Alibaba Cloud.

    3. Navegue a Model Studio (elija la región Singapur o Beijing).

      • Si aparece un mensaje “Activate Now” en la parte superior de la página, haga clic en él para activar Model Studio y recibir la cuota gratuita (solo Singapur).

      • La activación es gratuita — solo se le cobrará después de usar su cuota gratuita.

      • Si no aparece ningún mensaje de activación, el servicio ya está activo.

    4. Vaya a la página Key Management. En la pestaña API Key, haga clic en Create API Key.

    5. Después de la creación, copie su Clave API y guárdela de forma segura.

    Nota

    Los usuarios de Hong Kong, Macao y Taiwán también deben elegir la opción International (Model Studio).

  • Para Usuarios de China Continental

    Si está en China Continental, puede usar la consola Alibaba Cloud Bailian (百炼):

    1. Inicie sesión en Bailian console (consola Bailian) y complete la verificación de la cuenta.

    2. Seleccione Create API Key. Si aparece un mensaje indicando que los servicios de modelo no están activados, haga clic en Activate, acepte los términos y reclame su cuota gratuita. Después de la activación, el botón Create API Key se habilitará.

      ../../_images/llm_qwen_aliyun_create.png

    3. Haga clic en Create API Key nuevamente, verifique su cuenta y luego haga clic en Confirm.

      ../../_images/llm_qwen_aliyun_confirm.png

    4. Una vez creada, copie su Clave API.

      ../../_images/llm_qwen_aliyun_copy.png

Guardar su Clave API

  1. En la carpeta de su proyecto:

    cd ~/sunfounder-voice-assistant/examples
sudo nano secret.py

  2. Pegue su clave de esta manera:

    # secret.py
# Store secrets here. Never commit this file to Git.

QWEN_API_KEY = "sk-xxx"

Probar con el código de ejemplo

  1. Abra el archivo de prueba:

    cd ~/sunfounder-voice-assistant/examples
sudo nano llm_qwen.py

  2. Reemplace el contenido con el código a continuación, y actualice model="xxx" al modelo que desee (por ejemplo, qwen-plus):

    from sunfounder_voice_assistant.llm import Qwen
from secret import QWEN_API_KEY

INSTRUCTIONS = "You are a helpful assistant."
WELCOME = "Hello, I am a helpful assistant. How can I help you?"

llm = Qwen(
   api_key=QWEN_API_KEY,
   model="qwen-plus",
)

  3. Ejecute con:

    sudo python3 llm_qwen.py

Grok (xAI)

Grok es la IA conversacional de xAI, creada por el equipo de Elon Musk. Puede conectarse a través de la API de xAI.

Obtener y Guardar su Clave API

  1. Regístrese para obtener una cuenta aquí: xAI Cloud Console. Agregue algo de crédito a su cuenta primero — de lo contrario la API no funcionará.

  2. Vaya a la página de API Keys, haga clic en Create API key.

    ../../_images/llm_grok_create.png

  3. Ingrese un nombre para la clave, luego haga clic en Create API key.

    ../../_images/llm_grok_name.png

  4. Copie la clave generada y guárdela de forma segura.

    ../../_images/llm_grok_copy.png

  5. En la carpeta de su proyecto:

    cd ~/sunfounder-voice-assistant/examples
sudo nano secret.py

  6. Pegue su clave de esta manera:

    # secret.py
# Store secrets here. Never commit this file to Git.

GROK_API_KEY = "xai-xxx"

Verificar modelos disponibles

Vaya a la página Models en la consola de xAI. Aquí puede ver todos los modelos disponibles para su equipo, junto con sus IDs exactos de API — use estos IDs en su código.

../../_images/llm_grok_model.png

Probar con el código de ejemplo

  1. Abra el archivo de prueba:

    cd ~/sunfounder-voice-assistant/examples
sudo nano llm_grok.py

  2. Reemplace el contenido con el código a continuación, y actualice model="xxx" al modelo que desee (por ejemplo, grok-4-latest):

    from sunfounder_voice_assistant.llm import Grok
from secret import GROK_API_KEY

INSTRUCTIONS = "You are a helpful assistant."
WELCOME = "Hello, I am a helpful assistant. How can I help you?"

llm = Grok(
   api_key=GROK_API_KEY,
   model="grok-4-latest",
)

  3. Ejecute con:

    sudo python3 llm_grok.py

DeepSeek

DeepSeek es un proveedor chino de LLM que ofrece modelos asequibles y capaces.

Obtener y Guardar su Clave API

  1. Inicie sesión en Deepseek Platform.

  2. En el menú superior derecho, seleccione API Keys → Create API Key.

    ../../_images/llm_deepseek_create.png

  3. Ingrese un nombre, haga clic en Create, luego copie la clave.

    ../../_images/llm_deepseek_copy.png

  4. En la carpeta de su proyecto:

    cd ~/sunfounder-voice-assistant/examples
sudo nano secret.py

  5. Agregue su clave:

    # secret.py
DEEPSEEK_API_KEY = "sk-xxx"

Habilitar facturación

Necesitará recargar su cuenta primero. Comience con una pequeña cantidad (por ejemplo, ¥10 RMB).

../../_images/llm_deepseek_chognzhi.png

Modelos disponibles

En el momento de escribir esto (2025-09-12), DeepSeek ofrece:

  • deepseek-chat

  • deepseek-reasoner

Probar con el código de ejemplo

  1. Abra el archivo de prueba:

    cd ~/sunfounder-voice-assistant/examples
sudo nano llm_deepseek.py

  2. Reemplace el contenido con el código a continuación, y actualice model="xxx" al modelo que desee (por ejemplo, deepseek-chat):

    from sunfounder_voice_assistant.llm import Deepseek
from secret import DEEPSEEK_API_KEY

INSTRUCTIONS = "You are a helpful assistant."
WELCOME = "Hello, I am a helpful assistant. How can I help you?"

llm = Deepseek(
   api_key=DEEPSEEK_API_KEY,
   model="deepseek-chat",
   max_messages=20,
)

  3. Ejecute:

    sudo python3 llm_deepseek.py

Doubao

Doubao es la plataforma de modelos de IA de ByteDance (Volcengine Ark).

Obtener y Guardar su Clave API

  1. Inicie sesión en Volcengine.

  2. En el menú izquierdo, desplácese hacia abajo hasta API Key Management → Create API Key.

    ../../_images/llm_doubao_create.png

  3. Elija un nombre y haga clic en Create.

    ../../_images/llm_doubao_name.png

  4. Haga clic en el icono Show API Key y cópielo.

    ../../_images/llm_doubao_copy.png

  5. En la carpeta de su proyecto:

    cd ~/sunfounder-voice-assistant/examples
sudo nano secret.py

  6. Agregue su clave:

    # secret.py
DOUBAO_API_KEY = "xxx"

Elegir un modelo

  1. Vaya al mercado de modelos y elija un modelo.

    ../../_images/llm_doubao_model_select.png

  2. Por ejemplo, elija Doubao-seed-1.6, luego haga clic en API 接入.

    ../../_images/llm_doubao_model.png

  3. Seleccione su Clave API y haga clic en Use API.

    ../../_images/llm_doubao_use_api.png

  4. Haga clic en Enable Model.

    ../../_images/llm_doubao_kaitong.png

  5. Pase el cursor sobre el ID del modelo para copiarlo.

    ../../_images/llm_doubao_copy_id.png

Probar con el código de ejemplo

  1. Abra el archivo de prueba:

    cd ~/sunfounder-voice-assistant/examples
sudo nano llm_doubao.py

  2. Reemplace el contenido con el código a continuación, y actualice model="xxx" al modelo que desee (por ejemplo, doubao-seed-1-6-250615):

    from sunfounder_voice_assistant.llm import Doubao
from secret import DOUBAO_API_KEY

INSTRUCTIONS = "You are a helpful assistant."
WELCOME = "Hello, I am a helpful assistant. How can I help you?"

llm = Doubao(
   api_key=DOUBAO_API_KEY,
   model="doubao-seed-1-6-250615",
)

  3. Ejecute con:

    sudo python3 llm_doubao.py

General

Este proyecto soporta la conexión a múltiples plataformas LLM a través de una interfaz unificada. Tenemos compatibilidad incorporada con:

  • OpenAI (ChatGPT / GPT-4o, GPT-4, GPT-3.5)

  • Gemini (Google AI Studio / Vertex AI)

  • Grok (xAI)

  • DeepSeek

  • Qwen (通义千问)

  • Doubao (豆包)

Además, puede conectarse a cualquier otro servicio LLM que sea compatible con el formato de API de OpenAI. Para esas plataformas, deberá obtener manualmente su Clave API y la base_url correcta.

Obtener y Guardar su Clave API

  1. Obtenga una Clave API de la plataforma que desea usar. (Consulte la consola oficial de cada plataforma para más detalles.)

  2. En la carpeta de su proyecto, cree un nuevo archivo:

    cd ~/sunfounder-voice-assistant/examples/
nano secret.py

  3. Agregue su clave en secret.py:

    # secret.py
API_KEY = "your_api_key_here"

Advertencia

Mantenga su Clave API privada. No suba secret.py a repositorios públicos.

Probar con el Código de Ejemplo

  1. Abra el archivo de prueba:

    cd ~/sunfounder-voice-assistant/examples/
sudo nano llm_others.py

  2. Reemplace el contenido de un archivo Python con el siguiente ejemplo, y complete la base_url y el model correctos para su plataforma:

    Nota

    Sobre base_url: Soportamos el formato de API de OpenAI, así como cualquier API que sea compatible con él. Cada proveedor tiene su propia base_url. Consulte su documentación.

    from sunfounder_voice_assistant.llm import LLM
from secret import API_KEY

INSTRUCTIONS = "You are a helpful assistant."
WELCOME = "Hello, I am a helpful assistant. How can I help you?"

llm = LLM(
   base_url = f"",
   api_key=API_KEY,
   model="",
)

  3. Ejecute el programa:

    sudo python3 llm_others.py