Haz tu primera llamada en 5 minutos
Obtén la Key → envía la solicitud → cambia de modelo: listo en tres pasos.
Requisitos previos
Una cuenta de Lurus (al registrarte obtienes cuota gratuita; el primer paso te guía para crearla) · Python 3.8+ / Node.js 18+ / Go 1.21+ / cURL (a elegir) · conocimientos básicos de terminal. Tiempo estimado: 5 minutos.
Crea una cuenta —— empieza gratis
Al registrarte obtienes cuota gratuita; puedes completar este tutorial sin recargar saldo.
Listo para usar al registrarte, sin pagar
Las cuentas nuevas reciben automáticamente 5 鹿贝 + cuota gratuita (plan Free: 100 llamadas/día, incluye deepseek-chat y gpt-3.5-turbo), más que suficiente para este tutorial. Para detalles de cuota y mejoras de plan, consulta las preguntas frecuentes y la guía de facturación.
A continuación, crea una API Key:
Accede a hub.lurus.cn e inicia sesión o regístrate
Ve a «Gestión de tokens» → «Crear nuevo token»
Copia la Key generada (formato:
sk-xxxxxxxxxxxxxxxx)
Aviso de seguridad
La API Key equivale a una contraseña. No la subas a Git ni la escribas en el código del frontend. Lo recomendado es pasarla mediante una variable de entorno:
export LURUS_API_KEY="sk-your-key-here"Envía tu primera solicitud
Elige tu lenguaje, copia y ejecuta.
¿Ves la respuesta del modelo? Tu primera llamada ya funciona 🎉
Esta solicitud usó la cuota gratuita de regalo por el registro, sin gastar ni un céntimo. El siguiente paso es probar otro modelo —— casi no hay que tocar el código.
Cambia de modelo
Solo cambia el parámetro model, sin modificar ninguna otra parte del código. Elige un modelo y el fragmento de abajo se actualiza al instante: cópialo y ejecútalo.
from openai import OpenAI
import os
client = OpenAI(base_url="https://hub.lurus.cn/v1", api_key=os.environ["LURUS_API_KEY"])
response = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)¿No sabes cuál elegir?
Uso diario → deepseek-chat (el más económico, el mejor en chino)
Razonamiento complejo → deepseek-reasoner
Procesamiento de documentos largos → gemini-3-pro-preview
Para la comparación completa, consulta los modelos compatibles.
¿No funciona? Empieza por aquí
Devuelve 401 Unauthorized
{"error": {"code": "invalid_api_key", "type": "authentication_error"}}Comprueba:
- Si la Key empieza por
sk- - El formato del encabezado de la solicitud:
Authorization: Bearer sk-xxxx(ojo: hay un espacio después de Bearer) - Si la Key está en estado «activado» (verifícalo en la consola)
Devuelve "no available server"
- Comprueba la ortografía del nombre de
model(distingue mayúsculas y minúsculas) - Confirma que esa Key tiene permiso para acceder a este modelo
- Si acabas de crear la Key, espera unos 10 segundos y vuelve a intentarlo
¿Cómo se activa la respuesta en streaming?
Añade "stream": true al cuerpo de la solicitud; para más detalles consulta la respuesta en streamingStreamingRespuesta en streaming: el modelo de IA devuelve el resultado token a token (en lugar de esperar a generarlo por completo), reduciendo la latencia del primer carácter..