Inicio Rápido
Comienza con Nextbit AI Platform en minutos. Esta guía te llevará a través de la instalación, autenticación y tu primera solicitud a la API.
Instalación
Primero, instala el SDK de OpenAI para tu lenguaje preferido. Nuestra API es totalmente compatible con las bibliotecas cliente de OpenAI.
Python
Instalar SDK de OpenAI
pip install openai
TypeScript/JavaScript
Instalar SDK de OpenAI
npm install openai
# o
yarn add openai
# o
pnpm add openai
Autenticación
Para autenticarte con la API de Nextbit, necesitarás una clave de API. Genera una desde tu panel de Claves API.
Mantén tus claves de API seguras. Nunca las expongas en código del lado del cliente ni las subas a control de versiones.
Configurar tu Clave de API
Configurar Clave API
export NEXTBIT_API_KEY="tu-clave-api-aqui"
Primera Solicitud
Ahora hagamos tu primera solicitud a la API. Crearemos una Chat Completion simple.
El siguiente ejemplo muestra cómo crear una Chat Completion básica usando el SDK de OpenAI configurado para usar el endpoint de API de Nextbit.
Configuración Clave
- base_url: Establecer a
https://api.nextbit256.com/v1 - api_key: Tu clave de API de Nextbit
- model: Elige entre modelos disponibles (ej.,
llama3.3:70b)
Chat Completion
from openai import OpenAI
import os
# Inicializar cliente con endpoint de Nextbit
client = OpenAI(
base_url="https://api.nextbit256.com/v1",
api_key=os.environ.get("NEXTBIT_API_KEY")
)
# Crear Chat Completion
response = client.chat.completions.create(
model="llama3.3:70b",
messages=[
{"role": "system", "content": "Eres un asistente útil."},
{"role": "user", "content": "Explica la computación cuántica en términos simples."}
]
)
print(response.choices[0].message.content)
Streaming
Para una mejor experiencia de usuario, puedes transmitir las respuestas token por token a medida que se generan.
Establece stream=true para habilitar streaming. La respuesta se enviará como eventos del servidor (SSE), con cada fragmento conteniendo una porción de la Completion.
Solicitud con Streaming
stream = client.chat.completions.create(
model="llama3.3:70b",
messages=[
{"role": "user", "content": "Escribe un haiku sobre la IA"}
],
stream=True
)
for chunk in stream:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Manejo de Errores
Siempre maneja los errores potenciales en tus solicitudes a la API:
Manejo de Errores
from openai import OpenAI, APIError, RateLimitError
import os
client = OpenAI(
base_url="https://api.nextbit256.com/v1",
api_key=os.environ.get("NEXTBIT_API_KEY")
)
try:
response = client.chat.completions.create(
model="llama3.3:70b",
messages=[{"role": "user", "content": "¡Hola!"}]
)
print(response.choices[0].message.content)
except RateLimitError:
print("Límite de tasa excedido. Por favor intenta más tarde.")
except APIError as e:
print(f"Error de API: {e}")
except Exception as e:
print(f"Error inesperado: {e}")
Próximos Pasos
Ahora que has hecho tu primera solicitud, explora más funcionalidades:
- Chat Completions - Referencia detallada de la API para Chat Completions
- Modelos - Explora los modelos disponibles y sus capacidades
- Panel de Control - Monitorea tu uso y gestiona la facturación
- Claves API - Crea y gestiona claves de API