Obtener una clave API y primera finalización
Crea una clave sk-isms en la consola de la plataforma e invoca el endpoint de finalizaciones de chat compatible con OpenAI.
Requisitos previos
- Una cuenta de ISMS Copilot registrada en platform.ismscopilot.com.
- Un saldo de crédito prepago positivo (compra créditos en Créditos). Las finalizaciones debitan el saldo; un saldo vacío falla la solicitud.
1. Crear una clave
- Abre platform.ismscopilot.com/keys.
- Crea una clave. Asígnale un nombre que puedas reconocer más tarde.
- Copia la clave inmediatamente. Comienza con
sk-isms-y solo se muestra una vez. - Opcionalmente, establece límites de gasto por clave (hora / día / semana / mes).
2. Primera solicitud (curl)
curl https://api.ismscopilot.com/v1/chat/completions \
-H "Authorization: Bearer sk-isms-..." \
-H "Content-Type: application/json" \
-d '{
"model": "isms-fast",
"messages": [
{"role": "user", "content": "Lista 3 requisitos de control de acceso de ISO 27001."}
]
}'3. OpenAI SDK (Python)
from openai import OpenAI
client = OpenAI(
base_url="https://api.ismscopilot.com/v1",
api_key="sk-isms-...",
)
resp = client.chat.completions.create(
model="isms-thinking",
messages=[{"role": "user", "content": "¿Cuál es la diferencia entre SOC 2 Tipo 1 y Tipo 2?"}],
)
print(resp.choices[0].message.content)4. OpenAI SDK (Node)
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.ismscopilot.com/v1",
apiKey: "sk-isms-...",
});
const resp = await client.chat.completions.create({
model: "isms-fast",
messages: [{ role: "user", content: "¿Qué artículos del GDPR cubren al DPO?" }],
});
console.log(resp.choices[0].message.content);5. Listar modelos
curl https://api.ismscopilot.com/v1/models \
-H "Authorization: Bearer sk-isms-..."Sin una clave, el endpoint devuelve 401 con un error de autenticación. Esto es esperado.
Fallos comunes
| Síntoma | Causa probable |
|---|---|
401 | Falta o es incorrecto el encabezado Authorization: Bearer; clave revocada o desconocida |
429 / error de estilo cuota | Saldo de crédito vacío o se alcanzó un límite de gasto por clave |
Trata sk-isms-… como una contraseña. Revócala en la consola si se filtra y crea una nueva.