ISMS Copilot Docs

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

  1. Apri platform.ismscopilot.com/keys.
  2. Crea una chiave. Assegnale un nome che riconoscerai in seguito.
  3. Copia la chiave immediatamente. Inizia con sk-isms- ed è mostrata solo una volta.
  4. 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

SintomoCausa probabile
401Header Authorization: Bearer mancante o errato; chiave revocata o sconosciuta
429 / errore di tipo quotaSaldo 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.

In questa pagina