Ottieni una chiave API e la prima completamento
Crea una chiave sk-isms nella console della piattaforma e chiama l'endpoint di completamento chat compatibile con OpenAI.
Prerequisiti
- Un account ISMS Copilot effettuato l'accesso su platform.ismscopilot.com.
- Un saldo prepagato positivo (acquista crediti nella sezione Credits). I completamenti addebitano il saldo; un saldo vuoto causa il fallimento della richiesta.
1. Crea una chiave
- Apri platform.ismscopilot.com/keys.
- Crea una chiave. Assegnale un nome che riconoscerai in seguito.
- Copia la chiave immediatamente. Inizia con
sk-isms-ed è mostrata solo una volta. - Facoltativamente imposta limiti di spesa per chiave (ora / giorno / settimana / mese).
2. Prima richiesta (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": "List 3 ISO 27001 access control requirements."}
]
}'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": "Difference between SOC 2 Type 1 and Type 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: "Quali articoli del GDPR riguardano il DPO?" }],
});
console.log(resp.choices[0].message.content);5. Elenca i modelli
curl https://api.ismscopilot.com/v1/models \
-H "Authorization: Bearer sk-isms-..."Senza una chiave, l'endpoint restituisce 401 con un errore di autenticazione. Questo è previsto.
Errori comuni
| Sintomo | Causa probabile |
|---|---|
401 | Header Authorization: Bearer mancante o errato; chiave revocata o sconosciuta |
429 / errore di tipo quota | Saldo crediti esaurito o limite di spesa per chiave raggiunto |
Tratta sk-isms-… come una password. Revocala nella console se viene compromessa e creane una nuova.